{"id":13549691,"url":"https://github.com/aio-libs/aiodocker","last_synced_at":"2025-05-14T00:10:00.258Z","repository":{"id":15732504,"uuid":"18470884","full_name":"aio-libs/aiodocker","owner":"aio-libs","description":"Python Docker API client based on asyncio and aiohttp","archived":false,"fork":false,"pushed_at":"2025-05-01T12:23:10.000Z","size":1229,"stargazers_count":461,"open_issues_count":52,"forks_count":103,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-05-10T00:02:59.154Z","etag":null,"topics":["aiohttp","api-client","asyncio","docker","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aio-libs.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-04-05T16:27:43.000Z","updated_at":"2025-05-08T18:02:28.000Z","dependencies_parsed_at":"2024-06-01T13:50:15.970Z","dependency_job_id":"8f7e700a-254e-4fe6-9e82-6626ca43ce52","html_url":"https://github.com/aio-libs/aiodocker","commit_stats":{"total_commits":691,"total_committers":41,"mean_commits":"16.853658536585368","dds":0.7568740955137482,"last_synced_commit":"f1dbdc3d42147f4c2ab5e6802acf6f7d0f885be4"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Faiodocker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Faiodocker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Faiodocker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Faiodocker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aio-libs","download_url":"https://codeload.github.com/aio-libs/aiodocker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254044250,"owners_count":22005112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiohttp","api-client","asyncio","docker","python"],"created_at":"2024-08-01T12:01:24.483Z","updated_at":"2025-05-14T00:09:55.250Z","avatar_url":"https://github.com/aio-libs.png","language":"Python","readme":"==============================\nAsyncIO bindings for docker.io\n==============================\n\n.. image:: https://badge.fury.io/py/aiodocker.svg\n   :target: https://badge.fury.io/py/aiodocker\n   :alt: PyPI version\n\n.. image:: https://img.shields.io/pypi/pyversions/aiodocker.svg\n   :target: https://pypi.org/project/aiodocker/\n   :alt: Python Versions\n\n.. image:: https://github.com/aio-libs/aiodocker/actions/workflows/ci-cd.yml/badge.svg?branch=master\n   :target: https://github.com/aio-libs/aiodocker/actions/workflows/ci-cd.yml?query=branch%3Amaster\n   :alt: GitHub Actions status for the main branch\n\n.. image:: https://codecov.io/gh/aio-libs/aiodocker/branch/master/graph/badge.svg\n   :target: https://codecov.io/gh/aio-libs/aiodocker\n   :alt: Code Coverage\n\n.. image:: https://badges.gitter.im/Join%20Chat.svg\n    :target: https://gitter.im/aio-libs/Lobby\n    :alt: Chat on Gitter\n\n\nA simple Docker HTTP API wrapper written with asyncio and aiohttp.\n\n\nInstallation\n============\n\n.. code-block:: sh\n\n   pip install aiodocker\n\n\nDevelopment\n===========\n\nCreate a virtualenv (either using ``python -m venv``, ``pyenv`` or your\nfavorite tools) and install in the editable mode with ``ci`` and ``dev`` optional\ndependency sets.\n\n.. code-block:: sh\n\n   pip install -U pip\n   pip install -e '.[ci,dev]'  # in zsh, you need to escape brackets\n   pre-commit install\n\nRunning tests\n~~~~~~~~~~~~~\n\n.. code-block:: sh\n\n   # Run all tests\n   make test\n\n   # Run individual tests\n   python -m pytest tests/test_images.py\n\n\nBuilding packages\n~~~~~~~~~~~~~~~~~\n\nNOTE: Usually you don't need to run this step by yourself.\n\n.. code-block:: sh\n\n   pip install -U build\n   python -m build --sdist --wheel\n\n\nDocumentation\n=============\n\nhttp://aiodocker.readthedocs.io\n\n\nExamples\n========\n\n.. code-block:: python\n\n    import asyncio\n    import aiodocker\n\n    async def list_things(docker):\n        print('== Images ==')\n        for image in (await docker.images.list()):\n            tags = image['RepoTags'][0] if image['RepoTags'] else ''\n            print(image['Id'], tags)\n        print('== Containers ==')\n        for container in (await docker.containers.list()):\n            print(f\" {container._id}\")\n\n    async def run_container(docker):\n        print('== Running a hello-world container ==')\n        container = await docker.containers.create_or_replace(\n            config={\n                'Cmd': ['/bin/ash', '-c', 'echo \"hello world\"'],\n                'Image': 'alpine:latest',\n            },\n            name='testing',\n        )\n        await container.start()\n        logs = await container.log(stdout=True)\n        print(''.join(logs))\n        await container.delete(force=True)\n\n    async def main():\n        docker = aiodocker.Docker()\n        await list_things(docker)\n        await run_container(docker)\n        await docker.close()\n\n    if __name__ == \"__main__\":\n        asyncio.run(main())\n","funding_links":[],"categories":["HarmonyOS","Python"],"sub_categories":["Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faio-libs%2Faiodocker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faio-libs%2Faiodocker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faio-libs%2Faiodocker/lists"}