Docker

-----

[List of PRs / issues for this release](https://github.com/docker/docker-py/milestone/31?closed=1)

Features

* Added support for the following `HostConfig` parameters: `volume_driver`,
`cpu_count`, `cpu_percent`, `nano_cpus`, `cpuset_mems`.
* Added support for `verbose` parameter in `APIClient.inspect_network` and
`DockerClient.networks.get`.
* Added support for the `environment` parameter in `APIClient.exec_create`
and `Container.exec_run`
* Added `reload_config` method to `APIClient`, that lets the user reload
the `config.json` data from disk.
* Added `labels` property to the `Image` and `Container` classes.
* Added `image` property to the `Container` class.

Bugfixes

* Fixed a bug where setting `replicas` to zero in `ServiceMode` would not
register as a valid entry.
* Fixed a bug where `DockerClient.images.build` would report a failure after
a successful build if a `tag` was set.
* Fixed an issue where `DockerClient.images.pull` would fail to return the
corresponding image object if a `tag` was set.
* Fixed a bug where a list of `mounts` provided to `APIClient.create_service`
would sometimes be parsed incorrectly.
* Fixed a bug where calling `Network.containers` would crash when no containers
were associated with the network.
* Fixed an issue where `Network.connect` and `Network.disconnect` would not
accept some of the documented parameters.
* Fixed a bug where the `cpuset_cpus` parameter would not be properly set in
`APIClient.create_host_config`.

Miscellaneous

* The invalid `networks` argument in `DockerClient.containers.run` has been
replaced with a (working) singular `network` argument.

------

[List of PRs / issues for this release](https://github.com/docker/docker-py/milestone/32?closed=1)

Bugfixes

* Fixed a bug where the `status_code` attribute of `APIError` exceptions would
not reflect the expected value.
* Fixed an issue where the `events` method would time out unexpectedly if no
data was sent by the engine for a given amount of time.

-----

[List of PRs / issues for this release](https://github.com/docker/docker-py/milestone/30?closed=1)

Features

* Default API version has been bumped to `1.26` (Engine 1.13.1+)
* Upgrade plugin:
* Added the `upgrade_plugin` method to the `APIClient` class
* Added the `upgrade` method to the `Plugin` class
* Service logs:
* Added the `service_logs` method to the `APIClient` class
* Added the `logs` method to the `Service` class
* Added the `df` method to `APIClient` and `DockerClient`
* Added support for `init` and `init_path` parameters in `HostConfig`
and `DockerClient.containers.run`
* Added support for `hostname` parameter in `ContainerSpec` and
`DockerClient.service.create`
* Added support for port range to single port in port mappings
(e.g. `8000-8010:80`)

Bugfixes

* Fixed a bug where a missing container port in a port mapping would raise
an unexpected `TypeError`
* Fixed a bug where the `events` method in `APIClient` and `DockerClient`
would not respect custom headers set in `config.json`

[List of PRs / issues for this release](https://github.com/docker/docker-py/milestone/27?closed=1)

Features
- Added the following pruning methods:
- In `APIClient`: `prune_containers`, `prune_images`, `prune_networks`,
`prune_volumes`
- In `DockerClient`: `containers.prune`, `images.prune`, `networks.prune`,
`volumes.prune`
- Added support for the plugins API:
- In `APIClient`: `configure_plugin`, `create_plugin`, `disable_plugin`,
`enable_plugin`, `inspect_plugin`, `pull_plugin`, `plugins`,
`plugin_privileges`, `push_plugin`, `remove_plugin`
- In `DockerClient`: `plugins.create`, `plugins.get`, `plugins.install`,
`plugins.list`, and the `Plugin` model.
- Added support for the secrets API:
- In `APIClient`: `create_secret`, `inspect_secret`, `remove_secret`,
`secrets`
- In `DockerClient`: `secret.create`, `secret.get`, `secret.list` and
the `Secret` model.
- Added `secrets` parameter to `ContainerSpec`. Each item in the `secrets`
list must be a `docker.types.SecretReference` instance.
- Added support for `cache_from` in `APIClient.build` and
`DockerClient.images.build`.
- Added support for `auto_remove` and `storage_opt` in
`APIClient.create_host_config` and `DockerClient.containers.run`
- Added support for `stop_timeout` in `APIClient.create_container` and
`DockerClient.containers.run`
- Added support for the `force` parameter in `APIClient.remove_volume` and
`Volume.remove`
- Added support for `max_failure_ratio` and `monitor` in `UpdateConfig`
- Added support for `force_update` in `TaskTemplate`
- Made `name` parameter optional in `APIClient.create_volume` and
`DockerClient.volumes.create`

Bugfixes
- Fixed a bug where building from a directory containing socket-type files
would raise an unexpected `AttributeError`.
- Fixed an issue that was preventing the `DockerClient.swarm.init` method to
take into account arguments passed to it.
- `Image.tag` now correctly returns a boolean value upon completion.
- Fixed several issues related to passing `volumes` in
`DockerClient.containers.run`
- Fixed an issue where `DockerClient.image.build` wouldn't return an `Image`
object even when the build was successful

[List of PRs / issues for this release](https://github.com/docker/docker-py/milestone/29?closed=1)

Bugfixes
- Installation of the package now fails if the `docker-py` package is
installed in order to prevent obscure naming conflicts when both
packages co-exist.
- Added missing `filters` parameter to `APIClient.networks`.
- Resource objects generated by the `DockerClient` are now hashable.
- Fixed a bug where retrieving untagged images using `DockerClient`
would raise a `TypeError` exception.
- `mode` parameter in `create_service` is now properly converted to
a valid data type for the Engine API. Use `ServiceMode` for advanced
configurations.
- Fixed a bug where the decoded `APIClient.events` stream would sometimes raise
an exception when a container is stopped or restarted.

[List of PRs / issues for this release](https://github.com/docker/docker-py/milestone/28?closed=1)

Bugfixes
- Fixed a bug where forward slashes in some .dockerignore patterns weren't
being parsed correctly on Windows
- Fixed a bug where `Mount.parse_mount_string` would never set the read_only
parameter on the resulting `Mount`.
- Fixed a bug where `Mount.parse_mount_string` would incorrectly mark host
binds as being of `volume` type.