.Ph,,dZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZmZe e eeefeefZdd gZGd dZGd d eeZGd deeZGdd eZ dS)z)Source of information about a wheel file.N)contextmanager)BinaryIOClassVarIteratorListOptionalTupleTypecast)InstallerError) RecordEntryparse_record_file)canonicalize_nameparse_wheel_filename WheelSource WheelFileceZdZUdZeZeeee d<de de ddffd Z e dZ e d Ze dee fd Zd e de fd Zdd ZdeefdZxZS)rzyRepresents an installable wheel. This is an abstract class, whose methods have to be implemented by subclasses. validation_error distributionversionreturnNcdt||_||_dS)zInitialize a WheelSource object. :param distribution: distribution name (like ``urllib3``) :param version: version associated with the wheel N)super__init__rr)selfrr __class__s Q/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/installer/sources.pyrzWheelSource.__init__s. ( c&|jd|jdS) Name of the dist-info directory.- .dist-inforrrs r dist_info_dirzWheelSource.dist_info_dir&s #>>dl>>>>rc&|jd|jdS)zName of the data directory.r!z.datar#r$s rdata_dirzWheelSource.data_dir+s #99dl9999rct)zGet names of all files in the dist-info directory. Sample usage/behaviour:: >>> wheel_source.dist_info_filenames ['METADATA', 'WHEEL'] NotImplementedErrorr$s rdist_info_filenameszWheelSource.dist_info_filenames0s "!rfilenamect)zGet contents, from ``filename`` in the dist-info directory. Sample usage/behaviour:: >>> wheel_source.read_dist_info("METADATA") ... :param filename: name of the file r))rr,s rread_dist_infozWheelSource.read_dist_info;s "!rct)zValidate ``RECORD`` of the wheel. This method should be called before :py:func:`install ` if validation is required. r)r$s rvalidate_recordzWheelSource.validate_recordGs "!rct)aSequential access to all contents of the wheel (including dist-info files). This method should return an iterable. Each value from the iterable must be a tuple containing 3 elements: - record: 3-value tuple, to pass to :py:meth:`RecordEntry.from_elements `. - stream: An :py:class:`io.BufferedReader` object, providing the contents of the file at the location provided by the first element (path). - is_executable: A boolean, representing whether the item has an executable bit. All paths must be relative to the root of the wheel. Sample usage/behaviour:: >>> iterable = wheel_source.get_contents() >>> next(iterable) (('pkg/__init__.py', '', '0'), <...>, False) This method may be called multiple times. Each iterable returned must provide the same content upon reading from a specific file's stream. r)r$s r get_contentszWheelSource.get_contentsOs ."!r)rN)__name__ __module__ __qualname____doc__ ValueErrorrrr Exception__annotations__strrpropertyr%r'rr+r.r0rWheelContentElementr2 __classcell__rs@rrrs2 3=htI/<<<S34??X?::X:"T#Y"""X" "s "s " " " """"""h':;""""""""rcDeZdZdZdeeddffd ZdefdZxZS)_WheelFileValidationErrorz*Raised when a wheel file fails validation.issuesrNcrtt|||_dSN)rrreprrA)rrArs rrz"_WheelFileValidationError.__init__ls, f&&& rcd|jdS)Nz WheelFileValidationError(issues=))rAr$s r__repr__z"_WheelFileValidationError.__repr__psB$+BBBBr) r3r4r5r6rr:rrGr=r>s@rr@r@isy44tCyTC#CCCCCCCCrr@cLeZdZdZdedeededdffd ZdefdZxZS) _WheelFileBadDistInfoz8Raised when a wheel file has issues around `.dist-info`.reasonr, dist_inforNctt|||_||_||_dSrC)rrrJr,rK)rrJr,rKrs rrz_WheelFileBadDistInfo.__init__ws4       "rc6|jd|jd|jdS)Nz (filename=z , dist_info=rFrJr,rKr$s r__str__z_WheelFileBadDistInfo.__str__}s){ W Wt} W WDN W W W r) r3r4r5r6r:rrrOr=r>s@rrIrItsBB#####3#SW######          rrIceZdZdZeZdejddffd Ze e ddde dfdZ e defd Ze deefd Zd edefd Zd ddeddfdZde efdZxZS)rzImplements `WheelSource`, for an existing file from the filesystem. Example usage:: >>> with WheelFile.open("sampleproject-2.0.0-py3-none-any.whl") as source: ... installer.install(source, destination) frNc||_|jsJtj|j}t |}t |j|j d|_ dS)zInitialize a WheelFile object. :param f: An open zipfile, which will stay open as long as this object is used. )rrN) _zipfiler,ospathbasenamerrrrr_dist_info_dir)rrQrV parsed_namers rrzWheelFile.__init__s{  z7##AJ//*844  '$1    .2rrUzos.PathLike[str]c#~Ktj|5}||VddddS#1swxYwYdS)z%Create a wheelfile from a given path.N)zipfileZipFile)clsrUrQs ropenzWheelFile.opens_T " " a#a&&LLL                  s 266c |j|jSd|jD}d|D} |\}nE#t$r8t d|jjt t|dwxYw|ddd}t|}t|j }||krt d |jj|||_|S) r NcFh|]}|dddS)/r)split).0rUs r z*WheelFile.dist_info_dir..s8! ! ! &*DJJsA  q !! ! ! rc<g|]}|d|S)r")endswith)rcnames r z+WheelFile.dist_info_dir..s9   dmmL6Q6Q    rz6Wheel doesn't contain exactly one .dist-info directoryrNr!rz7Wheel .dist-info directory doesn't match wheel filename) rWrSnamelistr7rIr,r:sortedrsplitrr)rtop_level_directories dist_infosr%di_dname norm_di_dnamenorm_file_dnames rr%zWheelFile.dist_info_dirs>   *& &! ! .2m.D.D.F.F! ! !   2    ) ]]   'O/fZ0011   !''Q//2)(33 +D,=>> O + +'P/'  ,s AABc\|jfd|jDS)z2Get names of all files in the dist-info directory.cg|]D}|dddkr4tj|gk*|tdzdES)Nr`ra) posixpath commonprefixlen)rcrgbases rrhz1WheelFile.dist_info_filenames..se   BCCyCy-tTl;;;; TQ !<;;r)r%rSrj)rrxs @rr+zWheelFile.dist_info_filenamessF!     ..00    rr,ctj|j|}|j|dS)z;Get contents, from ``filename`` in the dist-info directory.zutf-8)rujoinr%rSreaddecode)rr,rUs rr.zWheelFile.read_dist_infos:~d0(;;}!!$''..w777rT)validate_contentsr}c |d}dt|D}n3#t$r&}t d|jjd|g|d}~wwxYwg}|jD]}|jdddkr||jd}|j tj |j |jgkrP|j dddvr.|+| d |jjd |jd |,| d |jjd |jd tj|}|j|j dkr3|j|j#| d |jjd-|j|j+| d |jjd|jd|rZ|j|} || s+| d |jjd|jd|rt |dS)aValidate ``RECORD`` of the wheel. This method should be called before :py:func:`install ` if validation is required. File names will always be validated against ``RECORD``. If ``validate_contents`` is true, sizes and hashes of files will also be validated against ``RECORD``. :param validate_contents: Whether to validate content integrity. RECORDc i|] }|d| Srrcrecords r z-WheelFile.validate_record..s+&,q 6rz!Unable to retrieve `RECORD` from z: Nrtr`)z RECORD.p7sz RECORD.jwszIn z, digital signature file z$ is incorrectly contained in RECORD.z, z is not mentioned in RECORDz/RECORDz/, RECORD file incorrectly contains hash / size.z, hash / size of z is not included in RECORDz didn't match RECORD)r. splitlinesrr8r@rSr,infolistpopr%rurvrbappendr from_elementshash_sizer{validate) rr} record_linesrecord_mappingexcrAitem record_argsrdatas rr0zWheelFile.validate_records ..x88CCEEL0A,0O0ONN   +VT]5KVVsVVW   M**,,+ + D}RSS!S(((,,T]DAAK!Y%;#T]3&&-%%c**2.2NNN*MMCdm4CCt}CCC" ^$-0^^DM^^^ .  > >>><+v{/FMMedm4eee|#v{': l$-0ll4=lll! }))$//t,,MMjdm4jjt}jjj  4+F33 3 4 4sAA A3 !A..A3c#*K|d}t|}d|D}|jD]}|jdddkr||j|jddf}|jdz }t|otj |o|dz}|j |5}td |} || |fVdddn #1swxYwYdS) aSequential access to all contents of the wheel (including dist-info files). This implementation requires that every file that is a part of the wheel archive has a corresponding entry in RECORD. If they are not, an :any:`AssertionError` will be raised. rc i|] }|d| Srrrs rrz*WheelFile.get_contents..-sBBB&)VBBBrrtNr`Ir) r.rrrSrr,r external_attrboolstatS_ISREGr]r ) rrrecordsrrrmode is_executablestream stream_casteds rr2zWheelFile.get_contents#sh**844??AA #L11BB'BBBM**,, ; ;D}RSS!S(($''  r27NOOF%+D !M$,t*<*s@rrrsn12'/2d222222 *x /D^[ "s"""X"H T#Y   X 8s8s8888 <@G4G4G4DG4DG4G4G4G4R;h':;;;;;;;;;r)!r6rTrurrZ contextlibrtypingrrrrrr r r installer.exceptionsr installer.recordsr rinstaller.utilsrrr:rr<__all__rr7r@rIrrrrrs//  %%%%%%RRRRRRRRRRRRRRRRRRRR//////<<<<<<<<CCCCCCCCE#sC-0(D@A + &R"R"R"R"R"R"R"R"jCCCCC NCCC      J    z;z;z;z;z; z;z;z;z;z;r