9iPFddlZddlZddlZddlmZddlmZddlmZm 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) CollectionModelcheZdZdZdZedZedZedZdZ d dZ e dfd Z d d Z y )Imagez! An image on the server. crdj|j}d|jjd|dS)Nz', ')jointags __class____name__)selftag_strs U/home/factor_ks/STREAMA2026/venv/lib/python3.12/site-packages/docker/models/images.py__repr__zImage.__repr__s4++dii(4>>**+3wir::cJ|jdjd}|xsiS)z7 The labels of an image as dictionary. ConfigLabelsattrsget)rresults rlabelsz Image.labelss' H%))(3|rct|jjdr|jddS|jddS)f The ID of the image truncated to 12 characters, plus the ``sha256:`` prefix. sha256:N )id startswithrs rshort_idzImage.short_ids6 77  i (773B< wws|rcv|jjd}|g}|Dcgc] }|dk7s | c}Scc}w)z# The image's tags. RepoTagsz :r)rrtags rrz Image.tags's; zz~~j) <D#>so'=>>>s 66c`|jjj|jS)z Show the history of an image. Returns: (list): The history of the image. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )clientapihistoryr(r*s rr2z Image.history1s!{{&&tww//rFcf|jjj|j||S)a 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)r0r1 remove_imager()rr4r5s rremovez Image.remove>s1{{++ GG,  rc|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 isinstancestrrr0r1 get_image)r chunk_sizenamedimgs rsavez Image.savePsu<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.)r0r1r.r(r repositoryr.kwargss rr.z Image.tagzs/"#t{{""477JJCJ6JJr)FFN)r __module__ __qualname____doc__rpropertyr"r+rr2r7rr?r.rrrr se;?? 0 $6U(:TKrrceZdZdZfdZedZedZddZdZ dZ e jje _xZ S) RegistryDatazO Image metadata stored on the registry, including available platforms. c2t||i|||_yrD)super__init__ image_name)rrOargsrCrs rrNzRegistryData.__init__s $)&)$rc&|jddS)z' The ID of the object. Descriptordigest)rr*s rr(zRegistryData.ids zz,'11rc |jddS)r$Nr&)r(r*s 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 rO collectionpullr()rrVrB_s rrXzRegistryData.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) r9dictsplitlenrnormalize_platformr0versionr)rrVpartss r has_platformzRegistryData.has_platforms" Jx6NN3'E5zA~Ua%z!EFeAh'H5zA~&+Ah#5zA~+08(! dkk))+ ZZ $% %rcl|jjj|j|_yrD)r0r1inspect_distributionrOrr*s rreloadzRegistryData.reloads [[__99$//J rrD) rrErFrGrNrHr(r+rXrhrkr __classcell__)rs@rrKrKs\%22  P%@K\\))FNNrrKcjeZdZeZdZdZd 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 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]+)$rUnknownrI) r0r1buildr9r:r itertoolsteer rresearchgroup) rrCresp last_eventimage_id result_streaminternal_streamchunkmatchs rrszImageCollection.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_modelr0r1 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. )rOrr0rW)rKr0r1rj)rr auth_configs rget_registry_dataz!ImageCollection.get_registry_dataOs6"++//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. )rallfiltersId)r0r1imagesr )rrrrryrs rlistzImageCollection.listgsD*{{%%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. rqz)(^Loaded image ID: |^Loaded image: )(.+)$rrp) r0r1 load_imagervrwrxappendrr )rdataryrr~rr{is rloadzImageCollection.loads {{))$/ 5E5  @(O${{1~HMM(+%$U7^44 5&,, ,,,sB!c Pt|\}}|xs|xsd}d|vrtjdd|d=|jjj |f|d|d|}|D]}|s,|j drd nd }|j|||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) latestrqzH`stream` is not a valid parameter for this method and will be overriddenr ) stacklevelT)r.rqall_tagsr%@:) r warningswarnr0r1rXr)r r) rrBr.rrC image_tagpull_logrYseps rrXzImageCollection.pullsL!5Z @ I*Y*( v  MM*  x '4;;??''  x CI  A     2#C88zl3%u56 6yy$$rc T|jjj|fd|i|S)Nr.)r0r1pushrAs rrzImageCollection.pushs'#t{{##JBCB6BBrcP|jjj|i|yrD)r0r1r6rrPrCs rr7zImageCollection.removes$ $$d5f5rcN|jjj|i|SrD)r0r1rwrs rrwzImageCollection.searchs"%t{{%%t6v66rcN|jjj|S)N)r)r0r1 prune_images)rrs rprunezImageCollection.prunes{{++G+<>))DL6++33FN7%%--FN=**22EM=$1199Lrrnc>|i}d|vr|d|d<d|vr|d|d<|S)Nr^Osr`ArchrI)rV engine_infos rreres? 8$T*X%#.v#6 Or)rtrvrr1r constantsrerrorsrrrutilsr utils.json_streamr resourcer r rrKrnrerIrrrsW /@@(+'~KE~KBH*5H*VV:jV:rr