OSSKrSSKrSSKJrJrJr SSKJr \R"\ 5r "SS5r Sr S Sjr g) N)autherrorsutils)DEFAULT_DATA_CHUNK_SIZEc2\rSrSr\R "S5\4Sj5r\R "S5S5rSSjr SSjr SSjr SS jr SS jr SS jrSS jr\R "S5S 5r\R""S5\R "S5SSj55rSSjr\R""S5SSj5rSSjrSSjr\R "S5SSj5rSSjr\R "S5S Sj5rSrg)! ImageApiMixin imagecfURURSU5SS9nURX2S5$)ae Get a tarball of an image. Similar to the ``docker save`` command. Args: image (str): Image name to get chunk_size (int): The number of bytes returned by each iteration of the generator. If ``None``, data will be streamed as it is received. Default: 2 MB Returns: (generator): A stream of raw archive data. Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> image = client.api.get_image("busybox:latest") >>> f = open('/tmp/busybox-latest.tar', 'wb') >>> for chunk in image: >>> f.write(chunk) >>> f.close() z/images/{0}/getT)streamF)_get_url_stream_raw_result)selfr chunk_sizeress #lib/third_party/docker/api/image.py get_imageImageApiMixin.get_image s54ii "3U;DiI&&s>>chURURSU55nURUS5$)z Show the history of an image. Args: image (str): The image to show history for Returns: (str): The history of the image Raises: :py:class:`docker.errors.APIError` If the server returns an error. z/images/{0}/historyT)rr_result)rr rs rhistoryImageApiMixin.history)s/ii "7?@||C&&rNcU(aSOSU(aSOSS.nU(a;[R"URS5(aXS'OU(aXS'OSU0nU(a[R"U5US'UR UR UR S5US 9S 5nU(aUVs/sHowS PM sn$U$s snf) a List images. Similar to the ``docker images`` command. Args: name (str): Only show images belonging to the repository ``name`` quiet (bool): Only return numeric IDs as a list. 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: (dict or list): A list if ``quiet=True``, otherwise a dict. Raises: :py:class:`docker.errors.APIError` If the server returns an error. r)only_idsall1.25filter referencefiltersz /images/jsonparamsTId)r version_lt_versionconvert_filtersrrr)rnamequietrr#r%rxs rimagesImageApiMixin.images;s.#1   v66#'x +/K(*D1G  % 5 5g >F9 ll499TYY~%>v9N! %()SdGS) ) *s4Cc @U(dU(d[R"S5eURS5n[X#U[ U[ 5(aUOSUS9nSS0n U(dUR S5S:wa URURUSUS 95$[ U[ 5(a6[US 5n URURXzXSS 95sSSS5 $U(aS U S 'URURXqXS95$!,(df  g=f)a Import an image. Similar to the ``docker import`` command. If ``src`` is a string or unicode string, it will first be treated as a path to a tarball on the local system. If there is an error reading from that file, ``src`` will be treated as a URL instead to fetch the image from. You can also pass an open file handle as ``src``, in which case the data will be read from that file. If ``src`` is unset but ``image`` is set, the ``image`` parameter will be taken as the name of an existing image to import from. Args: src (str or file): Path to tarfile, URL, or file-like object repository (str): The repository to create tag (str): The tag to apply image (str): Use another image like the ``FROM`` Dockerfile parameter z(Must specify src or image to import from/images/createNsrcchanges Content-Typeapplication/tarfromSrc-)datar%rbr8r%headerstimeoutchunkedzTransfer-Encoding)r8r%r;) rDockerExceptionr_import_image_params isinstancestrgetr_postopen) rr2 repositorytagr r3 stream_srcur%r;fs r import_imageImageApiMixin.import_imagefs*u((:  II& '% U"3,,$  "#45 FJJy)S0<< 14 7 S ! !c4A||JJ&4!/8+,<< 1v G !s : D Dc URS5n[X#SUS9nSS0nURURXQXgSS95$)a Like :py:meth:`~docker.api.image.ImageApiMixin.import_image`, but allows importing in-memory bytes data. Args: data (bytes collection): Bytes collection containing valid tar data repository (str): The repository to create tag (str): The tag to apply r0r7r1r4r5Nr:)rr?rrC)rr8rErFr3rHr%r;s rimport_image_from_data$ImageApiMixin.import_image_from_datasZ II& '% g "#45|| JJVd    rc"URXX4S9$)a" Like :py:meth:`~docker.api.image.ImageApiMixin.import_image`, but only supports importing from a tar file on disk. Args: filename (str): Full path to a tar file. repository (str): The repository to create tag (str): The tag to apply Raises: IOError: File does not exist. r2rErFr3rJ)rfilenamerErFr3s rimport_image_from_file$ImageApiMixin.import_image_from_files!  S!  rc&URUSX#US9$)NT)r2rGrErFr3rQ)rr rErFr3s rimport_image_from_stream&ImageApiMixin.import_image_from_streams$  4J!  rc"URXX4S9$)z Like :py:meth:`~docker.api.image.ImageApiMixin.import_image`, but only supports importing from a URL. Args: url (str): A URL pointing to a tar file. repository (str): The repository to create tag (str): The tag to apply rPrQ)rurlrErFr3s rimport_image_from_url#ImageApiMixin.import_image_from_urls!  !  rc"URXX4S9$)a Like :py:meth:`~docker.api.image.ImageApiMixin.import_image`, but only supports importing from another image, like the ``FROM`` Dockerfile parameter. Args: image (str): Image name to import from repository (str): The repository to create tag (str): The tag to apply )r rErFr3rQ)rr rErFr3s rimport_image_from_image%ImageApiMixin.import_image_from_images!  C!  rcdURURURSU55S5$)aG Get detailed information about an image. Similar to the ``docker inspect`` command, but only for images. Args: image (str): The image to inspect Returns: (dict): Similar to the output of ``docker inspect``, but as a single dict Raises: :py:class:`docker.errors.APIError` If the server returns an error. z/images/{0}/jsonTrrr)rr s r inspect_imageImageApiMixin.inspect_images/"|| IIdii 2E: ;T  rz1.30c>[R"U5up40nUc"[R"X5nU(aXeS'O.[R S5 [R "U5US'UR SU5nURURXuS9S5$)a Get image digest and platform information by contacting the registry. Args: image (str): The image name to inspect 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: (dict): A dict containing distribution data Raises: :py:class:`docker.errors.APIError` If the server returns an error. X-Registry-AuthSending supplied auth configz/distribution/{0}/json)r;T) rresolve_repository_nameget_config_headerlogdebug encode_headerrrr)rr auth_configregistry_r;headerrYs rinspect_distribution"ImageApiMixin.inspect_distributions&2259   ++D;F-3)* II4 5)-););K)HG% &ii0%8|| IIcI +T  rc\0nUb@[R"URS5(a[R"S5eX#S'UR UR S5XSS9n[R"URS5(aURUSS9$URU5 g) a Load an image that was previously saved using :py:meth:`~docker.api.image.ImageApiMixin.get_image` (or ``docker save``). Similar to ``docker load``. Args: data (binary): Image data to be loaded. quiet (boolean): Suppress progress details in response. Returns: (generator): Progress output as JSON objects. Only available for API version >= 1.23 Raises: :py:class:`docker.errors.APIError` If the server returns an error. Nz1.23z,quiet is not supported in API version < 1.23r+z /images/loadT)r8r%r decode) rr'r(rInvalidVersionrCr version_gte_stream_helper_raise_for_status)rr8r+r%rs r load_imageImageApiMixin.load_image#s$   v66++B$7Ojj IIn %D    T]]F 3 3&&s4&8 8 s#rr cURS5n0nUb[R"U5US'URUR X#S9S5$)a Delete unused images Args: filters (dict): Filters to process on the prune list. Available filters: - dangling (bool): When set to true (or 1), prune only unused and untagged images. Returns: (dict): A dict containing a list of deleted image IDs and the amount of disk space reclaimed in bytes. Raises: :py:class:`docker.errors.APIError` If the server returns an error. z /images/pruner#r$T)rrr)rrC)rr#rYr%s r prune_imagesImageApiMixin.prune_imagesFsN&ii(   % 5 5g >F9 ||DJJsJ:DAArc[R"U5upU=(d U=(d SnU(aSn[R"U5upUUS.n 0n Uc"[R"X 5n U (aXS'O.[ R S5 [R"U5U S'Ub@[R"URS5(a[R"S5eXkS'URURS 5XUSS 9nURU5 U(aURXS 9$UR!U5$) aI Pulls an image. Similar to the ``docker pull`` command. Args: repository (str): The repository to pull tag (str): The tag to pull. If ``tag`` is ``None`` or empty, it is set to ``latest``. stream (bool): Stream the output as a generator. Make sure to consume the generator, otherwise pull might get cancelled. 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. decode (bool): Decode the JSON data from the server into dicts. Only applies with ``stream=True`` platform (str): Platform in the format ``os[/arch[/variant]]`` all_tags (bool): Pull all image tags, the ``tag`` parameter is ignored. Returns: (generator or str): The output Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> resp = client.api.pull('busybox', stream=True, decode=True) ... for line in resp: ... print(json.dumps(line, indent=4)) { "status": "Pulling image (latest) from busybox", "progressDetail": {}, "id": "e72ac664f4f0" } { "status": "Pulling image (latest) from busybox, endpoint: ...", "progressDetail": {}, "id": "e72ac664f4f0" } latestN)rF fromImagerdrez1.32z0platform was only introduced in API version 1.32platformr0)r%r;r r<rr)rparse_repository_tagrrfrgrhrirjr'r(rrtrCrrwrvr)rrErFr rkrsrall_tags image_tagrl repo_namer%r;rnresponses rpullImageApiMixin.pull_s8X!& : :: F *Y*( C":::F#   ++D;F-3)* II4 5)-););K)HG% &   v66++F"*: :: II& '4  x( &&x&? ?||H%%rcU(d[R"U5up[R"U5upgUR SU5nSU0n 0n Uc"[R "X5n U (aXS'O.[ RS5 [R"U5U S'URUSXU S9n URU 5 U(aURXS9$URU 5$)aW Push an image or a repository to the registry. Similar to the ``docker push`` command. Args: repository (str): The repository to push to tag (str): An optional tag to push stream (bool): Stream the output as a blocking generator 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. decode (bool): Decode the JSON data from the server into dicts. Only applies with ``stream=True`` Returns: (generator or str): The output from the server. Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> resp = client.api.push( ... 'yourname/app', ... stream=True, ... decode=True, ... ) ... for line in resp: ... print(line) {'status': 'Pushing repository yourname/app (1 tags)'} {'status': 'Pushing','progressDetail': {}, 'id': '511136ea3c5a'} {'status': 'Image already pushed, skipping', 'progressDetail':{}, 'id': '511136ea3c5a'} ... z/images/{0}/pushrFNrdre)r;r r%rr) rrrrfrrgrhrirj _post_jsonrwrvr) rrErFr rkrsrlrrHr%r;rnrs rpushImageApiMixin.pushsL#88DOJ":::F II(* 5 3   ++D;F-3)* II4 5)-););K)HG% &?? tWF#  x( &&x&? ?||H%%rcnX#S.nURURSU5US9nURUS5$)z Remove an image. Similar to the ``docker rmi`` command. Args: image (str): The image to remove force (bool): Force removal of the image noprune (bool): Do not delete untagged parents )forcenoprunez /images/{0}r$T)_deleterr)rr rrr%rs r remove_imageImageApiMixin.remove_images:!5ll499]E:6lJ||C&&rcvSU0nUbX#S'URURURS5US9S5$)aF Search for images on Docker Hub. Similar to the ``docker search`` command. Args: term (str): A term to search for. limit (int): The maximum number of results to return. Returns: (list of dicts): The response of the search. Raises: :py:class:`docker.errors.APIError` If the server returns an error. termlimitz/images/searchr$Tr`)rrrr%s rsearchImageApiMixin.searchsH $  #7O|| IIdii 01&I A   rcUUU(aSOSS.nURSU5nURXeS9nURU5 URS:H$)a Tag an image into a repository. Similar to the ``docker tag`` command. Args: image (str): The image to tag repository (str): The repository to set for the tag tag (str): The tag name force (bool): Force Returns: (bool): ``True`` if successful Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> client.api.tag('ubuntu', 'localhost:5000/ubuntu', 'latest', force=True) rr)rFreporz/images/{0}/tagr$)rrCrw status_code)rr rErFrr%rYrs rrFImageApiMixin.tagsX0QQ  ii)51jjj, s##%%r)NFFN)NNNNNFNNN)N)NFNFNF)NFNF)FFNF)__name__ __module__ __qualname____firstlineno__rcheck_resourcerrrr-rJrMrSrVrZr]raminimum_versionrorxr{rrrrrF__static_attributes__rrrr r s '"*A?#?8 '"'#'")VGK.32hAE'+ .EI'+ &EI)- ?C&*  CG(,  '" # ( 6" '"  ##  D!$F 6"B#B0DH38S&jDH@&D '" '# ' 2 '"&#&rr c[U[5=(a [RR U5$![ a gf=fr)r@rAospathisfile TypeError)r2s ris_filer?s? sC  GGNN3   s58 AAcUUS.nU(aX%S'O!U(a[U5(dX5S'OSUS'U(aXES'U$)N)rrFrr6r7r3)r)rrFr r2r3r%s rr?r?IsKF #{ WS\\yy#y Mrr)loggingrrrr constantsr getLoggerrrhr rr?rrrrsC ""/ !r&r&j59!%r