py-rattler 0.11.0__cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl → 0.13.0__cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

{py_rattler-0.11.0.dist-info → py_rattler-0.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-rattler
-Version: 0.11.0
+Version: 0.13.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
@@ -48,7 +48,7 @@ Project-URL: Issues, https://github.com/conda/rattler/labels/python-bindings
 [pixi-badge]:https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json&style=flat-square
 [pixi-url]: https://pixi.sh
 
-Rattler is a library that provides common functionality used within the conda ecosystem ([what is conda & conda-forge?](#what-is-conda-conda-forge)).
+Rattler is a library that provides common functionality used within the conda ecosystem ([what is conda & conda-forge?](#what-is-conda--conda-forge)).
 The goal of the library is to enable programs and other libraries to easily interact with the conda ecosystem without being dependent on Python.
 Its primary use case is as a library that you can use to provide conda related workflows in your own tools.
 

{py_rattler-0.11.0.dist-info → py_rattler-0.13.0.dist-info}/RECORD

@@ -1,62 +1,62 @@
-py_rattler-0.11.0.dist-info/METADATA,sha256=Vc8gdxyPOALNF_tAnjDiNPGhuKL8Vw5wsDzbtIfP8m8,7909
-py_rattler-0.11.0.dist-info/WHEEL,sha256=3TinPYnt4CFOqWAu30MbbZRMdVq42rDXuvLp9oRb4Ew,129
+py_rattler-0.13.0.dist-info/METADATA,sha256=3xOCT83hJXxwLyufYzc5J3Vujj7idN3qQ-KxNzy1PH0,7910
+py_rattler-0.13.0.dist-info/WHEEL,sha256=3TinPYnt4CFOqWAu30MbbZRMdVq42rDXuvLp9oRb4Ew,129
+rattler/package_streaming/__init__.py,sha256=I-mbr0sJnHzdFQP8v0Yb_GKpu4bIO3JbAJtq_wzA71Q,898
 rattler/solver/__init__.py,sha256=NZabrelb_pcqOi5PyZTr3OeBbjd85IqW1-2ymOBO-k0,119
-rattler/solver/solver.py,sha256=5T6izd_cOhwIAwlreJIUgqXpyTOCxOgW0Ll786Q6NqM,10922
-rattler/explicit_environment/environment.py,sha256=Dqcvm5c7C3K0FJ04YVN8WIUrl0R8Fe2TeXZ4Qq8Dg-0,2641
+rattler/solver/solver.py,sha256=EEF86vA-ryVuBmq5uOomgzPq1BGXsNcAhJvf7JKVVDQ,11259
 rattler/explicit_environment/__init__.py,sha256=QHmwZkdVt-tFL-tEEdhLdH3apuI5F7ElpMzCRZeH3_o,170
-rattler/package/no_arch_type.py,sha256=NnH4s1j9E0JrZTEeDayGssVpcpbY2i-66_0N9UJa328,3684
-rattler/package/run_exports_json.py,sha256=DNGoylVj5huRG8g0a1KtG1OQYJdSrkRb8ZMZZa8HGCk,9304
-rattler/package/paths_json.py,sha256=DzEKrKdZa17f1jiAuO59Bt9Ny4dS2i11tsCfnQvr3Ho,21448
-rattler/package/about_json.py,sha256=D61slvy2aYxlU2BF30DMc6nNhB0Wy54tpxp-l9QDVqY,8952
-rattler/package/__init__.py,sha256=2miuQoS1eNvgxQQvDJcU5h4W5tjRtBuu1u2yU5rnWcg,518
-rattler/package/index_json.py,sha256=D4HvKPN7cFHTmANFbzuueGFMQIwQrjIfcUAlgkL7FbE,12418
-rattler/package/package_name.py,sha256=bX5CpTwyWOOuUlrejHmbJzz1R0KcchtWHLskOfA-Dlk,4426
-rattler/prefix/prefix_paths.py,sha256=Ausp9xbZTUbsbjZJxCpTUuitcUhnr1DAgawHAyiVFh0,12819
-rattler/prefix/prefix_record.py,sha256=gaNcBp-enw_uMuZmZDC8nlEzk4dR6s8v0LsF7w6wVto,5866
-rattler/prefix/__init__.py,sha256=fm0eLuHmqO4pX8T2G9GKeZanknh2B5NeppySqLEg_7Q,221
-rattler/exceptions.py,sha256=2ivs3zwllwQwn1InBiArbrZbTzPXpssv7fzZkGdRpnI,4059
-rattler/package_streaming/__init__.py,sha256=I-mbr0sJnHzdFQP8v0Yb_GKpu4bIO3JbAJtq_wzA71Q,898
-rattler/install/installer.py,sha256=akUuojDLiP5jcd1vbX__xLjBg2B46sFNSKk4RBYjvIc,3559
-rattler/install/__init__.py,sha256=F_DwKOql1YkdV78JV5jT0RglNhs2ZwSup9uWGv9wO4I,69
-rattler/shell/shell.py,sha256=n9bAb0YQpdiOB62nFUIuWDoAzXnKRi1Y-fHEW9wVIg4,4442
-rattler/shell/__init__.py,sha256=GW5Amfmw7ln9l4kBBZCelaJxYBP5xbk5NjdNLMZhNMU,179
-rattler/match_spec/nameless_match_spec.py,sha256=f4P44Im6CL_yq7rcSE2XRfHRRSLZ1aAKVgrNggpzQ6c,4618
+rattler/explicit_environment/environment.py,sha256=Dqcvm5c7C3K0FJ04YVN8WIUrl0R8Fe2TeXZ4Qq8Dg-0,2641
 rattler/match_spec/__init__.py,sha256=uBV3ov1VlCIZlIWhkxxMPcTqRBF5p5lqvT2g6kQv5kQ,167
-rattler/match_spec/match_spec.py,sha256=fOxCH0mPLppOJ_weRB40R6Ft9ou4QwXuKPYIjlbezA8,8243
-rattler/networking/middleware.py,sha256=S1eArDWo45dKo8Um6mMYMOPs_OIdhLamejEQs8KorCQ,4838
-rattler/networking/client.py,sha256=rRmbeEQYO1afHDgjgSncq68hSkFpyZ1ktYgC_Q_7LBQ,1528
-rattler/networking/fetch_repo_data.py,sha256=sO3dDNdvJev6TOblnGEzpFYnY2xorfr5A5zrjsTDbWk,3714
-rattler/networking/__init__.py,sha256=Wlob5pywEgiqmAq8sVKyJS6qOpRegKemtcXTkwDED20,474
-rattler/virtual_package/generic.py,sha256=ztDVHLNbO2SemZSpdoa2SdoXcZT1hopvBFQ11fNBZmQ,4411
-rattler/virtual_package/virtual_package.py,sha256=nmqL2D2KV9rZzczurAvE5WgYqlBYWsbOzVRdYuMvqnM,6654
-rattler/virtual_package/__init__.py,sha256=pOvvD-8V6Ld5gYBj2KPI3-cZLx8m2hcl6dqRUoBTHuw,262
-rattler/platform/arch.py,sha256=7tanyDql5BvDvY9UryEXyTJ9nWRfx6bn7BWrl6fGEfI,1145
-rattler/platform/__init__.py,sha256=YZaXxnJmG_WjYbhIAxA0jQDhaPYAR4rTVQCm4yRoyZQ,154
-rattler/platform/platform.py,sha256=h6XVfjf5VtTmb35sjNB_1k0vretaHteJaCyOxmZWaHU,4323
-rattler/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rattler/utils/rattler_version.py,sha256=eXAVN6NYg5EmsQ_DrfgxW1yJ_eWAlWx7IANasMRYgV4,526
-rattler/channel/channel_priority.py,sha256=OQfCHp_DeInkMB0YahCf2X7yCk0_RtM_C_Vy4Ny-65M,474
-rattler/channel/channel.py,sha256=kGeZKa_YkSM943CA1i_8O1FXG9kS9hkrnmSl6OhkbbQ,2474
-rattler/channel/__init__.py,sha256=K-ZAo0qFzchXWP-6DpMHLg_djGD25-0CRwusisIGp8k,221
-rattler/channel/channel_config.py,sha256=rRD4dGeHTBIcm3vTuQR1wTGTELNdN69yq4lyCaTaN3M,1532
+rattler/match_spec/match_spec.py,sha256=fyrvd9VUURJyHaJDqNdzJNa3dZZpKLUmhjGVWtdGV4w,9525
+rattler/match_spec/nameless_match_spec.py,sha256=f4P44Im6CL_yq7rcSE2XRfHRRSLZ1aAKVgrNggpzQ6c,4618
+rattler/lock/lock_file.py,sha256=ZP-ElSJ7WKkqOE6rj4U6OmM63GLcDH_yTg1H_Qoa60E,3455
+rattler/lock/__init__.py,sha256=JkighOKfDQBqX3xrw1NXYlA_j1IFNI47_s6p2XvFtQc,571
 rattler/lock/package.py,sha256=C-lvnRWoRtj9CBRR2i5Eku_lFnBDI9Bf8vY57DWZ4YU,9035
 rattler/lock/hash.py,sha256=qNig1sf5EfRfaCK9x352DgqTpLdo75Gu4qvRZDbL33Q,805
-rattler/lock/lock_file.py,sha256=ZP-ElSJ7WKkqOE6rj4U6OmM63GLcDH_yTg1H_Qoa60E,3455
 rattler/lock/environment.py,sha256=sbcGqkb9rrGwpVCucDKkwdp2SFOyHZQGqvBArGEZFYs,7915
 rattler/lock/channel.py,sha256=PaLb-vWRLTJWUx7fyMdP2Tow5wMlGuq3WUrHkrQIzeg,1331
-rattler/lock/__init__.py,sha256=JkighOKfDQBqX3xrw1NXYlA_j1IFNI47_s6p2XvFtQc,571
-rattler/__init__.py,sha256=hbm0F5-1Q15xXfj8Ln1OaIq30BFGiryiD9GmU8XYrEc,2370
-rattler/index/__init__.py,sha256=Y-fiAzMcJSbL006dpALwGEhuMSTxuR1XC4o2gMqWcKA,87
-rattler/index/index.py,sha256=gpFHGuoQ-y4rY1i0vd_hDOiTYz5KtuInL-fFQvXj6bM,3795
-rattler/version/version.py,sha256=06are6AdWAEDQafi5RrB8ORH87CcmtjcmpOaMhEwdn0,15973
-rattler/version/with_source.py,sha256=nEW_jetdsB-5hKnxHVYgwOsd0EAe0fNKaCLlD4fIZiM,2539
-rattler/version/__init__.py,sha256=FQ_4xuCz_2tTPlIeSA_1SkPEP_DpuXw6tDDjsptMTZo,146
-rattler/repo_data/sparse.py,sha256=-XGT7vCAjKGdT0Ai7eF6Iff0N2dQRCYGAbxnFtGabko,6162
-rattler/repo_data/gateway.py,sha256=KOuSP8UwQDhOf-fL11iDRM8Kmol9-Dt5KWKV0UXB_oI,10111
-rattler/repo_data/package_record.py,sha256=CwOaRzhG25PQnw5wJ8m6GAZ6O-B87s3HE_SE_wPJxFs,27837
-rattler/repo_data/__init__.py,sha256=I7sC1bFPuXAUlb9gout2bGd1jYOPsHrsoDpSGniwpCk,495
+rattler/prefix/prefix_record.py,sha256=KWbjcBJO-KpdWz2VEYdlz_RPLpLByyaec0aViILi_EM,6290
+rattler/prefix/__init__.py,sha256=gkgyqZ0yTmxOCW8DHuSG-X0spEzb8BIoiox8YG50XYc,257
+rattler/prefix/prefix_paths.py,sha256=B0EwOFkVbSzuLChdjkjenTehfxjXwwMBIodSGOfBHFU,12828
+rattler/platform/arch.py,sha256=7tanyDql5BvDvY9UryEXyTJ9nWRfx6bn7BWrl6fGEfI,1145
+rattler/platform/__init__.py,sha256=YZaXxnJmG_WjYbhIAxA0jQDhaPYAR4rTVQCm4yRoyZQ,154
+rattler/platform/platform.py,sha256=H_P35Z0irNiyQX2fxX7ombMkGwyYa-Ow_iDIDxJrmG8,4395
+rattler/__init__.py,sha256=QKjBUll9mX4TVwJy-dy5Gt8IezLnJz8EPTlKhOsw2IA,2476
+rattler/repo_data/gateway.py,sha256=G9CTfz6Qc84Wo3QJSxWjsCH79WOohSxxUxYwKiss8ng,10141
+rattler/repo_data/sparse.py,sha256=qO3XuIfvcDEfo8mHu8UB9JBoz0IR3k_kNR32ZTpbPWU,12542
+rattler/repo_data/package_record.py,sha256=t8vxRsfAToIolhBRjt9lB4e5Q7Tm-FjZHUI9vhxd-eA,28358
+rattler/repo_data/__init__.py,sha256=cMoMtFOJBGonfWxizGphWpXdQ1GYXDXos7ESYigfco8,549
 rattler/repo_data/repo_data.py,sha256=lB7hQ1SN5b2VxuOaOH1BOFeIXbRUf2fslitLyT5aVwo,2264
 rattler/repo_data/patch_instructions.py,sha256=TNa7NgLtqGQ6lSpibLFxuPFwsmqRLrORpDZOpeZ5fnk,694
 rattler/repo_data/record.py,sha256=6CK2-KyvVZ8kaZ2l-o4DFWivxMJE_ChkOrm97bmIjn4,4572
-rattler/rattler.abi3.so,sha256=RJuPfx1G2jKFDhCx7c1qR0PtpYZg5GOBE5-AVi0qdWg,50889720
-py_rattler-0.11.0.dist-info/RECORD,,
+rattler/version/with_source.py,sha256=nEW_jetdsB-5hKnxHVYgwOsd0EAe0fNKaCLlD4fIZiM,2539
+rattler/version/version.py,sha256=06are6AdWAEDQafi5RrB8ORH87CcmtjcmpOaMhEwdn0,15973
+rattler/version/__init__.py,sha256=FQ_4xuCz_2tTPlIeSA_1SkPEP_DpuXw6tDDjsptMTZo,146
+rattler/exceptions.py,sha256=2ivs3zwllwQwn1InBiArbrZbTzPXpssv7fzZkGdRpnI,4059
+rattler/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rattler/shell/__init__.py,sha256=GW5Amfmw7ln9l4kBBZCelaJxYBP5xbk5NjdNLMZhNMU,179
+rattler/shell/shell.py,sha256=n9bAb0YQpdiOB62nFUIuWDoAzXnKRi1Y-fHEW9wVIg4,4442
+rattler/package/paths_json.py,sha256=7l2Wmqobwcoe-TStXhoafWzXCT4OWif_yAAa6KVnKyg,21465
+rattler/package/__init__.py,sha256=omXnLVICkiH7HiaUzpRWAaJxS955Uimm1pT8dejJgVU,624
+rattler/package/about_json.py,sha256=FElWUXFNeF1gQJXE6lmYNEdxQjhsuimVObIeqxn3y8M,8958
+rattler/package/run_exports_json.py,sha256=fZlM_H7IBuVi6lfL4SLsV_NDb22TgFhpCkxjm8YIvfg,9305
+rattler/package/index_json.py,sha256=BxnJg5SPpiFsLhabz-Uuvc4ea_sg4N7Q-hqdQnXk8oc,12419
+rattler/package/no_arch_type.py,sha256=y_1spiImY3654SDLRQWyp5mqr4l-gYKIuK4pCnEPj1s,3740
+rattler/package/package_name.py,sha256=bX5CpTwyWOOuUlrejHmbJzz1R0KcchtWHLskOfA-Dlk,4426
+rattler/install/__init__.py,sha256=F_DwKOql1YkdV78JV5jT0RglNhs2ZwSup9uWGv9wO4I,69
+rattler/install/installer.py,sha256=akUuojDLiP5jcd1vbX__xLjBg2B46sFNSKk4RBYjvIc,3559
+rattler/utils/rattler_version.py,sha256=eXAVN6NYg5EmsQ_DrfgxW1yJ_eWAlWx7IANasMRYgV4,526
+rattler/networking/__init__.py,sha256=Wlob5pywEgiqmAq8sVKyJS6qOpRegKemtcXTkwDED20,474
+rattler/networking/middleware.py,sha256=S1eArDWo45dKo8Um6mMYMOPs_OIdhLamejEQs8KorCQ,4838
+rattler/networking/client.py,sha256=rRmbeEQYO1afHDgjgSncq68hSkFpyZ1ktYgC_Q_7LBQ,1528
+rattler/networking/fetch_repo_data.py,sha256=sO3dDNdvJev6TOblnGEzpFYnY2xorfr5A5zrjsTDbWk,3714
+rattler/index/__init__.py,sha256=Y-fiAzMcJSbL006dpALwGEhuMSTxuR1XC4o2gMqWcKA,87
+rattler/index/index.py,sha256=jxm6v9gJtyg-AIizrpf0f5NOTMwA5SMvcbCL_HdnUG0,3725
+rattler/virtual_package/__init__.py,sha256=pOvvD-8V6Ld5gYBj2KPI3-cZLx8m2hcl6dqRUoBTHuw,262
+rattler/virtual_package/virtual_package.py,sha256=hrFvoT2LjIsW5ubfXdXEZnKlSIfLP5G4vrbJST9xukI,6707
+rattler/virtual_package/generic.py,sha256=ztDVHLNbO2SemZSpdoa2SdoXcZT1hopvBFQ11fNBZmQ,4411
+rattler/channel/__init__.py,sha256=K-ZAo0qFzchXWP-6DpMHLg_djGD25-0CRwusisIGp8k,221
+rattler/channel/channel_config.py,sha256=rRD4dGeHTBIcm3vTuQR1wTGTELNdN69yq4lyCaTaN3M,1532
+rattler/channel/channel_priority.py,sha256=OQfCHp_DeInkMB0YahCf2X7yCk0_RtM_C_Vy4Ny-65M,474
+rattler/channel/channel.py,sha256=kGeZKa_YkSM943CA1i_8O1FXG9kS9hkrnmSl6OhkbbQ,2474
+rattler/rattler.abi3.so,sha256=hLIA8TFIKaU895rMXqBo17_0VYahXU2n7I-C3NwYaaY,52561712
+py_rattler-0.13.0.dist-info/RECORD,,

rattler/__init__.py

@@ -8,6 +8,7 @@ from rattler.repo_data import (
     SparseRepoData,
     Gateway,
     SourceConfig,
+    PackageFormatSelection,
 )
 from rattler.channel import Channel, ChannelConfig, ChannelPriority
 from rattler.networking import Client, fetch_repo_data
@@ -22,9 +23,10 @@ from rattler.package import (
     PrefixPlaceholder,
     FileMode,
     IndexJson,
+    NoArchType,
+    NoArchLiteral,
 )
-from rattler.package.no_arch_type import NoArchType
-from rattler.prefix import PrefixRecord, PrefixPaths, PrefixPathsEntry, PrefixPathType
+from rattler.prefix import PrefixRecord, PrefixPaths, PrefixPathsEntry, PrefixPathType, Link, LinkType
 from rattler.platform import Platform
 from rattler.utils.rattler_version import get_rattler_version as _get_rattler_version
 from rattler.install import install
@@ -69,6 +71,7 @@ __all__ = [
     "PrefixPathsEntry",
     "PrefixPathType",
     "SparseRepoData",
+    "PackageFormatSelection",
     "LockFile",
     "Environment",
     "LockChannel",
@@ -94,4 +97,7 @@ __all__ = [
     "Gateway",
     "SourceConfig",
     "NoArchType",
+    "NoArchLiteral",
+    "Link",
+    "LinkType",
 ]

rattler/index/index.py

@@ -24,8 +24,8 @@ async def index_fs(
     Arguments:
         channel_directory: A `os.PathLike[str]` that is the directory containing subdirectories
                            of dependencies to index.
-        target_platform(optional): A `Platform` to index dependencies for.
-        repodata_patch(optional): The name of the conda package (expected to be in the `noarch` subdir) that should be used for repodata patching.
+        target_platform: A `Platform` to index dependencies for.
+        repodata_patch: The name of the conda package (expected to be in the `noarch` subdir) that should be used for repodata patching.
         force: Whether to forcefully re-index all subdirs.
         max_parallel: The maximum number of packages to process in-memory simultaneously.
     """
@@ -64,11 +64,11 @@ async def index_s3(
         region: The region of the S3 bucket.
         endpoint_url: The endpoint URL of the S3 bucket.
         force_path_style: Whether to use path-style addressing for S3.
-        access_key_id(optional): The access key ID to use for authentication.
-        secret_access_key(optional): The secret access key to use for authentication.
-        session_token(optional): The session token to use for authentication.
-        target_platform(optional): A `Platform` to index dependencies for.
-        repodata_patch(optional): The name of the conda package (expected to be in the `noarch` subdir) that should be used for repodata patching.
+        access_key_id: The access key ID to use for authentication.
+        secret_access_key: The secret access key to use for authentication.
+        session_token: The session token to use for authentication.
+        target_platform: A `Platform` to index dependencies for.
+        repodata_patch: The name of the conda package (expected to be in the `noarch` subdir) that should be used for repodata patching.
         force: Whether to forcefully re-index all subdirs.
         max_parallel: The maximum number of packages to process in-memory simultaneously.
     """

rattler/match_spec/match_spec.py

@@ -1,10 +1,10 @@
 from __future__ import annotations
-from typing import TYPE_CHECKING, Optional
-from rattler.channel.channel import Channel
 
-from rattler.rattler import PyMatchSpec
+from typing import TYPE_CHECKING, Optional
 
+from rattler.channel.channel import Channel
 from rattler.package.package_name import PackageName
+from rattler.rattler import PyMatchSpec
 
 if TYPE_CHECKING:
     from rattler.match_spec import NamelessMatchSpec
@@ -91,6 +91,8 @@ class MatchSpec:
         MatchSpec("pip >=24.0")
         >>> MatchSpec("pip 24")
         MatchSpec("pip ==24")
+        >>> MatchSpec('python[license=MIT]')
+        MatchSpec("python[license="MIT"]")
         >>>
         ```
         """
@@ -98,7 +100,7 @@ class MatchSpec:
             self._match_spec = PyMatchSpec(spec, strict)
         else:
             raise TypeError(
-                "MatchSpec constructor received unsupported type" f" {type(spec).__name__!r} for the 'spec' parameter"
+                f"MatchSpec constructor received unsupported type {type(spec).__name__!r} for the 'spec' parameter"
             )
 
     @property
@@ -207,6 +209,25 @@ class MatchSpec:
         """
         return cls._from_py_match_spec(PyMatchSpec.from_nameless(spec._nameless_match_spec, name))
 
+    @classmethod
+    def from_url(cls, url: str) -> MatchSpec:
+        """
+        Constructs a MatchSpec from a URL.
+
+        Examples
+        --------
+        ```python
+        >>> MatchSpec.from_url('https://repo.anaconda.com/pkgs/main/linux-64/python-3.9.0-h3.tar.bz2')
+        MatchSpec("python[url="https://repo.anaconda.com/pkgs/main/linux-64/python-3.9.0-h3.tar.bz2"]")
+        >>> MatchSpec.from_url('https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2#d7c89558ba9fa0495403155b64376d81')
+        MatchSpec("_libgcc_mutex[md5="d7c89558ba9fa0495403155b64376d81", url="https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2"]")
+        >>> MatchSpec.from_url('https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2#sha256:adfa71f158cbd872a36394c56c3568e6034aa55c623634b37a4836bd036e6b91')
+        MatchSpec("_libgcc_mutex[sha256="adfa71f158cbd872a36394c56c3568e6034aa55c623634b37a4836bd036e6b91", url="https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2"]")
+        >>>
+        ```
+        """
+        return cls._from_py_match_spec(PyMatchSpec.from_url(url))
+
     def __str__(self) -> str:
         """
         Returns a string representation of the MatchSpec.

rattler/package/__init__.py

@@ -9,6 +9,7 @@ from rattler.package.paths_json import (
     FileMode,
 )
 from rattler.package.index_json import IndexJson
+from rattler.package.no_arch_type import NoArchType, NoArchLiteral
 
 __all__ = [
     "PackageName",
@@ -20,4 +21,6 @@ __all__ = [
     "PrefixPlaceholder",
     "FileMode",
     "IndexJson",
+    "NoArchLiteral",
+    "NoArchType",
 ]

rattler/package/about_json.py

@@ -75,7 +75,7 @@ class AboutJson:
         return AboutJson._from_py_about_json(PyAboutJson.from_str(string))
 
     @staticmethod
-    def package_path() -> str:
+    def package_path() -> Path:
         """
         Returns the path to the file within the Conda archive.
 
@@ -85,7 +85,7 @@ class AboutJson:
         Examples
         --------
         ```python
-        >>> AboutJson.package_path()
+        >>> str(AboutJson.package_path())
         'info/about.json'
         >>>
         ```

rattler/package/index_json.py

@@ -68,7 +68,7 @@ class IndexJson:
         return IndexJson._from_py_index_json(PyIndexJson.from_str(string))
 
     @staticmethod
-    def package_path() -> str:
+    def package_path() -> Path:
         """
         Returns the path to the file within the Conda archive.
 

rattler/package/no_arch_type.py

@@ -1,23 +1,23 @@
 from __future__ import annotations
-from typing import Optional
+from typing import Literal, Optional
 
 from rattler.rattler import PyNoArchType
 
+NoArchLiteral = Optional[Literal["python", "generic", True]]
+
 
 class NoArchType:
     _noarch: PyNoArchType
 
-    def __init__(self, noarch: Optional[str] = None) -> None:
+    def __init__(self, noarch: NoArchLiteral = None) -> None:
         if noarch is None:
             self._noarch = PyNoArchType.none()
         elif noarch == "python":
             self._noarch = PyNoArchType.python()
-        elif noarch == "generic":
+        elif noarch == "generic" or noarch is True:
             self._noarch = PyNoArchType.generic()
         else:
-            raise ValueError(
-                "NoArchType constructor received unsupported value " f"{noarch} for the `noarch` parameter"
-            )
+            raise ValueError(f"NoArchType constructor received unsupported value {noarch} for the `noarch` parameter")
 
     @classmethod
     def _from_py_no_arch_type(cls, py_no_arch_type: PyNoArchType) -> NoArchType:

rattler/package/paths_json.py

@@ -82,7 +82,7 @@ class PathsJson:
         return PathsJson._from_py_paths_json(PyPathsJson.from_str(string))
 
     @staticmethod
-    def package_path() -> str:
+    def package_path() -> Path:
         """
         Returns the path to the file within the Conda archive.
 
@@ -224,7 +224,7 @@ class PathsEntry:
         ...     sha256=None,
         ...     size_in_bytes=None
         ... )
-        >>> entry.relative_path
+        >>> str(entry.relative_path)
         'lib/file.txt'
         >>> entry.no_link
         False
@@ -254,7 +254,7 @@ class PathsEntry:
         self._inner = PyPathsEntry(relative_path, no_link, path_type._inner, prefix_placeholder, sha256, size_in_bytes)
 
     @property
-    def relative_path(self) -> str:
+    def relative_path(self) -> Path:
         """
         The relative path from the root of the package.
 
@@ -265,10 +265,10 @@ class PathsEntry:
         ...     "../test-data/conda-22.9.0-py38haa244fe_2-paths.json"
         ... )
         >>> entry = paths_json.paths[0]
-        >>> entry.relative_path
+        >>> str(entry.relative_path)
         'Lib/site-packages/conda-22.9.0-py3.8.egg-info/PKG-INFO'
         >>> entry.relative_path = "new/path"
-        >>> entry.relative_path
+        >>> str(entry.relative_path)
         'new/path'
         >>>
         ```

rattler/package/run_exports_json.py

@@ -118,7 +118,7 @@ class RunExportsJson:
         return RunExportsJson._from_py_run_exports_json(PyRunExportsJson.from_str(string))
 
     @staticmethod
-    def package_path() -> str:
+    def package_path() -> Path:
         """
         Returns the path to the file within the Conda archive.
 

rattler/platform/platform.py

@@ -35,13 +35,15 @@ class PlatformSingleton(type):
         try:
             return cls._instances[platform]
         except KeyError:
-            instance = super().__call__(platform, *args, **kwargs)
-            cls._instances[platform] = instance
-            return instance
+            pass
+
+        instance = super().__call__(platform, *args, **kwargs)
+        cls._instances[platform] = instance
+        return instance
 
 
 class Platform(metaclass=PlatformSingleton):
-    def __init__(self, value: PlatformLiteral):
+    def __init__(self, value: PlatformLiteral | str):
         self._inner = PyPlatform(value)
 
     @classmethod
@@ -159,7 +161,7 @@ class Platform(metaclass=PlatformSingleton):
         return self._inner.is_unix
 
     @property
-    def arch(self) -> Arch:
+    def arch(self) -> Optional[Arch]:
         """
         Return the architecture of the platform.
 
@@ -173,7 +175,8 @@ class Platform(metaclass=PlatformSingleton):
         >>>
         ```
         """
-        return Arch._from_py_arch(self._inner.arch())
+        arch = self._inner.arch()
+        return Arch._from_py_arch(arch) if arch is not None else None
 
     @property
     def only_platform(self) -> Optional[str]:

rattler/prefix/__init__.py

@@ -1,4 +1,4 @@
-from rattler.prefix.prefix_record import PrefixRecord
+from rattler.prefix.prefix_record import PrefixRecord, Link, LinkType
 from rattler.prefix.prefix_paths import PrefixPaths, PrefixPathsEntry, PrefixPathType
 
-__all__ = ["PrefixRecord", "PrefixPaths", "PrefixPathsEntry", "PrefixPathType"]
+__all__ = ["PrefixRecord", "PrefixPaths", "PrefixPathsEntry", "PrefixPathType", "Link", "LinkType"]

rattler/prefix/prefix_paths.py

@@ -22,9 +22,9 @@ class PrefixPathType:
             "softlink",
             "directory",
             "pyc_file",
-            "windows_python_entrypoint_script",
-            "windows_python_entrypoint_exe",
-            "unix_python_entrypoint",
+            "windows_python_entry_point_script",
+            "windows_python_entry_point_exe",
+            "unix_python_entry_point",
         ],
     ) -> None:
         """
@@ -82,25 +82,25 @@ class PrefixPathType:
         return self._inner.pyc_file
 
     @property
-    def windows_python_entrypoint_script(self) -> bool:
+    def windows_python_entry_point_script(self) -> bool:
         """
         A Windows entry point python script (a <entrypoint>-script.py Python script file)
         """
-        return self._inner.windows_python_entrypoint_script
+        return self._inner.windows_python_entry_point_script
 
     @property
-    def windows_python_entrypoint_exe(self) -> bool:
+    def windows_python_entry_point_exe(self) -> bool:
         """
         A Windows entry point python script (a <entrypoint>.exe executable)
         """
-        return self._inner.windows_python_entrypoint_exe
+        return self._inner.windows_python_entry_point_exe
 
     @property
-    def unix_python_entrypoint(self) -> bool:
+    def unix_python_entry_point(self) -> bool:
         """
         A Unix entry point python script (a <entrypoint> Python script file)
         """
-        return self._inner.unix_python_entrypoint
+        return self._inner.unix_python_entry_point
 
 
 class PrefixPathsEntry(BasePathLike):

rattler/prefix/prefix_record.py

@@ -1,10 +1,26 @@
 from __future__ import annotations
 import os
+from enum import Enum
 from typing import List, Optional
 
-from rattler.rattler import PyRecord
+from rattler.rattler import PyRecord, PyLink
 from rattler.prefix.prefix_paths import PrefixPaths
 from rattler.repo_data.record import RepoDataRecord
+from pathlib import Path
+
+
+class LinkType(Enum):
+    HARDLINK = ("hardlink",)
+    COPY = ("copy",)
+    SOFTLINK = ("softlink",)
+    DIRECTORY = ("directory",)
+
+
+class Link:
+    _inner: PyLink
+
+    def __init__(self, path: os.PathLike[str], type: Optional[LinkType]) -> None:
+        self._inner = PyLink(path, type.value if type else None)
 
 
 class PrefixRecord(RepoDataRecord):
@@ -22,6 +38,7 @@ class PrefixRecord(RepoDataRecord):
         self,
         repodata_record: RepoDataRecord,
         paths_data: PrefixPaths,
+        link: Optional[Link] = None,
         package_tarball_full_path: Optional[os.PathLike[str]] = None,
         extracted_package_dir: Optional[os.PathLike[str]] = None,
         requested_spec: Optional[str] = None,
@@ -30,6 +47,7 @@ class PrefixRecord(RepoDataRecord):
         record = PyRecord.create_prefix_record(
             repodata_record._record,
             paths_data._paths,
+            link._inner if link else None,
             package_tarball_full_path,
             extracted_package_dir,
             requested_spec,
@@ -61,7 +79,7 @@ class PrefixRecord(RepoDataRecord):
         self._record.write_to_path(path, pretty)
 
     @property
-    def package_tarball_full_path(self) -> Optional[os.PathLike[str]]:
+    def package_tarball_full_path(self) -> Optional[Path]:
         """
         The path to where the archive of the package was stored on disk.
 
@@ -71,7 +89,7 @@ class PrefixRecord(RepoDataRecord):
         >>> r = PrefixRecord.from_path(
         ...     "../test-data/conda-meta/requests-2.28.2-pyhd8ed1ab_0.json"
         ... )
-        >>> r.package_tarball_full_path
+        >>> str(r.package_tarball_full_path)
         'C:\\\\Users\\\\bas\\\\micromamba\\\\pkgs\\\\requests-2.28.2-pyhd8ed1ab_0.tar.bz2'
         >>>
         ```
@@ -83,7 +101,7 @@ class PrefixRecord(RepoDataRecord):
         self._record.package_tarball_full_path = value
 
     @property
-    def extracted_package_dir(self) -> Optional[os.PathLike[str]]:
+    def extracted_package_dir(self) -> Optional[Path]:
         """
         The path that contains the extracted package content.
 
@@ -93,7 +111,7 @@ class PrefixRecord(RepoDataRecord):
         >>> r = PrefixRecord.from_path(
         ...     "../test-data/conda-meta/requests-2.28.2-pyhd8ed1ab_0.json"
         ... )
-        >>> r.extracted_package_dir
+        >>> str(r.extracted_package_dir)
         'C:\\\\Users\\\\bas\\\\micromamba\\\\pkgs\\\\requests-2.28.2-pyhd8ed1ab_0'
         >>>
         ```
@@ -105,7 +123,7 @@ class PrefixRecord(RepoDataRecord):
         self._record.extracted_package_dir = value
 
     @property
-    def files(self) -> List[os.PathLike[str]]:
+    def files(self) -> List[Path]:
         """
         A sorted list of all files included in this package
 

rattler/repo_data/__init__.py

@@ -2,7 +2,7 @@ from rattler.repo_data.package_record import PackageRecord
 from rattler.repo_data.repo_data import RepoData
 from rattler.repo_data.patch_instructions import PatchInstructions
 from rattler.repo_data.record import RepoDataRecord
-from rattler.repo_data.sparse import SparseRepoData
+from rattler.repo_data.sparse import SparseRepoData, PackageFormatSelection
 from rattler.repo_data.gateway import Gateway, SourceConfig
 
 __all__ = [
@@ -13,4 +13,5 @@ __all__ = [
     "SparseRepoData",
     "Gateway",
     "SourceConfig",
+    "PackageFormatSelection",
 ]

rattler/repo_data/gateway.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import os
-from typing import Optional, List
+from typing import Optional, List, Iterable
 from dataclasses import dataclass
 
 from rattler.rattler import PyGateway, PySourceConfig, PyMatchSpec
@@ -126,9 +126,9 @@ class Gateway:
 
     async def query(
         self,
-        channels: List[Channel | str],
-        platforms: List[Platform | PlatformLiteral],
-        specs: List[MatchSpec | PackageName | str],
+        channels: Iterable[Channel | str],
+        platforms: Iterable[Platform | PlatformLiteral],
+        specs: Iterable[MatchSpec | PackageName | str],
         recursive: bool = True,
     ) -> List[List[RepoDataRecord]]:
         """Queries the gateway for repodata.
@@ -183,7 +183,7 @@ class Gateway:
         return [[RepoDataRecord._from_py_record(record) for record in records] for records in py_records]
 
     async def names(
-        self, channels: List[Channel | str], platforms: List[Platform | PlatformLiteral]
+        self, channels: List[Channel | str], platforms: Iterable[Platform | PlatformLiteral]
     ) -> List[PackageName]:
         """Queries all the names of packages in a channel.
 
@@ -220,7 +220,7 @@ class Gateway:
         return [PackageName._from_py_package_name(package_name) for package_name in py_package_names]
 
     def clear_repodata_cache(
-        self, channel: Channel | str, subdirs: Optional[List[Platform | PlatformLiteral]] = None
+        self, channel: Channel | str, subdirs: Optional[Iterable[Platform | PlatformLiteral]] = None
     ) -> None:
         """
         Clears any in-memory cache for the given channel.

rattler/repo_data/package_record.py

@@ -5,10 +5,10 @@ import datetime
 
 from rattler import VersionWithSource
 from rattler.match_spec.match_spec import MatchSpec
-from rattler.package.no_arch_type import NoArchType
+from rattler.package.no_arch_type import NoArchType, NoArchLiteral
 from rattler.package.package_name import PackageName
 from rattler.platform.platform import Platform
-from rattler.rattler import PyRecord
+from rattler.rattler import PyRecord, ParsePlatformError
 
 if TYPE_CHECKING:
     import networkx as nx
@@ -189,9 +189,9 @@ class PackageRecord:
         build: str,
         build_number: int,
         subdir: str | Platform,
-        arch: Optional[str],
-        platform: Optional[str],
-        noarch: Optional[NoArchType] = None,
+        arch: Optional[str] = None,
+        platform: Optional[str] = None,
+        noarch: Optional[NoArchType | NoArchLiteral] = None,
         depends: Optional[List[str]] = None,
         constrains: Optional[List[str]] = None,
         sha256: Optional[bytes] = None,
@@ -204,11 +204,18 @@ class PackageRecord:
         license_family: Optional[str] = None,
         python_site_packages_path: Optional[str] = None,
     ) -> None:
-        # Convert Platform to str
+        if isinstance(subdir, str):
+            try:
+                subdir = Platform(subdir)
+            except ParsePlatformError:
+                # if the string is not a valid platform, we just keep it as a string
+                pass
+
         if isinstance(subdir, Platform):
-            arch = str(subdir.arch)
-            platform = subdir.only_platform
-            subdir = str(subdir)
+            if arch is None:
+                subdir_arch = subdir.arch
+                arch = str(subdir_arch) if subdir_arch is not None else arch
+            platform = subdir.only_platform if platform is None else platform
 
         # convert str to PackageName
         if isinstance(name, str):
@@ -218,15 +225,18 @@ class PackageRecord:
         if isinstance(version, str):
             version = VersionWithSource(version)
 
+        if not isinstance(noarch, NoArchType):
+            noarch = NoArchType(noarch)
+
         self._record = PyRecord.create(
             name._name,
             (version._version, version._source),
             build,
             build_number,
-            subdir,
-            arch,
+            str(subdir),
+            str(arch) if arch is not None else None,
             platform,
-            noarch,
+            noarch._noarch,
             python_site_packages_path,
         )
 

rattler/repo_data/sparse.py

@@ -1,14 +1,44 @@
 from __future__ import annotations
 import os
 from pathlib import Path
-from typing import List
+from typing import List, Optional, Type, Literal, Iterable
+from types import TracebackType
+
+from rattler.match_spec.match_spec import MatchSpec
 from rattler.channel.channel import Channel
 from rattler.package.package_name import PackageName
+from enum import Enum
 
-from rattler.rattler import PySparseRepoData
+from rattler.rattler import PySparseRepoData, PyPackageFormatSelection
 from rattler.repo_data.record import RepoDataRecord
 
 
+class PackageFormatSelection(Enum):
+    """
+    Enum that describes what to do if both a `.tar.bz2` and a `.conda` package is available.
+    """
+
+    ONLY_TAR_BZ2 = PyPackageFormatSelection.OnlyTarBz2
+    """
+    Only use the `.tar.bz2` packages, ignore all `.conda` packages.
+    """
+
+    ONLY_CONDA = PyPackageFormatSelection.OnlyConda
+    """
+    Only use the `.conda` packages, ignore all `.tar.bz2` packages.
+    """
+
+    PREFER_CONDA = PyPackageFormatSelection.PreferConda
+    """
+    Only use the `.conda` packages if there are both a `.tar.bz2` and a `.conda` package available.
+    """
+
+    BOTH = PyPackageFormatSelection.Both
+    """
+    Use both the `.tar.bz2` and the `.conda` packages.
+    """
+
+
 class SparseRepoData:
     """
     A class to enable loading records from a `repodata.json` file on demand.
@@ -39,7 +69,43 @@ class SparseRepoData:
             )
         self._sparse = PySparseRepoData(channel._channel, subdir, str(path))
 
-    def package_names(self) -> List[str]:
+    def close(self) -> None:
+        """
+        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.
+        >>>
+        ```
+        """
+        self._sparse.close()
+
+    def package_names(
+        self, package_format_selection: PackageFormatSelection = PackageFormatSelection.PREFER_CONDA
+    ) -> List[str]:
         """
         Returns a list over all package names in this repodata file.
         This works by iterating over all elements in the `packages` and
@@ -51,9 +117,8 @@ class SparseRepoData:
         ```python
         >>> from rattler import Channel, ChannelConfig
         >>> channel = Channel("dummy", ChannelConfig())
-        >>> subdir = "test-data/dummy/noarch"
         >>> path = "../test-data/channels/dummy/linux-64/repodata.json"
-        >>> sparse_data = SparseRepoData(channel, subdir, path)
+        >>> sparse_data = SparseRepoData(channel, "linux-64", path)
         >>> package_names = sparse_data.package_names()
         >>> package_names
         [...]
@@ -62,9 +127,22 @@ class SparseRepoData:
         >>>
         ```
         """
-        return self._sparse.package_names()
+        return self._sparse.package_names(package_format_selection.value)
+
+    def record_count(
+        self, package_format_selection: PackageFormatSelection = PackageFormatSelection.PREFER_CONDA
+    ) -> int:
+        """
+        Returns the total number of packages in this repodata file.
+        :return:
+        """
+        return self._sparse.record_count(package_format_selection.value)
 
-    def load_records(self, package_name: PackageName) -> List[RepoDataRecord]:
+    def load_records(
+        self,
+        package_name: str | PackageName,
+        package_format_selection: PackageFormatSelection = PackageFormatSelection.PREFER_CONDA,
+    ) -> List[RepoDataRecord]:
         """
         Returns all the records for the specified package name.
 
@@ -73,9 +151,8 @@ class SparseRepoData:
         ```python
         >>> from rattler import Channel, ChannelConfig, RepoDataRecord, PackageName
         >>> channel = Channel("dummy", ChannelConfig())
-        >>> subdir = "test-data/dummy/noarch"
         >>> path = "../test-data/channels/dummy/linux-64/repodata.json"
-        >>> sparse_data = SparseRepoData(channel, subdir, path)
+        >>> sparse_data = SparseRepoData(channel, "linux-64", path)
         >>> package_name = PackageName(sparse_data.package_names()[0])
         >>> records = sparse_data.load_records(package_name)
         >>> records
@@ -85,8 +162,66 @@ class SparseRepoData:
         >>>
         ```
         """
+        if not isinstance(package_name, PackageName):
+            package_name = PackageName(package_name)
+        return [
+            RepoDataRecord._from_py_record(record)
+            for record in self._sparse.load_records(package_name._name, package_format_selection.value)
+        ]
+
+    def load_all_records(
+        self, package_format_selection: PackageFormatSelection = PackageFormatSelection.PREFER_CONDA
+    ) -> List[RepoDataRecord]:
+        """
+        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
+        >>>
+        ```
+        """
         # maybe change package_name to Union[str, PackageName]
-        return [RepoDataRecord._from_py_record(record) for record in self._sparse.load_records(package_name._name)]
+        return [
+            RepoDataRecord._from_py_record(record)
+            for record in self._sparse.load_all_records(package_format_selection.value)
+        ]
+
+    def load_matching_records(
+        self,
+        specs: Iterable[MatchSpec],
+        package_format_selection: PackageFormatSelection = PackageFormatSelection.PREFER_CONDA,
+    ) -> List[RepoDataRecord]:
+        """
+        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("* 12.5")])]
+        ['cuda-version-12.5-hd4f0392_3.conda']
+        >>>
+        ```
+        """
+        return [
+            RepoDataRecord._from_py_record(record)
+            for record in self._sparse.load_matching_records(
+                [spec._match_spec for spec in specs], package_format_selection.value
+            )
+        ]
 
     @property
     def subdir(self) -> str:
@@ -98,11 +233,10 @@ class SparseRepoData:
         ```python
         >>> from rattler import Channel, ChannelConfig
         >>> channel = Channel("dummy", ChannelConfig())
-        >>> subdir = "test-data/dummy/noarch"
         >>> path = "../test-data/channels/dummy/linux-64/repodata.json"
-        >>> sparse_data = SparseRepoData(channel, subdir, path)
+        >>> sparse_data = SparseRepoData(channel, "linux-64", path)
         >>> sparse_data.subdir
-        'test-data/dummy/noarch'
+        'linux-64'
         >>>
         ```
         """
@@ -112,6 +246,7 @@ class SparseRepoData:
     def load_records_recursive(
         repo_data: List[SparseRepoData],
         package_names: List[PackageName],
+        package_format_selection: PackageFormatSelection = PackageFormatSelection.PREFER_CONDA,
     ) -> List[List[RepoDataRecord]]:
         """
         Given a set of [`SparseRepoData`]s load all the records
@@ -127,7 +262,7 @@ class SparseRepoData:
         >>> channel = Channel("dummy")
         >>> subdir = "test-data/dummy/linux-64"
         >>> path = "../test-data/channels/dummy/linux-64/repodata.json"
-        >>> sparse_data = SparseRepoData(channel, subdir, path)
+        >>> sparse_data = SparseRepoData(channel, "linux-64", path)
         >>> package_name = PackageName("python")
         >>> SparseRepoData.load_records_recursive([sparse_data], [package_name])
         [...]
@@ -137,8 +272,7 @@ class SparseRepoData:
         return [
             [RepoDataRecord._from_py_record(record) for record in list_of_records]
             for list_of_records in PySparseRepoData.load_records_recursive(
-                [r._sparse for r in repo_data],
-                [p._name for p in package_names],
+                [r._sparse for r in repo_data], [p._name for p in package_names], package_format_selection.value
             )
         ]
 
@@ -160,12 +294,57 @@ class SparseRepoData:
         ```python
         >>> from rattler import Channel, ChannelConfig
         >>> channel = Channel("dummy", ChannelConfig())
-        >>> subdir = "test-data/dummy/noarch"
         >>> path = "../test-data/channels/dummy/linux-64/repodata.json"
-        >>> sparse_data = SparseRepoData(channel, subdir, path)
+        >>> sparse_data = SparseRepoData(channel, "linux-64", path)
         >>> sparse_data
-        SparseRepoData(subdir="test-data/dummy/noarch")
+        SparseRepoData(subdir="linux-64")
         >>>
         ```
         """
         return f'SparseRepoData(subdir="{self.subdir}")'
+
+    def __enter__(self) -> SparseRepoData:
+        """
+        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")
+        >>>
+        ```
+        """
+        return self
+
+    def __exit__(
+        self,
+        exctype: Optional[Type[BaseException]],
+        excinst: Optional[BaseException],
+        exctb: Optional[TracebackType],
+    ) -> Literal[False]:
+        """
+        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")
+        >>>
+        ```
+        """
+        self.close()
+        return False

rattler/solver/solver.py

@@ -6,7 +6,7 @@ from rattler import Channel, Platform, VirtualPackage, SparseRepoData
 from rattler.match_spec.match_spec import MatchSpec
 
 from rattler.channel import ChannelPriority
-from rattler.rattler import py_solve, PyMatchSpec, py_solve_with_sparse_repodata
+from rattler.rattler import py_solve, PyMatchSpec, py_solve_with_sparse_repodata, PyPackageFormatSelection
 
 from rattler.platform.platform import PlatformLiteral
 from rattler.repo_data.gateway import Gateway
@@ -127,6 +127,7 @@ async def solve_with_sparse_repodata(
     exclude_newer: Optional[datetime.datetime] = None,
     strategy: SolveStrategy = "highest",
     constraints: Optional[Sequence[MatchSpec | str]] = None,
+    use_only_tar_bz2: bool = False,
 ) -> List[RepoDataRecord]:
     """
     Resolve the dependencies and return the `RepoDataRecord`s
@@ -171,6 +172,7 @@ async def solve_with_sparse_repodata(
         constraints: Additional constraints that should be satisfied by the solver.
             Packages included in the `constraints` are not necessarily installed,
             but they must be satisfied by the solution.
+        use_only_tar_bz2: If `True` only `.tar.bz2` packages are used. If `False` `.conda` packages are preferred.
 
     Returns:
         Resolved list of `RepoDataRecord`s.
@@ -191,6 +193,9 @@ async def solve_with_sparse_repodata(
             ],
             channel_priority=channel_priority.value,
             timeout=int(timeout / datetime.timedelta(microseconds=1)) if timeout else None,
+            package_format_selection=PyPackageFormatSelection.OnlyTarBz2
+            if use_only_tar_bz2
+            else PyPackageFormatSelection.PreferConda,
             exclude_newer_timestamp_ms=int(exclude_newer.replace(tzinfo=datetime.timezone.utc).timestamp() * 1000)
             if exclude_newer
             else None,

rattler/virtual_package/virtual_package.py

@@ -168,6 +168,8 @@ class VirtualPackage:
         """
         Returns virtual packages detected for the current system or an error
         if the versions could not be properly detected.
+
+        .. deprecated:: 0.7.0 Use `detect` instead.
         """
         warnings.warn("Use `detect` instead")
         return VirtualPackage.detect()