py-rattler 0.14.0__cp38-abi3-manylinux_2_28_aarch64.whl → 0.16.0__cp38-abi3-manylinux_2_28_aarch64.whl

{py_rattler-0.14.0.dist-info → py_rattler-0.16.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-rattler
-Version: 0.14.0
+Version: 0.16.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
@@ -10,7 +10,7 @@ Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Typing :: Typed
 Summary: A blazing fast library to work with the conda ecosystem
 Author-email: Bas Zalmstra <zalmstra.bas@gmail.com>, Tarun Pratap Singh <pratapsinghtarun9@gmail.com>
-License: BSD-3-Clause
+License-Expression: BSD-3-Clause
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://github.com/conda/rattler
@@ -52,7 +52,7 @@ Rattler is a library that provides common functionality used within the conda ec
 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.
 
-Rattler is written in Rust and tries to provide a clean API to its functionalities (see: [Components](#components)). 
+Rattler is written in Rust and tries to provide a clean API to its functionalities (see: [Components](#components)).
 With the primary goal in mind we aim to provide bindings to different languages to make it easy to integrate Rattler in non-rust projects.
 
 Rattler is actively used by [pixi](https://github.com/prefix-dev/pixi), [rattler-build](https://github.com/prefix-dev/rattler-build), and the https://prefix.dev backend.
@@ -64,6 +64,75 @@ This is an example of installing an environment containing `cowpy` and all its d
 
 ![Installing an environment](https://github.com/conda/rattler/assets/4995967/c7946f6e-28a9-41ef-8836-ef4b4c94d273)
 
+## Python and Javascript bindings
+
+You can invoke `rattler` from Python or Javascript via our powerful bindings to solve, install and run commands in conda environments. Rattler offers you the fastest and cleanest Python bindings to the conda ecosystem.
+
+### Python
+
+To install the Python bindings, you can use pip or conda:
+
+```bash
+pip install py-rattler
+# or
+conda install -c conda-forge py-rattler
+```
+
+You can find the extensive documentation for the Python bindings [here](https://conda.github.io/rattler/py-rattler/).
+
+<details>
+  <summary>Example usage of rattler from Python</summary>
+The Python bindings to rattler are designed to be used with `asyncio`. You can access the raw power of the rattler library to solve environments, install packages, and run commands in the installed environments.
+
+```python
+import asyncio
+import tempfile
+
+from rattler import solve, install, VirtualPackage
+
+async def main() -> None:
+    # Start by solving the environment.
+    #
+    # Solving is the process of going from specifications of package and their
+    # version requirements to a list of concrete packages.
+    print("started solving the environment")
+    solved_records = await solve(
+        # Channels to use for solving
+        channels=["conda-forge"],
+        # The specs to solve for
+        specs=["python ~=3.12.0", "pip", "requests 2.31.0"],
+        # Virtual packages define the specifications of the environment
+        virtual_packages=VirtualPackage.detect(),
+    )
+    print("solved required dependencies")
+
+    # Install the packages into a new environment (or updates it if it already
+    # existed).
+    env_path = tempfile.mkdtemp()
+    await install(
+        records=solved_records,
+        target_prefix=env_path,
+    )
+
+    print(f"created environment: {env_path}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+</details>
+
+### Javascript
+
+To use the Javascript bindings, you can install the `@conda-org/rattler` package via npm. rattler is compiled to WebAssembly and can be used in the browser or in Node.js.
+
+```bash
+npm install @conda-org/rattler
+```
+
+Using rattler from Javascript is useful to get access to the same version comparison functions as used throughout the conda ecosystem. It is also used as part of [`mambajs`](https://github.com/emscripten-forge/mambajs) which uses the rattler library to solve and install packages from the emscripten-forge channel _in the browser_.
+
+
 ## Give it a try!
 
 Before you begin, make sure you have the following prerequisites:
@@ -93,24 +162,24 @@ Run the following command to start jupyterlab:
  ./.prefix/bin/jupyter-lab
 ```
 
-Voila! 
-You have a working installation of jupyterlab installed on your system! 
-You can of course install any package you want this way. 
+Voila!
+You have a working installation of jupyterlab installed on your system!
+You can of course install any package you want this way.
 Try it!
 
 ## Contributing 😍
 
-We would love to have you contribute! 
-See the CONTRIBUTION.md for more info. For questions, requests or a casual chat, we are very active on our discord server. 
+We would love to have you contribute!
+See the CONTRIBUTION.md for more info. For questions, requests or a casual chat, we are very active on our discord server.
 You can [join our discord server via this link][chat-url].
 
 
 ## Components
 
-Rattler consists of several crates that provide different functionalities. 
+Rattler consists of several crates that provide different functionalities.
 
 * **rattler_conda_types**: foundational types for all datastructures used within the conda eco-system.
-* **rattler_package_streaming**: provides functionality to download, extract and create conda package archives.  
+* **rattler_package_streaming**: provides functionality to download, extract and create conda package archives.
 * **rattler_repodata_gateway**: downloads, reads and processes information about existing conda packages from an index.
 * **rattler_shell**: code to activate an existing environment and run programs in it.
 * **rattler_solve**: a backend agnostic library to solve the package satisfiability problem.

{py_rattler-0.14.0.dist-info → py_rattler-0.16.0.dist-info}/RECORD

@@ -1,62 +1,62 @@
-py_rattler-0.14.0.dist-info/METADATA,sha256=eLtd7JlsbnXua5A_5YrqZDCLm6udPL4yKEp1qltDQrU,7910
-py_rattler-0.14.0.dist-info/WHEEL,sha256=ceJGX8LwZMQVcHQm3gLxBcfgXDuVV19Hhh3viIXK0NA,107
-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=EEF86vA-ryVuBmq5uOomgzPq1BGXsNcAhJvf7JKVVDQ,11259
+py_rattler-0.16.0.dist-info/METADATA,sha256=Bx48H0csQlFHsxvMEBK6rpNZqctAqhLZZSlDJOOYx6c,10339
+py_rattler-0.16.0.dist-info/WHEEL,sha256=Flq5NPP2j_RMfns2-YLcgMysMd1F4Y1bfmYWN9Ge8hw,107
+rattler/__init__.py,sha256=QKjBUll9mX4TVwJy-dy5Gt8IezLnJz8EPTlKhOsw2IA,2476
+rattler/channel/__init__.py,sha256=K-ZAo0qFzchXWP-6DpMHLg_djGD25-0CRwusisIGp8k,221
+rattler/channel/channel.py,sha256=kGeZKa_YkSM943CA1i_8O1FXG9kS9hkrnmSl6OhkbbQ,2474
+rattler/channel/channel_config.py,sha256=rRD4dGeHTBIcm3vTuQR1wTGTELNdN69yq4lyCaTaN3M,1532
+rattler/channel/channel_priority.py,sha256=OQfCHp_DeInkMB0YahCf2X7yCk0_RtM_C_Vy4Ny-65M,474
+rattler/exceptions.py,sha256=2ivs3zwllwQwn1InBiArbrZbTzPXpssv7fzZkGdRpnI,4059
 rattler/explicit_environment/__init__.py,sha256=QHmwZkdVt-tFL-tEEdhLdH3apuI5F7ElpMzCRZeH3_o,170
 rattler/explicit_environment/environment.py,sha256=Dqcvm5c7C3K0FJ04YVN8WIUrl0R8Fe2TeXZ4Qq8Dg-0,2641
-rattler/match_spec/__init__.py,sha256=uBV3ov1VlCIZlIWhkxxMPcTqRBF5p5lqvT2g6kQv5kQ,167
-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/index/__init__.py,sha256=X02qeNDYnyWR-J7FaAvNoQfw5DtYRbUGtNEq5nAva0Y,119
+rattler/index/index.py,sha256=4Di_aIAtvspRflUoIcD4rZj-4za6i3ewWa8FK7kSlSg,4342
+rattler/install/__init__.py,sha256=F_DwKOql1YkdV78JV5jT0RglNhs2ZwSup9uWGv9wO4I,69
+rattler/install/installer.py,sha256=AuEgn19qhEQBOqjYErQLKhb9p704fgRhA4ZIHOab0sQ,4227
 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/environment.py,sha256=sbcGqkb9rrGwpVCucDKkwdp2SFOyHZQGqvBArGEZFYs,7915
 rattler/lock/channel.py,sha256=PaLb-vWRLTJWUx7fyMdP2Tow5wMlGuq3WUrHkrQIzeg,1331
-rattler/prefix/prefix_record.py,sha256=KWbjcBJO-KpdWz2VEYdlz_RPLpLByyaec0aViILi_EM,6290
+rattler/lock/environment.py,sha256=sbcGqkb9rrGwpVCucDKkwdp2SFOyHZQGqvBArGEZFYs,7915
+rattler/lock/hash.py,sha256=qNig1sf5EfRfaCK9x352DgqTpLdo75Gu4qvRZDbL33Q,805
+rattler/lock/lock_file.py,sha256=ZP-ElSJ7WKkqOE6rj4U6OmM63GLcDH_yTg1H_Qoa60E,3455
+rattler/lock/package.py,sha256=FnjWrHfcgRgqZepCKuCDA7tuIa0INGF8ivGswkQ_17E,9024
+rattler/match_spec/__init__.py,sha256=uBV3ov1VlCIZlIWhkxxMPcTqRBF5p5lqvT2g6kQv5kQ,167
+rattler/match_spec/match_spec.py,sha256=fyrvd9VUURJyHaJDqNdzJNa3dZZpKLUmhjGVWtdGV4w,9525
+rattler/match_spec/nameless_match_spec.py,sha256=pn__lFSo6chFqDWLIag5jjwumiX2kiTDguMYIdy-lu8,4599
+rattler/networking/__init__.py,sha256=Wlob5pywEgiqmAq8sVKyJS6qOpRegKemtcXTkwDED20,474
+rattler/networking/client.py,sha256=hMe-eq8n8KkiqTlu4MR-9fc30AwSJd0dB_h60famki0,1584
+rattler/networking/fetch_repo_data.py,sha256=sO3dDNdvJev6TOblnGEzpFYnY2xorfr5A5zrjsTDbWk,3714
+rattler/networking/middleware.py,sha256=S1eArDWo45dKo8Um6mMYMOPs_OIdhLamejEQs8KorCQ,4838
+rattler/package/__init__.py,sha256=omXnLVICkiH7HiaUzpRWAaJxS955Uimm1pT8dejJgVU,624
+rattler/package/about_json.py,sha256=FElWUXFNeF1gQJXE6lmYNEdxQjhsuimVObIeqxn3y8M,8958
+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/package/paths_json.py,sha256=7l2Wmqobwcoe-TStXhoafWzXCT4OWif_yAAa6KVnKyg,21465
+rattler/package/run_exports_json.py,sha256=fZlM_H7IBuVi6lfL4SLsV_NDb22TgFhpCkxjm8YIvfg,9305
+rattler/package_streaming/__init__.py,sha256=I-mbr0sJnHzdFQP8v0Yb_GKpu4bIO3JbAJtq_wzA71Q,898
+rattler/platform/__init__.py,sha256=YZaXxnJmG_WjYbhIAxA0jQDhaPYAR4rTVQCm4yRoyZQ,154
+rattler/platform/arch.py,sha256=7tanyDql5BvDvY9UryEXyTJ9nWRfx6bn7BWrl6fGEfI,1145
+rattler/platform/platform.py,sha256=FPHoKsJm717LkEZurFOM1LV_8BhLfJeKjsqrte2mZnQ,4896
 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=EMit1hPVJdHOXHDaodORMfayz4P896xRy5A2ksV8TT0,10023
-rattler/repo_data/sparse.py,sha256=qO3XuIfvcDEfo8mHu8UB9JBoz0IR3k_kNR32ZTpbPWU,12542
-rattler/repo_data/package_record.py,sha256=t8vxRsfAToIolhBRjt9lB4e5Q7Tm-FjZHUI9vhxd-eA,28358
+rattler/prefix/prefix_record.py,sha256=1ALSRxHlhkOAl86_HKhU_l-Ny0PK11je6rnHo9alfh8,7048
+rattler/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rattler/rattler.abi3.so,sha256=bR0zhoiuvYFoqdlid6vV86y31JXQHQkOwib6mvWch10,46054240
 rattler/repo_data/__init__.py,sha256=cMoMtFOJBGonfWxizGphWpXdQ1GYXDXos7ESYigfco8,549
-rattler/repo_data/repo_data.py,sha256=lB7hQ1SN5b2VxuOaOH1BOFeIXbRUf2fslitLyT5aVwo,2264
+rattler/repo_data/gateway.py,sha256=tK6XmTGbafZjvEo6_T8G-iYTu10MtJkAtg4fhtA9A60,10019
+rattler/repo_data/package_record.py,sha256=t8vxRsfAToIolhBRjt9lB4e5Q7Tm-FjZHUI9vhxd-eA,28358
 rattler/repo_data/patch_instructions.py,sha256=TNa7NgLtqGQ6lSpibLFxuPFwsmqRLrORpDZOpeZ5fnk,694
 rattler/repo_data/record.py,sha256=6CK2-KyvVZ8kaZ2l-o4DFWivxMJE_ChkOrm97bmIjn4,4572
-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/repo_data/repo_data.py,sha256=39VnTUVCwXDy22FD1UluA3MGyzUYw2rLY9G91u-28TE,2261
+rattler/repo_data/sparse.py,sha256=qO3XuIfvcDEfo8mHu8UB9JBoz0IR3k_kNR32ZTpbPWU,12542
 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/solver/__init__.py,sha256=NZabrelb_pcqOi5PyZTr3OeBbjd85IqW1-2ymOBO-k0,119
+rattler/solver/solver.py,sha256=EEF86vA-ryVuBmq5uOomgzPq1BGXsNcAhJvf7JKVVDQ,11259
 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=3xT2X59ThgF-YI5C7PRFoGNSHfaTEKwe672TpcYXo-k,4148
+rattler/version/__init__.py,sha256=FQ_4xuCz_2tTPlIeSA_1SkPEP_DpuXw6tDDjsptMTZo,146
+rattler/version/version.py,sha256=5CWe2wjH-7lmKUgzFFMSfNwLF04lzLgarhckkmdQ4cY,15954
+rattler/version/with_source.py,sha256=nEW_jetdsB-5hKnxHVYgwOsd0EAe0fNKaCLlD4fIZiM,2539
 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=L4BE_gxKTeygcyxy7xsu2WoATIe7ZAp-UwgPYU0Pa7g,43548656
-py_rattler-0.14.0.dist-info/RECORD,,
+rattler/virtual_package/virtual_package.py,sha256=hrFvoT2LjIsW5ubfXdXEZnKlSIfLP5G4vrbJST9xukI,6707
+py_rattler-0.16.0.dist-info/RECORD,,

{py_rattler-0.14.0.dist-info → py_rattler-0.16.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.7.8)
+Generator: maturin (1.9.4)
 Root-Is-Purelib: false
 Tag: cp38-abi3-manylinux_2_28_aarch64

rattler/index/__init__.py

@@ -1,3 +1,3 @@
-from rattler.index.index import index_fs, index_s3
+from rattler.index.index import index_fs, index_s3, S3Credentials
 
-__all__ = ["index_s3", "index_fs"]
+__all__ = ["index_s3", "index_fs", "S3Credentials"]

rattler/index/index.py

@@ -1,12 +1,36 @@
 from __future__ import annotations
 
+from dataclasses import dataclass
 import os
-from typing import Optional
+from typing import Optional, Literal
 
 from rattler.platform import Platform
 from rattler.rattler import py_index_fs, py_index_s3
 
 
+@dataclass
+class S3Credentials:
+    """Credentials for accessing an S3 backend."""
+
+    # The endpoint URL of the S3 backend
+    endpoint_url: str
+
+    # The region of the S3 backend
+    region: str
+
+    # The access key ID for the S3 bucket.
+    access_key_id: Optional[str] = None
+
+    # The secret access key for the S3 bucket.
+    secret_access_key: Optional[str] = None
+
+    # The session token for the S3 bucket.
+    session_token: Optional[str] = None
+
+    # Defines how to address the bucket, either using virtual-hosted-style or path-style.
+    addressing_style: Literal["path", "virtual-host"] = "virtual-host"
+
+
 async def index_fs(
     channel_directory: os.PathLike[str],
     target_platform: Optional[Platform] = None,
@@ -14,7 +38,7 @@ async def index_fs(
     write_zst: bool = True,
     write_shards: bool = True,
     force: bool = False,
-    max_parallel: int = 128,
+    max_parallel: int | None = None,
 ) -> None:
     """
     Indexes dependencies in the `channel_directory` for one or more subdirectories within said directory.
@@ -46,18 +70,13 @@ async def index_fs(
 
 async def index_s3(
     channel_url: str,
-    region: str,
-    endpoint_url: str,
-    force_path_style: bool = False,
-    access_key_id: Optional[str] = None,
-    secret_access_key: Optional[str] = None,
-    session_token: Optional[str] = None,
+    credentials: Optional[S3Credentials] = None,
     target_platform: Optional[Platform] = None,
     repodata_patch: Optional[str] = None,
     write_zst: bool = True,
     write_shards: bool = True,
     force: bool = False,
-    max_parallel: int = 32,
+    max_parallel: int | None = None,
 ) -> None:
     """
     Indexes dependencies in the `channel_url` for one or more subdirectories in the S3 directory.
@@ -69,12 +88,8 @@ async def index_s3(
     Arguments:
         channel_url: An S3 URL (e.g., s3://my-bucket/my-channel that containins the subdirectories
                      of dependencies to index.
-        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: 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.
+        credentials: The credentials to use for accessing the S3 bucket. If not provided, will use the default
+                     credentials from the environment.
         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.
         write_zst: Whether to write repodata.json.zst.
@@ -84,12 +99,7 @@ async def index_s3(
     """
     await py_index_s3(
         channel_url,
-        region,
-        endpoint_url,
-        force_path_style,
-        access_key_id,
-        secret_access_key,
-        session_token,
+        credentials,
         target_platform._inner if target_platform else target_platform,
         repodata_patch,
         write_zst,

rattler/install/installer.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 import os
 from typing import List, Optional
 
+from rattler.match_spec import MatchSpec
 from rattler.networking.client import Client
 from rattler.platform.platform import Platform
 from rattler.prefix.prefix_record import PrefixRecord
@@ -16,10 +17,12 @@ async def install(
     cache_dir: Optional[os.PathLike[str]] = None,
     installed_packages: Optional[List[PrefixRecord]] = None,
     reinstall_packages: Optional[set[str]] = None,
+    ignored_packages: Optional[set[str]] = None,
     platform: Optional[Platform] = None,
     execute_link_scripts: bool = False,
     show_progress: bool = True,
     client: Optional[Client] = None,
+    requested_specs: Optional[List[MatchSpec]] = None,
 ) -> None:
     """
     Create an environment by downloading and linking the `dependencies` in
@@ -64,6 +67,8 @@ async def install(
                 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
@@ -71,6 +76,9 @@ async def install(
         show_progress: If set to `True` a progress bar will be shown on the CLI.
         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.
     """
 
     await py_install(
@@ -79,8 +87,10 @@ async def install(
         cache_dir=cache_dir,
         installed_packages=installed_packages,
         reinstall_packages=reinstall_packages,
+        ignored_packages=ignored_packages,
         platform=platform._inner if platform is not None else None,
         client=client._client if client is not None else None,
         execute_link_scripts=execute_link_scripts,
         show_progress=show_progress,
+        requested_specs=requested_specs,
     )

rattler/lock/package.py

@@ -80,7 +80,7 @@ class LockedPackage(ABC):
         """
         Returns a representation of the LockedPackage.
         """
-        return f"{type(self).__name__}(" f"name={self.name!r}," f"location={self.location!r}" ")"
+        return f"{type(self).__name__}(name={self.name!r},location={self.location!r})"
 
     @classmethod
     def _from_py_locked_package(cls, py_pkg: PyLockedPackage) -> LockedPackage:

rattler/match_spec/nameless_match_spec.py

@@ -71,9 +71,8 @@ class NamelessMatchSpec:
         """
         The channel of the package.
         """
-        if (channel := self._nameless_match_spec.channel) is not None:
-            return Channel(channel.name)
-        return None
+        channel = self._nameless_match_spec.channel
+        return channel and Channel._from_py_channel(channel)
 
     @property
     def subdir(self) -> Optional[str]:

rattler/networking/client.py

@@ -20,9 +20,10 @@ class Client:
         middlewares: (
             list[AuthenticationMiddleware | MirrorMiddleware | OciMiddleware | GCSMiddleware | S3Middleware] | None
         ) = None,
+        headers: dict[str, str] | None = None,
     ) -> None:
         self._client = PyClientWithMiddleware(
-            [middleware._middleware for middleware in middlewares] if middlewares else None
+            [middleware._middleware for middleware in middlewares] if middlewares else None, headers
         )
 
     @classmethod

rattler/platform/platform.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+from collections.abc import Iterator
 from typing import Any, Dict, Literal, Tuple, Optional
 
 from rattler.rattler import PyPlatform
@@ -6,22 +7,28 @@ from rattler.platform.arch import Arch
 
 PlatformLiteral = Literal[
     "noarch",
+    "unknown",
     "linux-32",
     "linux-64",
     "linux-aarch64",
     "linux-armv6l",
     "linux-armv7l",
+    "linux-loong64",
     "linux-ppc64le",
     "linux-ppc64",
+    "linux-ppc",
     "linux-s390x",
     "linux-riscv32",
     "linux-riscv64",
+    "freebsd-64",
     "osx-64",
     "osx-arm64",
     "win-32",
     "win-64",
     "win-arm64",
-    "emscripten-32",
+    "emscripten-wasm32",
+    "wasi-wasm32",
+    "zos-z",
 ]
 
 
@@ -73,7 +80,7 @@ class Platform(metaclass=PlatformSingleton):
 
     def __repr__(self) -> str:
         """
-        Returnrs a representation of the platform.
+        Returns a representation of the platform.
 
         Examples
         --------
@@ -90,7 +97,23 @@ class Platform(metaclass=PlatformSingleton):
         """
         Returns the current platform.
         """
-        return Platform._from_py_platform(PyPlatform.current())
+        return cls._from_py_platform(PyPlatform.current())
+
+    @classmethod
+    def all(cls) -> Iterator[Platform]:
+        """
+        Returns all supported platforms.
+
+        Examples
+        --------
+        ```python
+        >>> next(Platform.all())
+        Platform(noarch)
+        >>> len(list(Platform.all()))
+        23
+        >>>
+        """
+        return (cls._from_py_platform(p) for p in PyPlatform.all())
 
     @property
     def is_linux(self) -> bool:

rattler/prefix/prefix_record.py

@@ -42,16 +42,18 @@ class PrefixRecord(RepoDataRecord):
         package_tarball_full_path: Optional[os.PathLike[str]] = None,
         extracted_package_dir: Optional[os.PathLike[str]] = None,
         requested_spec: Optional[str] = None,
+        requested_specs: Optional[List[str]] = None,
         files: Optional[List[os.PathLike[str]]] = None,
     ) -> None:
         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,
-            files,
+            repodata_record=repodata_record._record,
+            paths_data=paths_data._paths,
+            link=link._inner if link else None,
+            package_tarball_full_path=package_tarball_full_path,
+            extracted_package_dir=extracted_package_dir,
+            files=files,
+            requested_spec=requested_spec,
+            requested_specs=requested_specs,
         )
         self._record = record
 
@@ -169,11 +171,8 @@ class PrefixRecord(RepoDataRecord):
     @property
     def requested_spec(self) -> Optional[str]:
         """
-        The spec that was used when this package was installed.
-        Note that this field is not currently updated if another
-        spec was used. If this package was not directly requested by the
-        user but was instead installed as a dependency of another package
-        `None` will be returned.
+        The spec that was used when this package was installed (deprecated).
+        Use requested_specs instead.
 
         Examples
         --------
@@ -181,8 +180,8 @@ class PrefixRecord(RepoDataRecord):
         >>> r = PrefixRecord.from_path(
         ...     "../test-data/conda-meta/requests-2.28.2-pyhd8ed1ab_0.json"
         ... )
-        >>> r.requested_spec
-        ''
+        >>> r.requested_spec is None
+        True
         >>>
         ```
         """
@@ -192,6 +191,31 @@ class PrefixRecord(RepoDataRecord):
     def requested_spec(self, value: Optional[str]) -> None:
         self._record.requested_spec = value
 
+    @property
+    def requested_specs(self) -> List[str]:
+        """
+        The specs that were used when this package was installed.
+        If this package was not directly requested by the user but was instead
+        installed as a dependency of another package an empty list will be
+        returned.
+
+        Examples
+        --------
+        ```python
+        >>> r = PrefixRecord.from_path(
+        ...     "../test-data/conda-meta/requests-2.28.2-pyhd8ed1ab_0.json"
+        ... )
+        >>> r.requested_specs
+        []
+        >>>
+        ```
+        """
+        return self._record.requested_specs
+
+    @requested_specs.setter
+    def requested_specs(self, value: List[str]) -> None:
+        self._record.requested_specs = value
+
     def __repr__(self) -> str:
         """
         Returns a representation of the version

rattler/repo_data/gateway.py

@@ -37,7 +37,7 @@ class SourceConfig:
 
     cache_action: CacheAction = "cache-or-fetch"
     """How to interact with the cache.
-    
+
     * `'cache-or-fetch'` (default): Use the cache if its up to date or fetch from the URL if there is no valid cached value.
     * `'use-cache-only'`: Only use the cache, but error out if the cache is not up to date
     * `'force-cache-only'`: Only use the cache, ignore whether or not it is up to date.

rattler/repo_data/repo_data.py

@@ -15,7 +15,7 @@ class RepoData:
     def __init__(self, path: Union[str, PathLike[str]]) -> None:
         if not isinstance(path, (str, Path)):
             raise TypeError(
-                "RepoData constructor received unsupported type " f" {type(path).__name__!r} for the `path` parameter"
+                f"RepoData constructor received unsupported type  {type(path).__name__!r} for the `path` parameter"
             )
 
         self._repo_data = PyRepoData.from_path(path)

rattler/version/version.py

@@ -24,8 +24,7 @@ class Version:
             self._version = PyVersion(version)
         else:
             raise TypeError(
-                "Version constructor received unsupported type "
-                f" {type(version).__name__!r} for the `version` parameter"
+                f"Version constructor received unsupported type  {type(version).__name__!r} for the `version` parameter"
             )
 
     @classmethod