%!WdZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZmZe e eeefeefZdd gZGd dZGd d eeZGd deeZGdd eZ y)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 distributionversionreturnNc>t|||_||_y)zInitialize a WheelSource object. :param distribution: distribution name (like ``urllib3``) :param version: version associated with the wheel N)super__init__rr)selfrr __class__s 6/usr/lib/python3.12/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"##$Adll^:>>rc:|jd|jdS)zName of the data directory.r!z.datar#r$s rdata_dirzWheelSource.data_dir+s"##$Adll^599rct)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@rrrs 3=htI/<S34??::"T#Y"" "s "s """h':;"rc>eZdZdZdeeddffd ZdefdZxZS)_WheelFileValidationErrorz*Raised when a wheel file fails validation.issuesrNcDt|t|||_yN)rrreprrA)rrArs rrz"_WheelFileValidationError.__init__ls f& rc"d|jdS)Nz WheelFileValidationError(issues=))rAr$s r__repr__z"_WheelFileValidationError.__repr__ps1$++BBr) r3r4r5r6rr:rrGr=r>s@rr@r@is+4tCyTC#Crr@cFeZdZdZdedeededdffd ZdefdZxZS) _WheelFileBadDistInfoz8Raised when a wheel file has issues around `.dist-info`.reasonr, dist_inforNcNt||||_||_||_yrC)rrrJr,rK)rrJr,rKrs rrz_WheelFileBadDistInfo.__init__ws%     "rcT|jd|jd|jdS)Nz (filename=z , dist_info=rFrJr,rKr$s r__str__z_WheelFileBadDistInfo.__str__}s,{{m;t}}&7|DNNCUUV W r) r3r4r5r6r:rrrOr=r>s@rrIrIts8B#####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||_|jsJtjj |j}t |}t ||j|jd|_ y)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__sh  zzz77##AJJ/*84  ''$11  .2rrUzos.PathLike[str]c#tKtj|5}||dddy#1swYyxYww)z%Create a wheelfile from a given path.N)zipfileZipFile)clsrUrQs ropenzWheelFile.opens*__T "aa&L# " "s8 , 858c T|j |jS|jjDchc]}|jddd}}|Dcgc]}|j ds|}} |\}|jdd d}t|}t|j}||k7r"t d |jj|||_|Scc}wcc}w#t $r6t d|jjtt|dwxYw) r N/rr"z6Wheel doesn't contain exactly one .dist-info directoryrNr!z7Wheel .dist-info directory doesn't match wheel filename) rWrSnamelistsplitendswithr7rIr,r:sortedrsplitrr) rrUtop_level_directoriesname dist_infosr%di_dname norm_di_dnamenorm_file_dnames rr%zWheelFile.dist_info_dirsD    *&& &/3mm.D.D.F! .FdDJJsA q !.F ! 3 2TdmmL6QD2   ) ]!''Q/2)(3 +D,=,=> O +'P//'  ,;!   'O//fZ01   sCC#.C#5C((?D'c|j}|jjDcgc]5}|dddk7r+|tj||gk(r|t |dzd7c}Scc}w)z2Get names of all files in the dist-info directory.Nr_r`)r%rSrb posixpath commonprefixlen)rbaserhs rr+zWheelFile.dist_info_filenamessw!! ..0 0BCyCy--tTl;; TQ !0   s:A&r,ctj|j|}|jj |j dS)z;Get contents, from ``filename`` in the dist-info directory.zutf-8)rojoinr%rSreaddecode)rr,rUs rr.zWheelFile.read_dist_infos8~~d00(;}}!!$'..w77rT)validate_contentsrwc |jdj}t|Dcic]}|d| }}g}|j jD]#}|j dddk(r|j|j d}|jtj|j|j gk(rY|j jdddvr9|6|jd |j j d |j d |7|jd |j j d |j d tj|}|j |jdk(rC|j |j")|jd |j j dn|j |j"6|jd |j j d|j d|s|j j%|} |j'| r|jd |j j d|j d&|r t |ycc}w#t$r,}t d|j j d|g|d}~wwxYw)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. RECORDrz!Unable to retrieve `RECORD` from z: Nrnr_)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%rorprcappendr from_elementshash_sizeruvalidate) rrw record_linesrecordrecord_mappingexcrAitem record_argsdatas rr0zWheelFile.validate_records ..x8CCEL0A,0O0Ofq 6!0O MM**,D}}RS!S((,,T]]DAK!!Y%;%;##T]]3&--%%c*2.2NN*MMdmm4455Nt}}o^BC" $--001DMM?B]^ .. ><<+v{{/FMMdmm4455de||#v{{': $--0011B4==/Qkl!}}))$/t,MMdmm4455Ft}}oUijS-Z +F3 3 o +4T]]5K5K4LBsgVW  s',J JJJ K'KKc#<K|jdj}t|}|Dcic]}|d| }}|jj D]}|j dddk(r|j |j |j ddf}|jdz }t|xrtj|xr|dz}|jj|5}td |} || |fdddycc}w#1swYxYww) 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. ryrrnNr_Ir) r.rzrrSr{r,r| external_attrboolstatS_ISREGr]r ) rrrecordsrrrmode is_executablestream stream_casteds rr2zWheelFile.get_contents#s**84??A #L1:AB'&)V+'BMM**,D}}RS!S($''  r27NOF%%+D !M$,,t*s@rrrs12'//2d2 *x /D "s""H T#Y  8s8s8 <@G4DG4DG4R;h':;;r)!r6rTrorrZ contextlibrtypingrrrrrr r r installer.exceptionsr installer.recordsr rinstaller.utilsrrr:rr<__all__rr7r@rIrrrrs/  %RRR/<CE#sC-0(D@A + &R"R"jC NC  J  z; z;r