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.12.0.tar.gz (34.0 kB view details)

Uploaded Source

Built Distribution

aiodocker-0.12.0-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aiodocker-0.12.0.tar.gz
  • Upload date:
  • Size: 34.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for aiodocker-0.12.0.tar.gz
Algorithm Hash digest
SHA256 be0c41674918fe4d5c6914b8a1889e594bb04586016f7295a23b8045c343b436
MD5 909a6e272bbe7968a84394f382949f78
BLAKE2b-256 bb8a20cd02b84278ebab437c34d6effb85aa3739659580225cfb1fde39c66a30

See more details on using hashes here.

Provenance

File details

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

File metadata

File hashes

Hashes for aiodocker-0.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bf6d2dc05bb362cbecc29ad1d6d13b2e02c5fd5d6bc99e3d30c1c54570334a96
MD5 d4dec61fc3641f7194828ce1e8b8469e
BLAKE2b-256 f389ce6a722bbb2d655b3dda1bd008ccb1812827c0e6331c68de63d4e548e2f5

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