Docker

-----

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

Features

* Added support for the `squash` parameter in `APIClient.build` and
`DockerClient.images.build`.
* When using API version 1.23 or above, `load_image` will now return a
generator of progress as JSON `dict`s.
* `remove_image` now returns the content of the API's response.


Bugfixes

* Fixed an issue where the `auto_remove` parameter in
`DockerClient.containers.run` was not taken into account.
* Fixed a bug where `.dockerignore` patterns starting with a slash
were ignored.
* Fixed an issue with the handling of `**` patterns in `.dockerignore`
* Fixed a bug where building `FROM` a private Docker Hub image when not
using a cred store would fail.
* Fixed a bug where calling `create_service` or `update_service` with
`task_template` as a `dict` would raise an exception.
* Fixed the handling of TTY-enabled containers in `attach` and `exec_run`.
* `DockerClient.containers.run` will no longer attempt to stream logs if the
log driver doesn't support the operation.

Miscellaneous

* Added extra requirements for better TLS support on some platforms.
These can be installed or required through the `docker[tls]` notation.

-----

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

Bugfixes

* Fixed a bug where the `split_port` utility would raise an exception when
passed a non-string argument.

-----

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

Features

* Added support for the `target` and `network_mode` parameters in
`APIClient.build` and `DockerClient.images.build`.
* Added support for the `runtime` parameter in `APIClient.create_container`
and `DockerClient.containers.run`.
* Added support for the `ingress` parameter in `APIClient.create_network` and
`DockerClient.networks.create`.
* Added support for `placement` configuration in `docker.types.TaskTemplate`.
* Added support for `tty` configuration in `docker.types.ContainerSpec`.
* Added support for `start_period` configuration in `docker.types.Healthcheck`.
* The `credHelpers` section in Docker's configuration file is now recognized.
* Port specifications including IPv6 endpoints are now supported.

Bugfixes

* Fixed a bug where instantiating a `DockerClient` using `docker.from_env`
wouldn't correctly set the default timeout value.
* Fixed a bug where `DockerClient.secrets` was not accessible as a property.
* Fixed a bug where `DockerClient.build` would sometimes return the wrong
image.
* Fixed a bug where values for `HostConfig.nano_cpus` exceeding 2^32 would
raise a type error.
* `Image.tag` now properly returns `True` when the operation is successful.
* `APIClient.logs` and `Container.logs` now raise an exception if the `since`
argument uses an unsupported type instead of ignoring the value.
* Fixed a bug where some methods would raise a `NullResource` exception when
the resource ID was provided using a keyword argument.

Miscellaneous

* `APIClient` instances can now be pickled.

-----

[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`