o U h'@sdZddlZddlZddlZddlmZddlmZmZm Z m Z m Z m Z m Z mZddlmZmZddlmZddlmZmZmZmZmZerNddlmZmZGd d d ZGd d d eZdS) z:Handles all file writing and post-installation processing.N)Path) TYPE_CHECKINGBinaryIO CollectionDictIterableOptionalTupleUnion)Hash RecordEntry)Script)Schemeconstruct_record_filecopyfileobj_with_hashing fix_shebangmake_file_executable) LauncherKind ScriptSectionc @szeZdZdZdedededddef dd Zd ed eed fd e de def ddZ d edede e eefddfddZdS)WheelDestinationzHandles writing the unpacked files, script generation and ``RECORD`` generation. Subclasses provide the concrete script generation logic, as well as the RECORD file (re)writing. namemoduleattrsectionrreturncCt)aWrite a script in the correct location to invoke given entry point. :param name: name of the script :param module: module path, to load the entry point from :param attr: final attribute access, for the entry point :param section: Denotes the "entry point section" where this was specified. Valid values are ``"gui"`` and ``"console"``. :type section: str Example usage/behaviour:: >>> dest.write_script("pip", "pip._internal.cli", "main", "console") NotImplementedError)selfrrrrrj/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/installer/destinations.py write_script'szWheelDestination.write_scriptschemepathos.PathLike[str]stream is_executablecCr)aWrite a file to correct ``path`` within the ``scheme``. :param scheme: scheme to write the file in (like "purelib", "platlib" etc). :param path: path within that scheme :param stream: contents of the file :param is_executable: whether the file should be made executable The stream would be closed by the caller, after this call. Example usage/behaviour:: >>> with open("__init__.py") as stream: ... dest.write_file("purelib", "pkg/__init__.py", stream) r)rr"r#r%r&rrr write_file:szWheelDestination.write_filerecord_file_pathrecordsNcCr)aFinalize installation, after all the files are written. Handles (re)writing of the ``RECORD`` file. :param scheme: scheme to write the ``RECORD`` file in :param record_file_path: path of the ``RECORD`` file with that scheme :param records: entries to write to the ``RECORD`` file Example usage/behaviour:: >>> dest.finalize_installation("purelib") r)rr"r(r)rrr finalize_installationRsz&WheelDestination.finalize_installation)__name__ __module__ __qualname____doc__strr r!rr rboolr'rr r*rrrr r sB   rc@seZdZdZ   d(deeefdeddd ed eed eed dfd dZ de ded efddZ de dede de d ef ddZde deedfde de d ef ddZdedededdd ef dd Zde d!ed dfd"d#Zde d$ed%eee efd dfd&d'ZdS))SchemeDictionaryDestinationz>Destination, based on a mapping of {scheme: file-system-path}.sha256rN scheme_dict interpreter script_kindrhash_algorithmbytecode_optimization_levelsdestdirrcCs(||_||_||_||_||_||_dS)aConstruct a ``SchemeDictionaryDestination`` object. :param scheme_dict: a mapping of {scheme: file-system-path} :param interpreter: the interpreter to use for generating scripts :param script_kind: the "kind" of launcher script to use :param hash_algorithm: the hashing algorithm to use, which is a member of :any:`hashlib.algorithms_available` (ideally from :any:`hashlib.algorithms_guaranteed`). :param bytecode_optimization_levels: Compile cached bytecode for installed .py files with these optimization levels. The bytecode is specific to the minor version of Python (e.g. 3.10) used to generate it. :param destdir: A staging directory in which to write all files. This is expected to be the filesystem root at runtime, so embedded paths will be written as though this was the root. N)r3r4r5r6r7r8)rr3r4r5r6r7r8rrr __init__ks  z$SchemeDictionaryDestination.__init__r"r#cCsFtj|j||}|jdur!t|}||j}tj|j|S|S)N)osr#joinr3r8r relative_toanchor)rr"r#file file_pathrel_pathrrr _path_with_destdirs   z.SchemeDictionaryDestination._path_with_destdirr%r&c Cs|||}tj|rd|}t|tj|}tj|s&t|t|d}t|||j \} } Wdn1s?wY|rJt |t |t |j | | S)aWrite contents of ``stream`` to the correct location on the filesystem. :param scheme: scheme to write the file in (like "purelib", "platlib" etc). :param path: path within that scheme :param stream: contents of the file :param is_executable: whether the file should be made executable - Ensures that an existing file is not being overwritten. - Hashes the written content, to determine the entry in the ``RECORD`` file. zFile already exists: wbN) rAr:r#existsFileExistsErrordirnamemakedirsopenrr6rr r ) rr"r#r%r& target_pathmessage parent_folderfhash_sizerrr write_to_fss       z'SchemeDictionaryDestination.write_to_fsr$cCs^t|}|dkr't||j}|||||WdS1s"wY|||||S)aWrite a file to correct ``path`` within the ``scheme``. :param scheme: scheme to write the file in (like "purelib", "platlib" etc). :param path: path within that scheme :param stream: contents of the file :param is_executable: whether the file should be made executable - Changes the shebang for files in the "scripts" scheme. - Uses :py:meth:`SchemeDictionaryDestination.write_to_fs` for the filesystem interaction. scriptsN)r:fspathrr4rN)rr"r#r%r&path_stream_with_different_shebangrrr r's  z&SchemeDictionaryDestination.write_filerrrrrc Cst||||}||j|j\}}t|1}|jtd||dd} |td|} t | j } | | d@d?O} t | | | WdS1sJwYdS)aXWrite a script to invoke an entrypoint. :param name: name of the script :param module: module path, to load the entry point from :param attr: final attribute access, for the entry point :param section: Denotes the "entry point section" where this was specified. Valid values are ``"gui"`` and ``"console"``. :type section: str - Generates a launcher using :any:`Script.generate`. - Writes to the "scripts" scheme. - Uses :py:meth:`SchemeDictionaryDestination.write_to_fs` for the filesystem interaction. rOTr&i$N) r generater4r5ioBytesIOrNrrAr:statst_modechmod) rrrrrscript script_namedatar%entryr#moderrr r!s    $z(SchemeDictionaryDestination.write_scriptrecordcCsZ|dvrdS|||j}tjtj|j||j}|jD] }tj||d|dqdS)z'Compile bytecode for a single .py file.)purelibplatlibN)optimizequietddir) rAr#r:rEr;r3r7 compileall compile_file)rr"r`rHdir_path_to_embedlevelrrr _compile_bytecodes z-SchemeDictionaryDestination._compile_bytecoder(r)cs~dtdttffdd }t|}t||}j||ddWdn1s+wY|D] \}|q2dS)a!Finalize installation, by writing the ``RECORD`` file & compiling bytecode. :param scheme: scheme to write the ``RECORD`` file in :param record_file_path: path of the ``RECORD`` file with that scheme :param records: entries to write to the ``RECORD`` file file_schemercs0|krdStjjj|jd}|dS)N)start/)r:r#relpathr3)rlr#r"rrr prefix_for_scheme szLSchemeDictionaryDestination.finalize_installation..prefix_for_schemeFrSN)r/rlistrrNrk)rr"r(r)rq record_list record_streamr`rrpr r*s   z1SchemeDictionaryDestination.finalize_installation)r2rN)r+r,r-r.rr/rintrr9rrArr0r rNr r'r!rkrr r*rrrr r1hs    "    r1)r.rgrVr:pathlibrtypingrrrrrrr r installer.recordsr r installer.scriptsr installer.utilsrrrrrrrrr1rrrr s ( H