Skip to main content

Docker API client for asyncio

Project description

AsyncIO bindings for docker.io

PyPI version Python Versions Build Status Code Coverage Chat on Gitter

A simple Docker HTTP API wrapper written with asyncio and aiohttp.

Installation

pip install aiodocker

Documentation

http://aiodocker.readthedocs.io

Examples

import asyncio
import aiodocker

async def list_things():
    docker = aiodocker.Docker()
    print('== Images ==')
    for image in (await docker.images.list()):
        tags = image['RepoTags'][0] if image['RepoTags'] else ''
        print(image['Id'], tags)
    print('== Containers ==')
    for container in (await docker.containers.list()):
        print(f" {container._id}")
    await docker.close()

async def run_container():
    docker = aiodocker.Docker()
    print('== Running a hello-world container ==')
    container = await docker.containers.create_or_replace(
        config={
            'Cmd': ['/bin/ash', '-c', 'echo "hello world"'],
            'Image': 'alpine:latest',
        },
        name='testing',
    )
    await container.start()
    logs = await container.log(stdout=True)
    print(''.join(logs))
    await container.delete(force=True)
    await docker.close()

if __name__ == '__main__':
    loop = asyncio.get_event_loop()
    loop.run_until_complete(list_things())
    loop.run_until_complete(run_container())
    loop.close()

Changes

0.8.1 (2017-08-30)

Misc

  • #44, #46

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiodocker-0.14.0.tar.gz (108.2 kB view details)

Uploaded Source

Built Distribution

aiodocker-0.14.0-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

Details for the file aiodocker-0.14.0.tar.gz.

File metadata

  • Download URL: aiodocker-0.14.0.tar.gz
  • Upload date:
  • Size: 108.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3

File hashes

Hashes for aiodocker-0.14.0.tar.gz
Algorithm Hash digest
SHA256 3ad3983747d019c1b8625c688ec78665f7232095e551338fe8ebd7ee21ba8bca
MD5 ee49f83591d8060e67d9cbad4b79a687
BLAKE2b-256 d9c5bee979c37789e79f4a86302f8a06c11fb0cbcfe95d3b4c3bd30f575287b5

See more details on using hashes here.

Provenance

File details

Details for the file aiodocker-0.14.0-py3-none-any.whl.

File metadata

  • Download URL: aiodocker-0.14.0-py3-none-any.whl
  • Upload date:
  • Size: 23.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3

File hashes

Hashes for aiodocker-0.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 019b47bced32914b8ed1df16dafc3daef7269baf6c6debd7670a10e1afa879d5
MD5 03f521e17442d3c2bc981a358b0d39f8
BLAKE2b-256 e2e4b8d916221190070b60bf6d60649777ac4c5ec284689404607e41c38bd9b7

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page