+ ,j1^RIHt^RIt^RIHt^RIHtHtHtH t H t ^RI H t ^RI Ht^RIHt^RIHt^R IHt^R IHtHt^R IHt!R R ]4t!RR4tR#)) annotationsN)Path)ListOptionalTypeLiteralIterable) TracebackType) MatchSpec)Channel) PackageName)Enum)PySparseRepoDataPyPackageFormatSelection)RepoDataRecordc]tRt^tRt]P t]Pt ]Pt ]Pt ]PtRtR#)PackageFormatSelectionzZ Enum that describes what to do if both a `.tar.bz2` and a `.conda` package is available. N)__name__ __module__ __qualname____firstlineno____doc__r OnlyTarBz2 ONLY_TAR_BZ2 OnlyConda ONLY_CONDA PreferConda PREFER_CONDAPreferCondaWithWhlPREFER_CONDA_WITH_WHLBothBOTH__static_attributes__r8lib/python3.14/site-packages/rattler/repo_data/sparse.pyrrsb,66L*33J,77L5GG $ ( (Dr%rcp]tRt^0tRtRRltRRlt]P3RRllt ]P3RR llt ]P3R R llt ]P3R R llt ]P3RRllt ]RRl4t]]P3RRll4t]RRl4tRRltRRltRRltRtR#)SparseRepoDataz A class to enable loading records from a `repodata.json` file on demand. Since most of the time you don't need all the records from the `repodata.json` this can help provide some significant speedups. c(V^8dQhRRRRRRRR/#) channelr subdirstrpathzos.PathLike[str] | strreturnNoner)formats"r& __annotate__SparseRepoData.__annotate__7s8MMMM% M  Mr%c \V\4'g$\R\V4P: R24h\V\ 4'g$\R\V4P: R24h\V\ \ 34'g$\R\V4P: R24h\VPV\ V44Vn R#)z6SparseRepoData constructor received unsupported type z for the `channel` parameterz for the `subdir` parameterz for the `path` parameterN) isinstancer TypeErrortyperr-rr_channel_sparse)selfr+r,r.s&&&&r&__init__SparseRepoData.__init__7s '7++M**--IK &#&&L)),,GI $d ,,J''**CE ((8(8&#d)L r%cV^8dQhRR/#)r*r/r0r)r1s"r&r2r3Ns  t r%c :VPP4R#)an Closes any mapped resources associated with this `SparseRepoData` instance. It is good practice to call this method when you are done with it. This is especially important if you want to modify or delete the file from which this instance was created. This method will release all resources associated with this instance, including those that are currently being used on another thread. This method will block until all resources are released. This method has no effect if the file is already closed. Once the instance is closed, any operation on the instance will raise a `ValueError`. As a convenience, it is allowed to call this method more than once; only the first call, however, will have an effect. Examples -------- ```python >>> from rattler import Channel, ChannelConfig >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> sparse_data.close() >>> sparse_data.package_names() # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ValueError: I/O operation on closed file. >>> ``` N)r9closer:s&r&r?SparseRepoData.closeNs@ r%c V^8dQhRRRR/#)r*package_format_selectionrr/z List[str]r)r1s"r&r2r3ps JJ(>J Jr%c LVPPVP4#)aA Returns a list over all package names in this repodata file. This works by iterating over all elements in the `packages` and `conda_packages` fields of the repodata and returning the unique package names. Examples -------- ```python >>> from rattler import Channel, ChannelConfig >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> package_names = sparse_data.package_names() >>> package_names [...] >>> isinstance(package_names[0], str) True >>> ``` )r9 package_namesvaluer:rCs&&r&rESparseRepoData.package_namesps 0||))*B*H*HIIr%c V^8dQhRRRR/#)r*rCrr/intr)r1s"r&r2r3s II(>I Ir%c LVPPVP4#)zF Returns the total number of packages in this repodata file. :return: )r9 record_countrFrGs&&r&rLSparseRepoData.record_counts ||(()A)G)GHHr%c$V^8dQhRRRRRR/#)r* package_namezstr | PackageNamerCrr/List[RepoDataRecord]r)r1s"r&r2r3s(  ' #9    r%c \V\4'g \V4pVPPVPVP 4Uu.uFp\ P!V4NK up#uupi)a  Returns all the records for the specified package name. Examples -------- ```python >>> from rattler import Channel, ChannelConfig, RepoDataRecord, PackageName >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> package_name = PackageName(sparse_data.package_names()[0]) >>> records = sparse_data.load_records(package_name) >>> records [...] >>> isinstance(records[0], RepoDataRecord) True >>> ``` )r5r r9 load_records_namerFr_from_py_record)r:rOrCrecords&&& r&rRSparseRepoData.load_recordssk0, 44&|4L,,33L4F4FH`HfHfg g  * *6 2g   sA6c V^8dQhRRRR/#)r*rCrr/rPr)r1s"r&r2r3s  (>  r%c VPPVP4Uu.uFp\P!V4NK up#uupi)a Returns all the records for the specified package name. Examples -------- ```python >>> from rattler import Channel, ChannelConfig, RepoDataRecord, PackageName >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> records = sparse_data.load_all_records() >>> records [...] >>> isinstance(records[0], RepoDataRecord) True >>> ``` )r9load_all_recordsrFrrT)r:rCrUs&& r&rYSparseRepoData.load_all_recordssJ0,,778P8V8VW W  * *6 2W   sA c$V^8dQhRRRRRR/#)r*specszIterable[MatchSpec]rCrr/rPr)r1s"r&r2r3s(  " #9    r%c VPPVUu.uFq3PNK upVP4Uu.uFp\P !V4NK up#uupiuupi)a Returns all the records that match any of the specified MatchSpecs. Examples -------- ```python >>> from rattler import Channel, ChannelConfig, RepoDataRecord, PackageName >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> [record.file_name for record in sparse_data.load_matching_records([MatchSpec("cuda-version 12.5")])] ['cuda-version-12.5-hd4f0392_3.conda'] >>> ``` )r9load_matching_records _match_specrFrrT)r:r\rCspecrUs&&& r&r^$SparseRepoData.load_matching_recordssk,,,<<.34ed!!e46N6T6T   * *6 2  5 s A$A)cV^8dQhRR/#r*r/r-r)r1s"r&r2r3s###r%c .VPP#)aa Returns the subdirectory from which this repodata was loaded. Examples -------- ```python >>> from rattler import Channel, ChannelConfig >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> sparse_data.subdir 'linux-64' >>> ``` )r9r,r@s&r&r,SparseRepoData.subdirs"||"""r%c(V^8dQhRRRRRRRR/#) r* repo_datazList[SparseRepoData]rEzList[PackageName]rCrr/zList[List[RepoDataRecord]]r)r1s"r&r2r3s0  ' ( #9  $  r%c  @\P!VUu.uFq3PNK upVUu.uFqDPNK upVP4UUu.uF)pVUu.uFp\ P !V4NK upNK+ upp#uupiuupiuupiuuppi)a Given a set of [`SparseRepoData`]s load all the records for the packages with the specified names and all the packages these records depend on. This will parse the records for the specified packages as well as all the packages these records depend on. Examples -------- ```python >>> from rattler import Channel, ChannelConfig, PackageName >>> channel = Channel("dummy") >>> subdir = "test-data/dummy/linux-64" >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> package_name = PackageName("python") >>> SparseRepoData.load_records_recursive([sparse_data], [package_name]) [...] >>> ``` )rload_records_recursiver9rSrFrrT)rgrErCrplist_of_recordsrUs&&& r&ri%SparseRepoData.load_records_recursives:$4#J#J$-.IqI.-0P-Q-0PRjRpRp$ $CR R/^ + +F 3/ R$  /0P S s"B B  B!B BBc V^8dQhRRRR/#)r*py_sparse_repo_datarr/r(r)r1s"r&r2r3s  >> from rattler import Channel, ChannelConfig >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> sparse_data = SparseRepoData(channel, "linux-64", path) >>> sparse_data SparseRepoData(subdir="linux-64") >>> ``` zSparseRepoData(subdir="z"))r,r@s&r&__repr__SparseRepoData.__repr__&s ) R88r%cV^8dQhRR/#)r*r/r(r)r1s"r&r2r38s>r%c V#)a Returns the `SparseRepoData` instance itself. This is used to enable the use of the `with` statement to automatically close the instance when done. Examples -------- ```python >>> from rattler import Channel, ChannelConfig >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> with SparseRepoData(channel, "linux-64", path) as sparse_data: ... print(sparse_data) ... SparseRepoData(subdir="linux-64") >>> ``` rr@s&r& __enter__SparseRepoData.__enter__8s & r%c(V^8dQhRRRRRRRR/#) r*exctypezOptional[Type[BaseException]]excinstzOptional[BaseException]exctbzOptional[TracebackType]r/zLiteral[False]r)r1s"r&r2r3Ms2.)'   r%c &VP4R#)a Closes the `SparseRepoData` instance when exiting the `with` statement. Examples -------- ```python >>> from rattler import Channel, ChannelConfig >>> channel = Channel("dummy", ChannelConfig()) >>> path = "../test-data/channels/dummy/linux-64/repodata.json" >>> with SparseRepoData(channel, "linux-64", path) as sparse_data: ... print(sparse_data) ... SparseRepoData(subdir="linux-64") >>> ``` F)r?)r:rrrs&&&&r&__exit__SparseRepoData.__exit__Ms, r%)r9N)rrrrrr;r?rrrErLrRrYr^propertyr, staticmethodri classmethodrtrxr|rr$rr%r&r(r(0s M. FBXAdAdJ6BXAdAdIrsB" ::3+4F3T@ttr%