Metadata-Version: 2.1
Name: aiodocker
Version: 0.18.7
Summary: Docker API client for asyncio
Home-page: https://github.com/aio-libs/aiodocker
Author: Paul Tagliamonte
Author-email: paultag@debian.org
License: Apache 2
Description: ==============================
        AsyncIO bindings for docker.io
        ==============================
        
        .. image:: https://badge.fury.io/py/aiodocker.svg
           :target: https://badge.fury.io/py/aiodocker
           :alt: PyPI version
        
        .. image:: https://img.shields.io/pypi/pyversions/aiodocker.svg
           :target: https://pypi.org/project/aiodocker/
           :alt: Python Versions
        
        .. image:: https://travis-ci.com/aio-libs/aiodocker.svg?branch=master
           :target: https://travis-ci.com/aio-libs/aiodocker
           :alt: Build Status
        
        .. image:: https://codecov.io/gh/aio-libs/aiodocker/branch/master/graph/badge.svg
           :target: https://codecov.io/gh/aio-libs/aiodocker
           :alt: Code Coverage
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
            :target: https://gitter.im/aio-libs/Lobby
            :alt: Chat on Gitter
        
        A simple Docker HTTP API wrapper written with asyncio and aiohttp.
        
        
        Installation
        ============
        
        .. code-block:: sh
        
           pip install aiodocker
        
        Documentation
        =============
        
        http://aiodocker.readthedocs.io
        
        
        Examples
        ========
        
        .. code-block:: python
        
           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
        =======
        
        ..
            You should *NOT* be adding new change log entries to this file, this
            file is managed by towncrier. You *may* edit previous change logs to
            fix problems like typo corrections or such.
            To add a new change log entry, please see
            https://pip.pypa.io/en/latest/development/#adding-a-news-entry
            we named the news folder "changes".
        
        .. towncrier release notes start
        
        0.18.7 (2020-05-04)
        ===================
        
        Bugfixes
        --------
        
        - Fix some typing errors
        
        
        0.18.1 (2020-04-01)
        ===================
        
        Bugfixes
        --------
        
        - Improve the errror message when connection is closed by Docker Engine on TCP hijacking. (#424)
        
        
        0.18.0 (2020-03-25)
        ===================
        
        Features
        --------
        
        - Improve the error text message if cannot connect to docker engine. (#411)
        - Rename `websocket()` to `attach()` (#412)
        - Implement docker exec protocol. (#415)
        - Implement container commit, pause and unpause functionality. (#418)
        - Implement auto-versioning of the docker API by default. (#419)
        
        
        Bugfixes
        --------
        
        - Fix volume.delete throwing a TypeError. (#389)
        
        
        0.17.0 (2019-10-15)
        ===================
        
        Bugfixes
        --------
        
        - Fixed an issue when the entire tar archive was stored in RAM while building the image. (#352)
        
        
        0.16.0 (2019-09-23)
        ===================
        
        Bugfixes
        --------
        
        - Fix streaming mode for pull, push, build, stats and events. (#344)
        
        
        0.15.0 (2019-09-22)
        ===================
        
        Features
        --------
        
        - Add support for Docker 17.12.1 and 18.03.1 (#164)
        - Add initial support for nodes. (#181)
        - Add initial support for networks. (#189)
        - Add support for docker info ando docker swarm join. (#193)
        - Add restart method for containers. (#200)
        - Feature: Add support for registry-auth when you create a service. (#215)
        - Feature: Add support for docker save and load api methods (#219)
        - Pass params to docker events. (#223)
        - Add ability to get a Docker network by name or ID. (#279)
        - Always close response after processing, make `.logs(..., follow=True)` async iterator. (#341)
        
        
        Bugfixes
        --------
        
        - Fix: Set timeout for docker events to 0 (no timeout) (#115)
        - Fix: prevents multiple listener tasks to be created automatically (#116)
        - Fix: if container.start() fails user won't get the id of the container (#128)
        - Improve logging when docker socket not available. (#155)
        - Fix current project version. (#156)
        - Fix `update out of sequence.` (#169)
        - Remove asserts used to check auth with docker registry. (#172)
        - Fix: fix to parse response of docker load method as a json stream (#222)
        - Fix: Handle responses with 0 or missing Content-Length (#237)
        - Fix: don't remove non-newline whitespace from multiplexed lines (#246)
        - Fix docker_context.tar error (#253)
        
        
        Deprecations and Removals
        -------------------------
        
        - docker.images.get has been renamed to docker.images.inspect, remove support for Docker 17.06 (#164)
        - Drop Python 3.5 (#338)
        - Drop deprecated container.copy() (#339)
        
        
        Misc
        ----
        
        - #28, #167, #192, #286
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Framework :: AsyncIO
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development
Classifier: Framework :: AsyncIO
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
