+ VBi'Rt^RIt^RIt^RIt^RIHt^RIHtHtH t H t H t H t H t Ht^RIHtHt^RIHt^RIHtHtHtHtHt]'d ^RIHtHt!RR 4t!R R ]4tR#) 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 ScriptSectioncZa]tRt^ toRtV3RlRltV3RlRltV3RlRltRtVt R #) 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. c 6<V^8dQhRS[RS[RS[RRRS[/#namemoduleattrsectionrreturnstrr )format __classdict__s";/usr/lib/python3.14/site-packages/installer/destinations.py __annotate__WheelDestination.__annotate__'s5"""!$",/":I" "c \h)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&&&&&r# write_scriptWheelDestination.write_script's ""!r&c L<V^8dQhRS[RS[S[R3,RS[RS[RS[/#rschemepathzos.PathLike[str]stream is_executablerrr r rboolr )r!r"s"r#r$r%:sH"""C++," "  "  "r&c \h)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/r0r1r2s&&&&&r# write_fileWheelDestination.write_file:s ,"!r&c V<V^8dQhRS[RS[RS[S[S[S[3,,RR/#rr/record_file_pathrecordsrNrr rr r )r!r"s"r#r$r%RsB""""% 345 "  "r&c \h)aeFinalize 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_installation&WheelDestination.finalize_installationRs &"!r&N) __name__ __module__ __qualname____firstlineno____doc__r+r6r>__static_attributes____classdictcell__r"s@r#rr s( ""&""0""r&rca]tRt^htoRtRV3RlRlltV3RlRltV3RlRltV3R lR ltV3R lR lt V3R lRlt V3RlRlt Rt Vt R#)SchemeDictionaryDestinationz>Destination, based on a mapping of {scheme: file-system-path}.Ncv<V^8dQhRS[S[S[3,RS[RRRS[RS[S[,RS[S[,RR /#) r scheme_dict interpreter script_kindrhash_algorithmbytecode_optimization_levelsdestdirrN)rr rintr)r!r"s"r#r$(SchemeDictionaryDestination.__annotate__ksa#s(^$    '1o # r&c NWnW nW0nW@nWPnW`nR#)a0Construct 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)rLrMrNrOrPrQ)r*rLrMrNrOrPrQs&&&&&&&r#__init__$SchemeDictionaryDestination.__init__ks'2'&&,,H) r&c,<V^8dQhRS[RS[RS[/#)rr/r0r)rr )r!r"s"r#r$rSs"ssr&c$\PPVPV,V4pVPeQ\ V4pVP VP4p\PPVPV4#V#)N)osr0joinrLrQr relative_toanchor)r*r/r0file file_pathrel_paths&&& r#_path_with_destdir.SchemeDictionaryDestination._path_with_destdirshww||D,,V4d; << #T I ,,Y-=-=>H77<< h7 7 r&c 8<V^8dQhRS[RS[RS[RS[RS[/#)rr/r0r1r2r)rr rr4r )r!r"s"r#r$rSsD I I I I I  I  Ir&c :VPW4p\PPV4'dRV 2p\ V4h\PP V4p\PPV4'g\P !V4\VR4;_uu_4p\W8VP4wrRRR4V'd \V4\V\VPX 4X 4# +'giLD;i)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) r`rYr0existsFileExistsErrordirnamemakedirsopenrrOrr r ) r*r/r0r1r2 target_pathmessage parent_folderfhash_sizes &&&&& r# write_to_fs'SchemeDictionaryDestination.write_to_fss"--f; 77>>+ & &-k];G!'* * 4 ww~~m,, KK & +t $ $26d>Q>QRKE%   -4d&9&95!A4HH % $s 5D  D c L<V^8dQhRS[RS[S[R3,RS[RS[RS[/#r.r3)r!r"s"r#r$rSsOFFFC++,F F  F  Fr&c \P!V4pVR8Xd;\W0P4;_uu_4pVP WWd4uuRRR4#VP WW44# +'giL";i)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)rYfspathrrMrp)r*r/r0r1r2path_stream_with_different_shebangs&&&&& r#r6&SchemeDictionaryDestination.write_filesg$ $ Y V%5%566:W''#@76 vEE 76s A** A: c 6<V^8dQhRS[RS[RS[RRRS[/#rr)r!r"s"r#r$rSs5!$,/:I r&c  \WW44pVPVPVP4wrg\P !V4;_uu_4pVP \R4WhRR7p VP\R4V4p \P!V 4Pp WR,^, ,p \P!W4V uuRRR4# +'giR#;i)aWrite 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. rtTr2i$N) r generaterMrNioBytesIOrprr`rYstatst_modechmod) r*rrrrscript script_namedatar1entryr0modes &&&&& r#r+(SchemeDictionaryDestination.write_scripts"d4"OOD,<,N>NO ZZ  $$y!;d%E**6)+.__annotate__ s  3 8C= r&c<VS8XdR#\PPSPV,SPS,R7pVR,#)N)start/)rYr0relpathrL)rr0r/r*s& r#prefix_for_schemeLSchemeDictionaryDestination.finalize_installation..prefix_for_scheme sMf$77??  -&&v.#D#: r&Fr{N)listrrpr)r*r/r:r;r record_list record_streamrsff&& r#r>1SchemeDictionaryDestination.finalize_installationsp  7m "; B Bm   (u  C *NFF  " "66 2* C Bs A(( A8 )rPrQrOrMrLrN)sha256r@N)rArBrCrDrErUr`rpr6r+rr>rFrGrHs@r#rJrJhsUH@ I IDFF8@  33r&rJ)rErr}rYpathlibrtypingrrrrrrr r installer.recordsr r installer.scriptsr installer.utilsrrrrrrrrrJr@r&r#rsY@    0$=E"E"Pt3"2t3r&