2.a`DddlZddlZddlZddlmZddlmZddlmZm Z m Z ddl m Z ddl mZdd lmZmZGd d eZGd d eZGddeZdZy)N) APIClient)DEFAULT_DATA_CHUNK_SIZE) BuildErrorImageLoadErrorInvalidArgument)parse_repository_tag) json_stream) CollectionModelc`eZdZdZdZedZedZedZdZ e dfdZ d d Z y ) Imagez! An image on the server. cdj|jjdj|jS)Nz <{}: '{}'>z', ')format __class____name__jointagsselfs 6/usr/lib/python3/dist-packages/docker/models/images.py__repr__zImage.__repr__s,""4>>#:#:FKK :r)rrtags rrz Image.tags&s; zz~~j) <D#>so'=>>>s 66c`|jjj|jS)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 rr1z Image.history0s!{{&&tww//rFc|j}|rK|jr|jdn|}t|tr||jvrt |d|}|j j j||S)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 isinstancestrrr/r0 get_image)r chunk_sizenamedimgs rsavez Image.save=su<gg "&))$))A,C%% )) '!CD{{((j99rNc j|jjj|j|fd|i|S)a 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 r-)r/r0r-r(r repositoryr-kwargss rr-z Image.taggs/"#t{{""477JJCJ6JJrN) r __module__ __qualname____doc__rpropertyr"r*rr1rr9r-rrrr saT?? 06U(:TKrrceZdZdZfdZedZedZddZdZ dZ e jje _xZ S) RegistryDatazO Image metadata stored on the registry, including available platforms. c2t||i|||_yr>)super__init__ image_name)rrIargsr=rs rrHzRegistryData.__init__s $)&)$rc&|jddS)z' The ID of the object. Descriptordigest)rrs rr(zRegistryData.ids zz,'11rc |jddS)r$Nr&)r(rs rr*zRegistryData.short_ids wws|rct|j\}}|jj||j|S)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. )r-platform)r rI collectionpullr()rrPr<_s rrRzRegistryData.pulls6-T__= A##JDGGh#OOrcj|rt|tso|jd}t|dkDst|dkrt d|dd|di}t|dkDr|d|d <t|dkDr|d|d <t ||j j|jd vS) 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) r3dictsplitlenrnormalize_platformr/versionr)rrPpartss r has_platformzRegistryData.has_platforms" Jx6NN3'E5zA~Ua%z!EFeAh'H5zA~&+Ah#5zA~+08(! dkk))+ ZZ $% %rcl|jjj|j|_yr>)r/r0inspect_distributionrIrrs rreloadzRegistryData.reloads [[__99$//J rr>) rr?r@rArHrBr(r*rRrbrer __classcell__)rs@rrErE{s\%22  P%@K\\))FNNrrEcjeZdZeZdZdZd dZddZdZ ddZ d dZ e jje _ d Ze jje_ d Ze j je_ d d Ze j$je_ d Ze j&je_ y)ImageCollectionc |jjjdi|}t|tr|j |Sd}d}t jt|\}}|D]G}d|vrt|d|d|vr,tjd|d}|r|jd}|}I|r|j ||fSt|xsd|)a Build an image and return it. Similar to the ``docker build`` command. Either ``path`` or ``fileobj`` must be set. If you have a tar file for the Docker build context (including a Dockerfile) already, pass a readable file-like object to ``fileobj`` and also pass ``custom_context=True``. If the stream is compressed also, 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 build. 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]+)$rUnknownrC) r/r0buildr3r4r itertoolsteer rresearchgroup) rr=resp last_eventimage_id result_streaminternal_streamchunkmatchs rrmzImageCollection.buildsX%t{{$$.v. dC 88D> ! )2{47H)I& $ E% w??5  A(O${{1~HJ  HHX& 6 60y-@@rcj|j|jjj|S)am 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_modelr/r0 inspect_image)rnames rr zImageCollection.get*s( !!$++//"?"?"EFFrNc|t||jjj|||j|S)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. )rIrr/rQ)rEr/r0rd)rr} auth_configs rget_registry_dataz!ImageCollection.get_registry_data<s6"++//66t[I;;   rc|jjj|||}|Dcgc]}|j|dc}Scc}w)a 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. )r}allfiltersId)r/r0imagesr )rr}rrrsrs rlistzImageCollection.listTsD*{{%%4S'%J+/0a4!000sA cL|jjj|}g}|D]U}d|vr=tjd|d}|r"|j d}|j |d|vsIt|d|Dcgc]}|j|c}Scc}w)a 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. rkz)(^Loaded image ID: |^Loaded image: )(.+)$rrj) r/r0 load_imagerprqrrappendrr )rdatarsrrxryruis rloadzImageCollection.loadls {{))$/ 5E5  @(O${{1~HMM(+%$U7^44 5&,, ,,,sB!c nt|\}}|xs|xsd}d|vrtjd|d=|jjj |f|d|d|}|D]}|s=|j dj|||jdr dSd S|j|S) 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) latestrkzH`stream` is not a valid parameter for this method and will be overriddenT)r-rkall_tagsz {0}{2}{1}r%@:) r warningswarnr/r0rRr rr)r)rr<r-rr= image_tagpull_logrSs rrRzImageCollection.pullsL!5Z @ I*Y*( v  MM* x '4;;??''  x CI  A    88K..Cy(A GJ yy$$rc T|jjj|fd|i|S)Nr-)r/r0pushr;s rrzImageCollection.pushs'#t{{##JBCB6BBrcP|jjj|i|yr>)r/r0 remove_imagerrJr=s rremovezImageCollection.removes$ $$d5f5rcN|jjj|i|Sr>)r/r0rqrs rrqzImageCollection.searchs"%t{{%%t6v66rcN|jjj|S)N)r)r/r0 prune_images)rrs rprunezImageCollection.prunes{{++G+<)r/r0 prune_buildsrs rrzImageCollection.prune_buildss"+t{{++T)NFN)NF)rr?r@rmodelrmr rrrrRrrrArrrqrrrrCrrrhrhs E_ABG$ 010-@<%|C>>))DL6++33FN7%%--FN=**22EM=$1199Lrrhc>|i}d|vr|d|d<d|vr|d|d<|S)NrXOsrZArchrC)rP engine_infos rr_r_s? 8$T*X%#.v#6 Or)rnrprr0r constantsrerrorsrrrutilsr utils.json_streamr resourcer r rrErhr_rCrrrsW /@@(+'kKEkK\H*5H*VV:jV:rr