ZFSSKrSSKrSSKrSSKJr SSKJr SSKJrJ r J r SSK J r SSK Jr SS KJrJr "S S \5r"S S \5r"SS\5rSrg)N) APIClient)DEFAULT_DATA_CHUNK_SIZE) BuildErrorImageLoadErrorInvalidArgument)parse_repository_tag) json_stream) CollectionModelcv\rSrSrSrSr\S5r\S5r\S5r Sr SS jr \ S4S jr SS jrS rg )Image z An image on the server. cSRURRSRUR55$)Nz <{}: '{}'>z', ')format __class____name__jointagsselfs 'lib/third_party/docker/models/images.py__repr__Image.__repr__s2"" NN # # KK "  cTURSRS5nU=(d 0$)z' The labels of an image as dictionary. ConfigLabelsattrsget)rresults rlabels Image.labelss' H%))(3|rc~URRS5(aURSS$URSS$)N The ID of the image truncated to 12 characters, plus the ``sha256:`` prefix. sha256:N )id startswithrs rshort_idImage.short_ids9 77  i ( (773B< wws|rcURRS5nUc/nUVs/sH o"S:wdM UPM sn$s snf)z The image's tags. RepoTagsz :r )rrtags rr Image.tags)s= zz~~j) <D#>to'=t>>>s ;;c`URRRUR5$)z Show the history of an image. Returns: (str): The history of the image. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )clientapihistoryr+rs rr6 Image.history3s!{{&&tww//rFc`URRRURUUS9$)z Remove this image. Args: force (bool): Force removal of the image noprune (bool): Do not delete untagged parents Raises: :py:class:`docker.errors.APIError` If the server returns an error. )forcenoprune)r4r5 remove_imager+)rr9r:s rremove Image.remove@s1{{++ GG,  rcURnU(aVUR(aURSOUn[U[5(aX R;a[ US35eUnUR R RX15$)a Get a tarball of an image. Similar to the ``docker save`` command. Args: chunk_size (int): The generator will return up to that much data per iteration, but may return less. If ``None``, data will be streamed as it is received. Default: 2 MB named (str or bool): If ``False`` (default), the tarball will not retain repository and tag information for this image. If set to ``True``, the first tag in the :py:attr:`~tags` list will be used to identify the image. Alternatively, any element of the :py:attr:`~tags` list can be used as an argument to use that specific tag as the saved identifier. Returns: (generator): A stream of raw archive data. Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> image = cli.images.get("busybox:latest") >>> f = open('/tmp/busybox-latest.tar', 'wb') >>> for chunk in image.save(): >>> f.write(chunk) >>> f.close() rz" is not a valid tag for this image)r+r isinstancestrrr4r5 get_image)r chunk_sizenamedimgs rsave Image.saveRst<gg "&))$))A,C%%% )) '!CD{{((99rNc jURRR"URU4SU0UD6$)aB Tag this image into a repository. Similar to the ``docker tag`` command. Args: repository (str): The repository to set for the tag tag (str): The tag name force (bool): Force Raises: :py:class:`docker.errors.APIError` If the server returns an error. Returns: (bool): ``True`` if successful r1)r4r5r1r+r repositoryr1kwargss rr1 Image.tag|s-"{{""477JJCJ6JJr)FFN)r __module__ __qualname____firstlineno____doc__rpropertyr$r-rr6r<rrEr1__static_attributes__rLrrrr se ?? 0 $6U(:TKrrc^\rSrSrSrU4Sjr\S5r\S5rS Sjr Sr Sr \ RR\ lS r U=r$) RegistryDatazG Image metadata stored on the registry, including available platforms. c2>[TU]"U0UD6 XlgrM)super__init__ image_name)rrZargsrJrs rrYRegistryData.__init__s $)&)$rc&URSS$)z The ID of the object. Descriptordigest)r!rs rr+RegistryData.ids zz,'11rc URSS$)r'Nr))r+rs rr-RegistryData.short_ids wws|rcx[UR5up#URRX RUS9$)z Pull the image digest. Args: platform (str): The platform to pull the image for. Default: ``None`` Returns: (:py:class:`Image`): A reference to the pulled image. )r1platform)r rZ collectionpullr+)rrdrI_s rrfRegistryData.pulls2-T__= ##JGGh#OOrcU(a[U[5(dsURS5n[U5S:d[U5S:a[ SUS35eSUS0n[U5S:aUSUS '[U5S:aUSUS '[ XR R55URS ;$) a Check whether the given platform identifier is available for this digest. Args: platform (str or dict): A string using the ``os[/arch[/variant]]`` format, or a platform dictionary. Returns: (bool): ``True`` if the platform is recognized as available, ``False`` otherwise. Raises: :py:class:`docker.errors.InvalidArgument` If the platform argument is not a valid descriptor. /r "z$" is not a valid platform descriptorosrrvariant architecture Platforms) r?dictsplitlenrnormalize_platformr4versionr!)rrdpartss r has_platformRegistryData.has_platforms" Jx66NN3'E5zA~Ua%z!EFeAh'H5zA~&+Ah#5zA~+08(! kk))+ ZZ $% %rclURRRUR5UlgrM)r4r5inspect_distributionrZr!rs rreloadRegistryData.reloads [[__99$//J r)r!rZrM)rrNrOrPrQrYrRr+r-rfrwr{r rS __classcell__)rs@rrUrUs\%22  P%@K\\))FNNrrUc|\rSrSr\rSrSrSSjrSSjr Sr SSjr SS jr \ RR\ lS r\ R R\lS r\ R"R\lSS jr\ R&R\lS r\ R(R\lSrg)ImageCollectionc URRR"S0UD6n[U[5(aUR U5$SnSn[ R"[U55upVUHRnSU;a[USU5eSU;a2[R"SUS5nU(aURS5nUnMT U(aUR U5U4$[U=(d SU5e)ae Build an image and return it. Similar to the ``docker build`` command. Either ``path`` or ``fileobj`` must be set. If you already have a tar file for the Docker build context (including a Dockerfile), pass a readable file-like object to ``fileobj`` and also pass ``custom_context=True``. If the stream is also compressed, set ``encoding`` to the correct value (e.g ``gzip``). If you want to get the raw output of the build, use the :py:meth:`~docker.api.build.BuildApiMixin.build` method in the low-level API. Args: path (str): Path to the directory containing the Dockerfile fileobj: A file object to use as the Dockerfile. (Or a file-like object) tag (str): A tag to add to the final image quiet (bool): Whether to return the status nocache (bool): Don't use the cache when set to ``True`` rm (bool): Remove intermediate containers. The ``docker build`` command now defaults to ``--rm=true``, but we have kept the old default of `False` to preserve backward compatibility timeout (int): HTTP timeout custom_context (bool): Optional if using ``fileobj`` encoding (str): The encoding for a stream. Set to ``gzip`` for compressing pull (bool): Downloads any updates to the FROM image in Dockerfiles forcerm (bool): Always remove intermediate containers, even after unsuccessful builds dockerfile (str): path within the build context to the Dockerfile buildargs (dict): A dictionary of build arguments container_limits (dict): A dictionary of limits applied to each container created by the build process. Valid keys: - memory (int): set memory limit for build - memswap (int): Total memory (memory + swap), -1 to disable swap - cpushares (int): CPU shares (relative weight) - cpusetcpus (str): CPUs in which to allow execution, e.g., ``"0-3"``, ``"0,1"`` shmsize (int): Size of `/dev/shm` in bytes. The size must be greater than 0. If omitted the system uses 64MB labels (dict): A dictionary of labels to set on the image cache_from (list): A list of images used for build cache resolution target (str): Name of the build-stage to build in a multi-stage Dockerfile network_mode (str): networking mode for the run commands during build squash (bool): Squash the resulting images layers into a single layer. extra_hosts (dict): Extra hosts to add to /etc/hosts in building containers, as a mapping of hostname to IP address. platform (str): Platform in the format ``os[/arch[/variant]]``. isolation (str): Isolation technology used during build. Default: `None`. use_config_proxy (bool): If ``True``, and if the docker client configuration file (``~/.docker/config.json`` by default) contains a proxy configuration, the corresponding environment variables will be set in the container being built. Returns: (tuple): The first item is the :py:class:`Image` object for the image that was built. The second item is a generator of the build logs as JSON-decoded objects. Raises: :py:class:`docker.errors.BuildError` If there is an error during the build. :py:class:`docker.errors.APIError` If the server returns any other error. ``TypeError`` If neither ``path`` nor ``fileobj`` is specified. Nerrorstreamz*(^Successfully built |sha256:)([0-9a-f]+)$rUnknownrL) r4r5buildr?r@r" itertoolsteer rresearchgroup) rrJresp last_eventimage_id result_streaminternal_streamchunkmatchs rrImageCollection.buildsX{{$$.v. dC 88D> ! )2{47H)I& $E% w??5  A(O${{1~HJ% HHX& 6 60y-@@rcjURURRRU55$)a Gets an image. Args: name (str): The name of the image. Returns: (:py:class:`Image`): The image. Raises: :py:class:`docker.errors.ImageNotFound` If the image does not exist. :py:class:`docker.errors.APIError` If the server returns an error. ) prepare_modelr4r5 inspect_image)rnames rr"ImageCollection.get?s( !!$++//"?"?"EFFrNct[UURRRX5URUS9$)a Gets the registry data for an image. Args: name (str): The name of the image. auth_config (dict): Override the credentials that are found in the config for this request. ``auth_config`` should contain the ``username`` and ``password`` keys to be valid. Returns: (:py:class:`RegistryData`): The data object. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )rZr!r4re)rUr4r5rz)rr auth_configs rget_registry_data!ImageCollection.get_registry_dataQs4"++//66tI;;   rcURRRXUS9nUVs/sHoPRUS5PM sn$s snf)a2 List images on the server. Args: name (str): Only show images belonging to the repository ``name`` all (bool): Show intermediate image layers. By default, these are filtered out. filters (dict): Filters to be processed on the image list. Available filters: - ``dangling`` (bool) - `label` (str|list): format either ``"key"``, ``"key=value"`` or a list of such. Returns: (list of :py:class:`Image`): The images. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )rallfiltersId)r4r5imagesr")rrrrrrs rlistImageCollection.listisD*{{%%4'%J+/04a4!4000sA chURRRU5n/nUH`nSU;aC[R"SUS5nU(a"UR S5nUR U5 SU;dMT[US5e UVs/sHopRU5PM sn$s snf)aO Load an image that was previously saved using :py:meth:`~docker.models.images.Image.save` (or ``docker save``). Similar to ``docker load``. Args: data (binary): Image data to be loaded. Returns: (list of :py:class:`Image`): The images. Raises: :py:class:`docker.errors.APIError` If the server returns an error. rz)(^Loaded image ID: |^Loaded image: )(.+)$rr) r4r5 load_imagerrrappendrr")rdatarrrrris rloadImageCollection.loads {{))$/E5  @(O${{1~HMM(+%$U7^44&,,V V,,,sB/c [U5upU=(d U=(d SnSU;a[R"S5 US URRR "U4USUS.UD6nUHnM U(dAUR SRXURS5(a S55$S 55$URU5$) a Pull an image of the given name and return it. Similar to the ``docker pull`` command. If ``tag`` is ``None`` or empty, it is set to ``latest``. If ``all_tags`` is set, the ``tag`` parameter is ignored and all image tags will be pulled. If you want to get the raw pull output, use the :py:meth:`~docker.api.image.ImageApiMixin.pull` method in the low-level API. Args: repository (str): The repository to pull tag (str): The tag to pull auth_config (dict): Override the credentials that are found in the config for this request. ``auth_config`` should contain the ``username`` and ``password`` keys to be valid. platform (str): Platform in the format ``os[/arch[/variant]]`` all_tags (bool): Pull all image tags Returns: (:py:class:`Image` or list): The image that has been pulled. If ``all_tags`` is True, the method will return a list of :py:class:`Image` objects belonging to this repository. Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> # Pull the image tagged `latest` in the busybox repo >>> image = client.images.pull('busybox') >>> # Pull all tags in the busybox repo >>> images = client.images.pull('busybox', all_tags=True) latestrzH`stream` is not a valid parameter for this method and will be overriddenT)r1rall_tagsz {0}{2}{1}r(@:) r warningswarnr4r5rfr"rr,r)rrIr1rrJ image_tagpull_logrgs rrfImageCollection.pullsL!5Z @ *Y*( v  MM* x ;;??''  x CI A   88K..y(A(A GJ yy$$rc TURRR"U4SU0UD6$)Nr1)r4r5pushrHs rrImageCollection.pushs%{{##JBCB6BBrcPURRR"U0UD6 grM)r4r5r;rr[rJs rr<ImageCollection.removes $$d5f5rcNURRR"U0UD6$rM)r4r5rrs rrImageCollection.searchs {{%%t6v66rcHURRRUS9$)N)r)r4r5 prune_images)rrs rpruneImageCollection.prunes{{++G+<>))DL6++33FN7%%--FN=**22EM=$1199LrrcHUc0nSU;aUSUS'SU;aUSUS'U$)NrmOsroArchrL)rd engine_infos rrtrts? 8$T*X%#.v#6 Or)rrrr5r constantsrerrorsrrrutilsr utils.json_streamr resourcer r rrUrrtrLrrrsW /@@(+'@KE@KFH*5H*VV:jV:rr