o U h,@sdZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZmZe e eeefeefZdd gZGd ddZGd d d eeZGd ddeeZGdd d eZ dS)z)Source of information about a wheel file.N)contextmanager)BinaryIOClassVarIteratorListOptionalTupleTypecast)InstallerError) RecordEntryparse_record_file)canonicalize_nameparse_wheel_filename WheelSource WheelFilecseZdZUdZeZeeee d<de de ddffdd Z e d d Z e d d Ze dee fd dZde de fddZdddZdeefddZZS)rzyRepresents an installable wheel. This is an abstract class, whose methods have to be implemented by subclasses. validation_error distributionversionreturnNcst||_||_dS)zInitialize a WheelSource object. :param distribution: distribution name (like ``urllib3``) :param version: version associated with the wheel N)super__init__rr)selfrr __class__e/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/installer/sources.pyrs  zWheelSource.__init__cC|jd|jdS) Name of the dist-info directory.- .dist-inforrrrrr dist_info_dir&zWheelSource.dist_info_dircCr)zName of the data directory.rz.datar!r"rrrdata_dir+r$zWheelSource.data_dircCt)zGet names of all files in the dist-info directory. Sample usage/behaviour:: >>> wheel_source.dist_info_filenames ['METADATA', 'WHEEL'] NotImplementedErrorr"rrrdist_info_filenames0s zWheelSource.dist_info_filenamesfilenamecCr&)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*rrrread_dist_info;s zWheelSource.read_dist_infocCr&)zValidate ``RECORD`` of the wheel. This method should be called before :py:func:`install ` if validation is required. r'r"rrrvalidate_recordGszWheelSource.validate_recordcCr&)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"rrr get_contentsOszWheelSource.get_contents)rN)__name__ __module__ __qualname____doc__ ValueErrorrrr Exception__annotations__strrpropertyr#r%rr)r+r,rWheelContentElementr- __classcell__rrrrrs    cs<eZdZdZdeeddffdd ZdefddZZS) _WheelFileValidationErrorz*Raised when a wheel file fails validation.issuesrNcstt|||_dSN)rrreprr:)rr:rrrrls z"_WheelFileValidationError.__init__cCsd|jdS)Nz WheelFileValidationError(issues=))r:r"rrr__repr__psz"_WheelFileValidationError.__repr__) r.r/r0r1rr5rr>r8rrrrr9isr9csDeZdZdZdedeededdffdd Zdefd d ZZS) _WheelFileBadDistInfoz8Raised when a wheel file has issues around `.dist-info`.reasonr* dist_inforNcs"t|||_||_||_dSr;)rrr@r*rA)rr@r*rArrrrws  z_WheelFileBadDistInfo.__init__cCs|jd|jd|jdS)Nz (filename=z , dist_info=r=r@r*rAr"rrr__str__}sz_WheelFileBadDistInfo.__str__) r.r/r0r1r5rrrCr8rrrrr?ts"r?cseZdZdZeZdejddffdd Ze e ddde dfd d Z e defd d Ze deefd dZdedefddZdddeddfddZde efddZZS)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) frNcsD||_|jsJtj|j}t|}tj|j|j dd|_ 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)rrDrH parsed_namerrrrs  zWheelFile.__init__rGzos.PathLike[str]ccs<t|}||VWddS1swYdS)z%Create a wheelfile from a given path.N)zipfileZipFile)clsrGrDrrropens  "zWheelFile.openc Cs|jdur|jSdd|jD}dd|D}z|\}Wnty3td|jjtt|ddw|dd d }t |}t |j }||krRtd |jj|d||_|S) rNcSsh|] }|dddqS)/r)split).0rGrrr sz*WheelFile.dist_info_dir..cSsg|] }|dr|qS)r )endswithrRnamerrr s  z+WheelFile.dist_info_dir..z6Wheel doesn't contain exactly one .dist-info directoryrBrrz7Wheel .dist-info directory doesn't match wheel filename) rIrEnamelistr2r?r*r5sortedrsplitrr)rtop_level_directories dist_infosr#di_dname norm_di_dnamenorm_file_dnamerrrr#s<     zWheelFile.dist_info_dircs|jfdd|jDS)z2Get names of all files in the dist-info directory.csBg|]}|dddkrt|gkr|tddqS)NrOrP) posixpath commonprefixlenrUbaserrrWs z1WheelFile.dist_info_filenames..)r#rErYr"rrerr)s zWheelFile.dist_info_filenamesr*cCs t|j|}|j|dS)z;Get contents, from ``filename`` in the dist-info directory.zutf-8)rbjoinr#rEreaddecode)rr*rGrrrr+szWheelFile.read_dist_infoT)validate_contentsrjc Csz|d}ddt|D}Wnty,}ztd|jjd|g|d}~wwg}|jD]}|jdddkr@q4||jd}|j t |j |jgkrq|j ddd vrq|durp| d |jjd |jd q4|dur| d |jjd |jdq4tj|}|j|j dkr|jdus|jdur| d |jjdq4|jdus|jdur| d |jjd|jd|r|j|} || s| d |jjd|jdq4|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. RECORDcSi|]}|d|qSrrrRrecordrrr s z-WheelFile.validate_record..z!Unable to retrieve `RECORD` from z: NrarO)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+ splitlinesr r3r9rEr*infolistpopr#rbrcrQappendr from_elementshash_sizerhvalidate) rrj record_linesrecord_mappingexcr:item record_argsrodatarrrr,sj      zWheelFile.validate_recordc cs|d}t|}dd|D}|jD]J}|jdddkr$q||j|jddf}|jd?}t|o?t |o?|d @}|j |}t d |} || |fVWdn1s]wYqdS) 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. rkcSrlrmrrnrrrrp-sz*WheelFile.get_contents..raNrOIr) r+rqr rErrr*rs external_attrboolstatS_ISREGrNr ) rryrecordsrzr|romode is_executablestream stream_castedrrrr-#s   zWheelFile.get_contents)r.r/r0r1r9rrKrLr classmethodrrrNr6r5r#rr)r+rr,r7r-r8rrrrrs$ I)!r1rFrbrrK contextlibrtypingrrrrrrr r installer.exceptionsr installer.recordsr r installer.utilsrrr5rr7__all__rr2r9r?rrrrrs  ( U