Docker Engine API updated to 1.41

Author: flavioheleno

.jane-openapi

@@ -4,7 +4,7 @@ return [
   'date-prefer-interface' => true,
   'directory'             => __DIR__ . '/src',
   'namespace'             => 'Docker\\API',
-  'openapi-file'          => __DIR__ . '/spec/v1.36.json',
+  'openapi-file'          => __DIR__ . '/spec/v1.41.json',
   'reference'             => true,
   'strict'                => false,
 ];

composer.json

@@ -33,6 +33,7 @@
     },
     "extra": {
         "branch-alias": {
+            "6.1.41": "6.1.41.x-dev",
             "6.1.36": "6.1.36.x-dev"
         }
     },

spec/v1.41.json

@@ -6,6 +6,32 @@
 
 class BuildPrune extends \Docker\API\Runtime\Client\BaseEndpoint implements \Docker\API\Runtime\Client\Endpoint
 {
+    /**
+     * @param array $queryParameters {
+     *
+     *     @var int $keep-storage Amount of disk space in bytes to keep for cache
+     *     @var bool $all Remove all types of build cache
+     *     @var string $filters A JSON encoded value of the filters (a `map[string][]string`) to
+     * process on the list of build cache objects.
+     *
+     * Available filters:
+     *
+     * - `until=<duration>`: duration relative to daemon's time, during which build cache was not used, in Go's duration format (e.g., '24h')
+     * - `id=<id>`
+     * - `parent=<id>`
+     * - `type=<string>`
+     * - `description=<string>`
+     * - `inuse`
+     * - `shared`
+     * - `private`
+     *
+     * }
+     */
+    public function __construct(array $queryParameters = [])
+    {
+        $this->queryParameters = $queryParameters;
+    }
+
     use \Docker\API\Runtime\Client\EndpointTrait;
 
     public function getMethod(): string
@@ -28,6 +54,19 @@ public function getExtraHeaders(): array
         return ['Accept' => ['application/json']];
     }
 
+    protected function getQueryOptionsResolver(): \Symfony\Component\OptionsResolver\OptionsResolver
+    {
+        $optionsResolver = parent::getQueryOptionsResolver();
+        $optionsResolver->setDefined(['keep-storage', 'all', 'filters']);
+        $optionsResolver->setRequired([]);
+        $optionsResolver->setDefaults([]);
+        $optionsResolver->setAllowedTypes('keep-storage', ['int']);
+        $optionsResolver->setAllowedTypes('all', ['bool']);
+        $optionsResolver->setAllowedTypes('filters', ['string']);
+
+        return $optionsResolver;
+    }
+
     /**
      * {@inheritdoc}
      *

src/Client.php

@@ -9,7 +9,10 @@ class ConfigList extends \Docker\API\Runtime\Client\BaseEndpoint implements \Doc
     /**
      * @param array $queryParameters {
      *
-     *     @var string $filters A JSON encoded value of the filters (a `map[string][]string`) to process on the configs list. Available filters:
+     *     @var string $filters A JSON encoded value of the filters (a `map[string][]string`) to
+     * process on the configs list.
+     *
+     * Available filters:
      *
      * - `id=<config id>`
      * - `label=<key> or label=<key>=value`

src/Endpoint/BuildPrune.php

@@ -12,7 +12,9 @@ class ConfigUpdate extends \Docker\API\Runtime\Client\BaseEndpoint implements \D
      * @param string $id              The ID or name of the config
      * @param array  $queryParameters {
      *
-     *     @var int $version The version number of the config object being updated. This is required to avoid conflicting writes.
+     *     @var int $version The version number of the config object being updated. This is
+     * required to avoid conflicting writes.
+     *
      * }
      */
     public function __construct(string $id, \Docker\API\Model\ConfigSpec $requestBody, array $queryParameters = [])

src/Endpoint/ConfigList.php

@@ -9,7 +9,9 @@ class ContainerArchiveInfo extends \Docker\API\Runtime\Client\BaseEndpoint imple
     protected $id;
 
     /**
-     * A response header `X-Docker-Container-Path-Stat` is return containing a base64 - encoded JSON object with some filesystem header information about the path.
+     * A response header `X-Docker-Container-Path-Stat` is returned, containing.
+     * a base64 - encoded JSON object with some filesystem header information
+     * about the path.
      *
      * @param string $id              ID or name of the container
      * @param array  $queryParameters {

src/Endpoint/ConfigUpdate.php

@@ -9,15 +9,20 @@ class ContainerAttach extends \Docker\API\Runtime\Client\BaseEndpoint implements
     protected $id;
 
     /**
-     * Attach to a container to read its output or send it input. You can attach to the same container multiple times and you can reattach to containers that have been detached.
+     * Attach to a container to read its output or send it input. You can attach.
+     * to the same container multiple times and you can reattach to containers
+     * that have been detached.
      *
-     * Either the `stream` or `logs` parameter must be `true` for this endpoint to do anything.
+     * Either the `stream` or `logs` parameter must be `true` for this endpoint
+     * to do anything.
      *
-     * See [the documentation for the `docker attach` command](https://docs.docker.com/engine/reference/commandline/attach/) for more details.
+     * See the [documentation for the `docker attach` command](https://docs.docker.com/engine/reference/commandline/attach/)
+     * for more details.
      *
      * ### Hijacking
      *
-     * This endpoint hijacks the HTTP connection to transport `stdin`, `stdout`, and `stderr` on the same socket.
+     * This endpoint hijacks the HTTP connection to transport `stdin`, `stdout`,
+     * and `stderr` on the same socket.
      *
      * This is the response from the daemon for an attach request:
      *
@@ -28,9 +33,11 @@ class ContainerAttach extends \Docker\API\Runtime\Client\BaseEndpoint implements
      * [STREAM]
      * ```
      *
-     * After the headers and two new lines, the TCP connection can now be used for raw, bidirectional communication between the client and server.
+     * After the headers and two new lines, the TCP connection can now be used
+     * for raw, bidirectional communication between the client and server.
      *
-     * To hint potential proxies about connection hijacking, the Docker client can also optionally send connection upgrade headers.
+     * To hint potential proxies about connection hijacking, the Docker client
+     * can also optionally send connection upgrade headers.
      *
      * For example, the client sends this request to upgrade the connection:
      *
@@ -40,7 +47,8 @@ class ContainerAttach extends \Docker\API\Runtime\Client\BaseEndpoint implements
      * Connection: Upgrade
      * ```
      *
-     * The Docker daemon will respond with a `101 UPGRADED` response, and will similarly follow with the raw stream:
+     * The Docker daemon will respond with a `101 UPGRADED` response, and will
+     * similarly follow with the raw stream:
      *
      * ```
      * HTTP/1.1 101 UPGRADED
@@ -53,9 +61,14 @@ class ContainerAttach extends \Docker\API\Runtime\Client\BaseEndpoint implements
      *
      * ### Stream format
      *
-     * When the TTY setting is disabled in [`POST /containers/create`](#operation/ContainerCreate), the stream over the hijacked connected is multiplexed to separate out `stdout` and `stderr`. The stream consists of a series of frames, each containing a header and a payload.
+     * When the TTY setting is disabled in [`POST /containers/create`](#operation/ContainerCreate),
+     * the stream over the hijacked connected is multiplexed to separate out
+     * `stdout` and `stderr`. The stream consists of a series of frames, each
+     * containing a header and a payload.
      *
-     * The header contains the information which the stream writes (`stdout` or `stderr`). It also contains the size of the associated frame encoded in the last four bytes (`uint32`).
+     * The header contains the information which the stream writes (`stdout` or
+     * `stderr`). It also contains the size of the associated frame encoded in
+     * the last four bytes (`uint32`).
      *
      * It is encoded on the first eight bytes like this:
      *
@@ -69,9 +82,11 @@ class ContainerAttach extends \Docker\API\Runtime\Client\BaseEndpoint implements
      * - 1: `stdout`
      * - 2: `stderr`
      *
-     * `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of the `uint32` size encoded as big endian.
+     * `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of the `uint32` size
+     * encoded as big endian.
      *
-     * Following the header is the payload, which is the specified number of bytes of `STREAM_TYPE`.
+     * Following the header is the payload, which is the specified number of
+     * bytes of `STREAM_TYPE`.
      *
      * The simplest way to implement this protocol is the following:
      *
@@ -83,15 +98,19 @@ class ContainerAttach extends \Docker\API\Runtime\Client\BaseEndpoint implements
      *
      * ### Stream format when using a TTY
      *
-     * When the TTY setting is enabled in [`POST /containers/create`](#operation/ContainerCreate), the stream is not multiplexed. The data exchanged over the hijacked connection is simply the raw data from the process PTY and client's `stdin`.
+     * When the TTY setting is enabled in [`POST /containers/create`](#operation/ContainerCreate),
+     * the stream is not multiplexed. The data exchanged over the hijacked
+     * connection is simply the raw data from the process PTY and client's
+     * `stdin`.
      *
      * @param string $id              ID or name of the container
      * @param array  $queryParameters {
      *
-     *     @var string $detachKeys Override the key sequence for detaching a container.Format is a single character `[a-Z]` or `ctrl-<value>` where `<value>` is one of: `a-z`, `@`, `^`, `[`, `,` or `_`.
+     *     @var string $detachKeys Override the key sequence for detaching a container.Format is a single
      *     @var bool $logs Replay previous logs from the container.
      *
-     *     @var bool $stream Stream attached streams from the time the request was made onwards
+     *     @var bool $stream Stream attached streams from the time the request was made onwards.
+     *
      *     @var bool $stdin Attach to `stdin`
      *     @var bool $stdout Attach to `stdout`
      *     @var bool $stderr Attach to `stderr`

src/Endpoint/ContainerArchiveInfo.php

@@ -12,7 +12,7 @@ class ContainerAttachWebsocket extends \Docker\API\Runtime\Client\BaseEndpoint i
      * @param string $id              ID or name of the container
      * @param array  $queryParameters {
      *
-     *     @var string $detachKeys Override the key sequence for detaching a container.Format is a single character `[a-Z]` or `ctrl-<value>` where `<value>` is one of: `a-z`, `@`, `^`, `[`, `,`, or `_`.
+     *     @var string $detachKeys Override the key sequence for detaching a container.Format is a single
      *     @var bool $logs Return logs
      *     @var bool $stream Return stream
      *     @var bool $stdin Attach to `stdin`