+ ,j0^RIHt^RIt^RIHtHtHtHt^RIH t ^RI H t ^RI H t ^RIHt^RIHt^R IHt]!R R ]44tRR R lltR#)) annotationsN)ListOptionalProtocolruntime_checkable) MatchSpec)Client)Platform) PrefixRecord)RepoDataRecord) py_installc]tRt^tRtRRltRRltRRltRR ltR R lt R R lt RRlt RRlt RRlt RRltRRltRRltRRltRRltRRltR R!ltR"R#ltR$R%ltR&R'ltR(tR)#)*InstallerReporterun Protocol for custom installation progress reporters. Implement this protocol (by subclassing or structurally) and override the methods we care about to receive progress callbacks during package installation. All methods have no-op defaults so we only need to implement the ones relevant to our use case. Methods that return an ``int`` act as opaque tokens: the value we return will be passed back to the corresponding ``*_complete`` callback so we can correlate start/finish events. Example ------- ```python from rattler.install import InstallerReporter class MyReporter: # no need to inherit — structural subtyping is sufficient def on_transaction_start(self, total_operations: int) -> None: print(f"Starting installation of {total_operations} operations") def on_download_progress( self, download_idx: int, progress: int, total: int | None, ) -> None: pct = f"{progress}/{total}" if total else str(progress) print(f" downloading [{download_idx}]: {pct} bytes") def on_transaction_complete(self) -> None: print("Installation complete!") ``` c V^8dQhRRRR/#)total_operationsintreturnNone)formats"9lib/python3.14/site-packages/rattler/install/installer.py __annotate__InstallerReporter.__annotate__3s  S T c R#)zCalled once when the installation transaction begins. Parameters ---------- total_operations: The total number of install/unlink operations in this transaction. Nr)selfrs&&ron_transaction_start&InstallerReporter.on_transaction_start3rc V^8dQhRRRR/#r operationrrrr)rs"rrr<s    rc R#)zCalled when a single transaction operation starts. Parameters ---------- operation: Index of the operation within the transaction. Nrrr#s&&ron_transaction_operation_start0InstallerReporter.on_transaction_operation_start<r rc$V^8dQhRRRRRR/#rr#r package_namestrrr)rs"rrrEs!CCrc ^#)a5Called when rattler begins populating the local cache for a package. Parameters ---------- operation: Index of the operation within the transaction. package_name: Normalised name of the package being cached. Returns ------- int An opaque token passed back to :meth:`on_populate_cache_complete`. rrr#r*s&&&ron_populate_cache_start)InstallerReporter.on_populate_cache_startErc V^8dQhRRRR/#r cache_entryrrr)rs"rrrVs  S S rc ^#)zCalled when cache-entry validation begins. Parameters ---------- cache_entry: Token returned by :meth:`on_populate_cache_start`. Returns ------- int An opaque token passed back to :meth:`on_validate_complete`. rrr3s&&ron_validate_start#InstallerReporter.on_validate_startVsrc V^8dQhRRRR/#)r validate_idxrrrr)rs"rrres    rc R#)zCalled when cache-entry validation finishes. Parameters ---------- validate_idx: Token returned by :meth:`on_validate_start`. Nr)rr9s&&ron_validate_complete&InstallerReporter.on_validate_completeer rc V^8dQhRRRR/#r2r)rs"rrrnsSSrc ^#)aCalled just before a package download begins. Parameters ---------- cache_entry: Token returned by :meth:`on_populate_cache_start`. Returns ------- int An opaque token passed to :meth:`on_download_progress` and :meth:`on_download_completed`. rr5s&&ron_download_start#InstallerReporter.on_download_startnsrc(V^8dQhRRRRRRRR/#)r download_idxrprogresstotalz Optional[int]rrr)rs"rrr~s)       M  ^b  rc R#)zCalled periodically with download byte progress. Parameters ---------- download_idx: Token returned by :meth:`on_download_start`. progress: Bytes downloaded so far. total: Total expected bytes, or ``None`` if unknown. Nr)rrBrCrDs&&&&ron_download_progress&InstallerReporter.on_download_progress~r rc V^8dQhRRRR/#)rrBrrrr)rs"rrrs  # $ rc R#)zwCalled when a download finishes. Parameters ---------- download_idx: Token returned by :meth:`on_download_start`. Nr)rrBs&&ron_download_completed'InstallerReporter.on_download_completedr rc V^8dQhRRRR/#)rr3rrrr)rs"rrrs  c d rc R#)zCalled when the cache has been fully populated for a package. Parameters ---------- cache_entry: Token returned by :meth:`on_populate_cache_start`. Nrr5s&&ron_populate_cache_complete,InstallerReporter.on_populate_cache_completer rc$V^8dQhRRRRRR/#r)r)rs"rrrs!CCrc ^#)a%Called when rattler begins unlinking (removing) a package. Parameters ---------- operation: Index of the operation within the transaction. package_name: Normalised name of the package being unlinked. Returns ------- int An opaque token passed back to :meth:`on_unlink_complete`. rr-s&&&ron_unlink_start!InstallerReporter.on_unlink_startr0rc V^8dQhRRRR/#rindexrrrr)rs"rrrs    rc R#)z|Called when a package has been fully unlinked. Parameters ---------- index: Token returned by :meth:`on_unlink_start`. NrrrVs&&ron_unlink_complete$InstallerReporter.on_unlink_completer rc$V^8dQhRRRRRR/#r)r)rs"rrrs!s##rc ^#)a!Called when rattler begins linking (installing) a package. Parameters ---------- operation: Index of the operation within the transaction. package_name: Normalised name of the package being linked. Returns ------- int An opaque token passed back to :meth:`on_link_complete`. rr-s&&&r on_link_startInstallerReporter.on_link_startr0rc V^8dQhRRRR/#rUr)rs"rrrs  c d rc R#)zCalled when a package has been fully linked into the prefix. Parameters ---------- index: Token returned by :meth:`on_link_start`. NrrXs&&ron_link_complete"InstallerReporter.on_link_completer rc V^8dQhRRRR/#r"r)rs"rrrs  3 4 rc R#)zCalled when a single transaction operation finishes. Parameters ---------- operation: Index of the operation within the transaction. Nrr%s&&r!on_transaction_operation_complete3InstallerReporter.on_transaction_operation_completer rcV^8dQhRR/#)rrrr)rs"rrrsDDDrc R#)z5Called once when the entire transaction has finished.Nr)rs&ron_transaction_complete)InstallerReporter.on_transaction_completer rc$V^8dQhRRRRRR/#rr*r+ script_pathrrr)rs"rrrs!src ^#)a(Called when a post-link script begins execution. Parameters ---------- package_name: Name of the package whose post-link script is running. script_path: Relative path to the script within the prefix. Returns ------- int An opaque token passed back to :meth:`on_post_link_complete`. rrr*rms&&&ron_post_link_start$InstallerReporter.on_post_link_startr0rc$V^8dQhRRRRRR/#rrVrsuccessboolrrr)rs"rrrs!   3    $  rc R#)zCalled when a post-link script finishes. Parameters ---------- index: Token returned by :meth:`on_post_link_start`. success: ``True`` if the script exited successfully. NrrrVrts&&&ron_post_link_complete'InstallerReporter.on_post_link_completer rc$V^8dQhRRRRRR/#rlr)rs"rrrs!##rc ^#)a+Called when a pre-unlink script begins execution. Parameters ---------- package_name: Name of the package whose pre-unlink script is running. script_path: Relative path to the script within the prefix. Returns ------- int An opaque token passed back to :meth:`on_pre_unlink_complete`. rros&&&ron_pre_unlink_start%InstallerReporter.on_pre_unlink_startr0rc$V^8dQhRRRRRR/#rsr)rs"rrr s!   C  $  4  rc R#)zCalled when a pre-unlink script finishes. Parameters ---------- index: Token returned by :meth:`on_pre_unlink_start`. success: ``True`` if the script exited successfully. Nrrws&&&ron_pre_unlink_complete(InstallerReporter.on_pre_unlink_complete r rrN)__name__ __module__ __qualname____firstlineno____doc__rr&r.r6r;r?rFrJrNrRrYr]rarerirprxr|r__static_attributes__rrrrrsm!F  "      " "  D"  "   rrcLV^8dQhRRRRRRRRR R R R R R RRRRRRRRRRRR/ #)rrecordszList[RepoDataRecord] target_prefixzstr | os.PathLike[str] cache_dirzOptional[os.PathLike[str]]installed_packageszOptional[List[PrefixRecord]]reinstall_packageszOptional[set[str]]ignored_packagesplatformzOptional[Platform]execute_link_scriptsru show_progressclientzOptional[Client]requested_specszOptional[List[MatchSpec]]reporterzOptional[InstallerReporter]rrr)rs"rrrsXX !X)X*X5 X + X ) X!XXX X/X*X Xrc "\T\V4TTTTVe VPMRV e V PMRVVV V R7 GRjxL R#L5i)a_ Create an environment by downloading and linking the `dependencies` in the `target_prefix` directory. !!! warning When `execute_link_scripts` is set to `True` the post-link and pre-unlink scripts of packages will be executed. These scripts are not sandboxed and can be used to execute arbitrary code. It is therefor discouraged to enable executing link scripts. Example ------- ```python >>> import asyncio >>> from rattler import solve, install >>> from tempfile import TemporaryDirectory >>> temp_dir = TemporaryDirectory() >>> >>> async def main(): ... # Solve an environment with python 3.9 for the current platform ... records = await solve(sources=["conda-forge"], specs=["python 3.9.*"]) ... ... # Link the environment in a temporary directory (you can pass any kind of path here). ... await install(records, target_prefix=temp_dir.name) ... ... # That's it! The environment is now created. ... # You will find Python under `f"{temp_dir.name}/bin/python"` or `f"{temp_dir.name}/python.exe"` on Windows. >>> asyncio.run(main()) ``` Arguments: records: A list of solved `RepoDataRecord`s. target_prefix: Path to the directory where the environment should be created. cache_dir: Path to directory where the dependencies will be downloaded and cached. installed_packages: A list of `PrefixRecord`s which are already installed in the `target_prefix`. This can be obtained by loading `PrefixRecord`s from `{target_prefix}/conda-meta/`. If `None` is specified then the `target_prefix` will be scanned for installed packages. reinstall_packages: A list of package names that should be reinstalled. ignored_packages: A list of package names that should be ignored (left untouched). These packages will not be removed, installed, or updated. platform: Target platform to create and link the environment. Defaults to current platform. execute_link_scripts: whether to execute the post-link and pre-unlink scripts that may be part of a package. Defaults to False. show_progress: If set to `True` a progress bar will be shown on the CLI. Ignored when `reporter` is provided. client: An authenticated client to use for downloading packages. If not specified a default client will be used. requested_specs: A list of `MatchSpec`s that were originally requested. These will be used to populate the `requested_specs` field in the generated `conda-meta/*.json` files. If `None`, the `requested_specs` field will remain empty. reporter: An optional :class:`InstallerReporter` instance that receives progress callbacks during installation. When provided, `show_progress` is ignored. Subclass :class:`InstallerReporter` and override the methods you need. N) rrrrrrrrrrrr)r r+_inner_client) rrrrrrrrrrrrs &&&&&&&&&&&&rinstallrsYV -(--)$,$8d!'!3v~~1#'   sAAA A) NNNNNFTNNN) __future__rostypingrrrrrattler.match_specrrattler.networking.clientr rattler.platform.platformr rattler.prefix.prefix_recordr rattler.repo_data.recordr rattler.rattlerr rrrrrrsN" >>(,.53&D D D NXXr