: DdZddlZddlZddlZddlmZddlmZmZm Z m Z m Z m Z m Z mZddlmZmZddlmZddlmZmZmZmZmZerddlmZmZGd d ZGd d eZy) 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 zeZdZdZdedededddef dZd ed eed fd e d e def dZ d edede e eefddfdZy)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. namemoduleattrsectionrreturnct)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)selfrrrrs ;/usr/lib/python3.12/site-packages/installer/destinations.py write_scriptzWheelDestination.write_script's ""!schemepathos.PathLike[str]stream is_executablect)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)r r$r%r'r(s r! write_filezWheelDestination.write_file:s ,"!r#record_file_pathrecordsNct)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)r r$r+r,s r!finalize_installationz&WheelDestination.finalize_installationRs &"!r#)__name__ __module__ __qualname____doc__strr r"rr rboolr*rr r.r#r!rr s ""!$",/":I" "&""C++," "  "  "0"""% 345 "  "r#rceZdZdZ ddeeefdedddedeed eed dfd Z d e d ed efdZ d e d ede de d ef dZd e d eedfde de d ef dZdedededdd ef dZd e ded dfdZd e dedeee efd dfdZy) SchemeDictionaryDestinationz>Destination, based on a mapping of {scheme: file-system-path}.N scheme_dict interpreter script_kindrhash_algorithmbytecode_optimization_levelsdestdirrcX||_||_||_||_||_||_y)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)r8r9r:r;r<r=)r r8r9r:r;r<r=s r!__init__z$SchemeDictionaryDestination.__init__ks32'&&,,H) r#r$r%ctjj|j||}|jPt |}|j |j}tjj|j|S|S)N)osr%joinr8r=r relative_toanchor)r r$r%file file_pathrel_paths r!_path_with_destdirz.SchemeDictionaryDestination._path_with_destdirshww||D,,V4d; << #T I ,,Y-=-=>H77<< h7 7 r#r'r(c|j||}tjj|rd|}t |tjj |}tjj|stj |t|d5}t|||j\} } ddd|r t|t|t|j  S#1swY7xYw)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) rHrAr%existsFileExistsErrordirnamemakedirsopenrr;rr r ) r r$r%r'r( target_pathmessage parent_folderfhash_sizes r! write_to_fsz'SchemeDictionaryDestination.write_to_fss"--fd; 77>>+ &-k];G!'* * 4 ww~~m, KK & +t $261d>Q>QRKE4%   -4d&9&95!A4HH % $s !C22C;r&ctj|}|dk(r4t||j5}|j ||||cdddS|j ||||S#1swYxYw)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)rAfspathrr9rV)r r$r%r'r(path_stream_with_different_shebangs r!r*z&SchemeDictionaryDestination.write_filesn$ $ Y VT%5%56:W''E#@-76 v}EE 76s A##A,rrrrrct||||}|j|j|j\}}t j |5}|j td||d} |jtd|} tj| j} | | dzdz z} tj| | | cdddS#1swYyxYw)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. rXTr(i$N) rgenerater9r:ioBytesIOrVrrHrAstatst_modechmod) r rrrrscript script_namedatar'entryr%modes r!r"z(SchemeDictionaryDestination.write_scripts"fdG4"OOD,<,N>NO T ZZ $$y!;d%E**6)+.prefix_for_scheme sMf$77??  -&&v.#D#: r#Fr]N)r3r listrrVrv)r r$r+r,r} record_list record_streamrjs`` r!r.z1SchemeDictionaryDestination.finalize_installations 3 8C= 7m ";0A Bm   (-u  C *NFF  " "66 2* C Bs A//A8)sha256r5N)r/r0r1r2rr3rintr r?rrHrr4r rVr r*r"rvrr r.r5r#r!r7r7hsH'8:!%#s(^$    '1o # @ss I I I I  I  IDFFC++,F F  F  F8!$,/:I @    333% 345 3  3r#r7)r2rrr`rApathlibrtypingrrrrrr r r installer.recordsr r installer.scriptsrinstaller.utilsrrrrrrrrr7r5r#r!rsY@    0$=E"E"Pt3"2t3r#