Marketplace

from litmussdk import marketplace

overview = marketplace.marketplace_overview()  # dict

images = marketplace.list_all_images()   # list[dict]
# Each entry: {Id, RepoTags, Size, Created, ...}

ftp_images = marketplace.list_ftp_images()  # list[dict], images staged on FTP

details = marketplace.image_details(image_id)  # dict

# Find a registry (e.g. public Docker Hub)
registries = marketplace.list_registries()
registry = next(r for r in registries if "docker" in r["name"].lower())
registry_id = registry["id"]

# Trigger the pull, returns the pull job ID
job = marketplace.pull_image(
    image_name="ubuntu",
    image_tag="latest",
    registry_id=registry_id,
)

# Check pull job status
pulls = marketplace.list_image_pulls()

import pathlib

job_id = marketplace.upload_image(
    file_name="my-app.tar",
    image_name="my-app",
    path_to_file=pathlib.Path("/path/to/my-app.tar"),
)

# File must already be in ftp-data/docker-images on the device
job = marketplace.upload_from_ftp("my-app.tar")

# Check upload job status
jobs = marketplace.list_upload_jobs()

marketplace.remove_images(
    image_ids=[image_id_1, image_id_2],
    force_remove=True,
    prune_children=True,
)

containers = marketplace.list_all_containers(include_exited=True)  # list[dict]
# Each entry: {Id, Names, Image, Status, State, ...}

result = marketplace.run_container(
    "docker run -d --name my-app -p 8080:80 my-app:latest"
)
container_id = result["Id"]

marketplace.start_containers([container_id])
marketplace.stop_containers([container_id])
marketplace.pause_containers([container_id])
marketplace.unpause_containers([container_id])

# Single
marketplace.delete_container_by_id(container_id)

# Multiple
marketplace.remove_containers_list_by_ids([container_id_1, container_id_2])

# Prune all stopped containers
marketplace.prune_containers()

info = marketplace.container_inspect(container_id)   # dict, full Docker inspect output
logs = marketplace.container_log(container_id)       # str, container stdout/stderr
top  = marketplace.container_top(container_id)       # dict, running processes

metrics = marketplace.prometheus_metrics()  # str, raw Prometheus exposition format