py-rattler 0.7.2__cp38-abi3-win32.whl → 0.8.2__cp38-abi3-win32.whl

{py_rattler-0.7.2.dist-info → py_rattler-0.8.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: py-rattler
-Version: 0.7.2
+Version: 0.8.2
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License

{py_rattler-0.7.2.dist-info → py_rattler-0.8.2.dist-info}/RECORD

@@ -1,14 +1,16 @@
-py_rattler-0.7.2.dist-info/METADATA,sha256=jM4R-xzJe2xXBkhFseRE1QGP2XfH6Sf_JVmqDi0lMrI,8036
-py_rattler-0.7.2.dist-info/WHEEL,sha256=fEuvyTnWBaFFqUK_-nJdc8PSyUVWaUnyNgRH_ePN1nU,90
-py_rattler-0.7.2.dist-info/license_files/LICENSE,sha256=dwHz2yahpPvgij5rWUfP4xwZgfEVFePgY1j2DQyY0C0,1530
+py_rattler-0.8.2.dist-info/METADATA,sha256=JyKGEl1vktN4a3ySTywiB_RfAeZ1VpF0_rLynEPeiUg,8036
+py_rattler-0.8.2.dist-info/WHEEL,sha256=fEuvyTnWBaFFqUK_-nJdc8PSyUVWaUnyNgRH_ePN1nU,90
+py_rattler-0.8.2.dist-info/license_files/LICENSE,sha256=dwHz2yahpPvgij5rWUfP4xwZgfEVFePgY1j2DQyY0C0,1530
 rattler/channel/channel.py,sha256=X0rUb2VtxIzHzWaG8nsoH8l8q9htalzxSrv77moBIuw,2568
 rattler/channel/channel_config.py,sha256=fubqr_KtR6FzpGP-5W-v8anEjuH7kGt8hPHQ_ojmKZ8,1575
 rattler/channel/channel_priority.py,sha256=zPb2CG7RUBJVH2f-pbaxnYIDIUEvGjDJLS5-L8-CgUM,488
 rattler/channel/__init__.py,sha256=66ZzlAEanXVHmRFZ5W3SSz4XaaPbOD_drHYNGtMvA7w,226
-rattler/exceptions.py,sha256=D11mP_ImCHa7yilb5pCkdWrsVW2hWJoWDWT3Se-dB08,3952
+rattler/exceptions.py,sha256=LI7yj9TPgORKcIvl6KAhp3MqTXvvGzMI450K9jh0imc,4174
+rattler/explicit_environment/environment.py,sha256=EoKZcC5t7iBTtHFtq5wkjN65ZMnRjCl0cJsCpJs4JYw,2710
+rattler/explicit_environment/__init__.py,sha256=hslNA2pDXqP5fgbnVYJAqr8j0vucFi48_vnqb3r2hfo,173
 rattler/index/index.py,sha256=h-QGux6h7YLXmZkP-sBOfQD0eUXubWUPmOOpVVzZccU,1161
 rattler/index/__init__.py,sha256=6ZfzMgGlZREtm-hBBOAh-Y4t52SMe4daJDFGzhBsjww,62
-rattler/install/installer.py,sha256=sxbQsPbth-t4PXU8vYOOayHl4PxWYnLZW9_Mfs8dQ38,3504
+rattler/install/installer.py,sha256=Uc711Z6TvbrHHLo7YEdITZ9txkam5yWdvIxstuDS_HM,3464
 rattler/install/__init__.py,sha256=qV-pHnLSxQ57o3rVFuedEaZD2_wKmtrO3l52u96Le74,72
 rattler/lock/channel.py,sha256=fWashbJ1-6WKQnlARggjp6T-QRmBcxhG-vyYEjUOla0,1383
 rattler/lock/environment.py,sha256=rcpHI9zKZNLcm_Oa4Jx4-VvaVaE9yBpqIE2vlZQMNwU,7904
@@ -20,27 +22,28 @@ rattler/lock/__init__.py,sha256=O1P94c1tbsG_P0HEZk2mCZOHbHmp5nRU4GmPq1_hCxE,487
 rattler/match_spec/match_spec.py,sha256=aWrZ6Fv3k2rXZymYK62Htivk-MB7FmEvyLeShAYV8W8,8483
 rattler/match_spec/nameless_match_spec.py,sha256=ZuayVPh8S4aezgTPd9eJ1i1hbzTmfJG90Z3HkvztprM,4782
 rattler/match_spec/__init__.py,sha256=dp2VL-6Cg-sJ1cBdiZ6RoZKOroR2z2lzX4SI0iAwGow,171
-rattler/networking/authenticated_client.py,sha256=PDQwmCiFZJF7VnM85aSgKfl0UPSlJeH-UcAt9YnEYy0,950
-rattler/networking/fetch_repo_data.py,sha256=CxbutHYt9wBlhb48tLjXp-0CIkB9spnQfYS2Z7sd6hQ,1436
-rattler/networking/__init__.py,sha256=1ycQwvODUOxyc8JqpzTd_72UXLrzuz6k0vw-CoT2OeQ,193
+rattler/networking/client.py,sha256=7RXVJTbkvrYzI1UlJ092k8ly3-2iybPQjTmEjqL7dTg,1416
+rattler/networking/fetch_repo_data.py,sha256=c5tc2-Z-fDUmyGWtfXYEdjSA0CZUBTX1hdxvFoKA-_M,1600
+rattler/networking/middleware.py,sha256=72LnPxKckVtD7emAfr1axWcWo2VlTuWrJa8BSyD4QrI,1893
+rattler/networking/__init__.py,sha256=rZaCy8e3XsOhspvES2tDksHZh08kQKwRuqmy1Iej0Ng,287
 rattler/package/about_json.py,sha256=6krfv7obbGfWByBx74R7xRQT6H6-W8Ygl_m0fI-TL7U,7310
 rattler/package/index_json.py,sha256=lD_jb-ACkB9bWriceZWtcHpbXddLjRlV8xcEggVR4vM,9878
-rattler/package/no_arch_type.py,sha256=MtqD0vlbX1WIMlR_CzDjbF3d7CewIjAtJMfqy9S6naE,3812
-rattler/package/package_name.py,sha256=BMHN870L4ghtKojSdsTDjlOUvTN-y_bKKEA8VUB-P0o,4260
-rattler/package/paths_json.py,sha256=5HSYdNCu9q_RJgC0AVz_Htx7bA5OpHFk_K05AHPARf8,15440
+rattler/package/no_arch_type.py,sha256=oNx7KwfkxSoIQ5t_TcjiTZvcgs7fQLlUVRx4SCqJk-0,3826
+rattler/package/package_name.py,sha256=CDMG8KEFMSV0IsVZm-Uujf_RPLV5FRK3K72T6e3no4w,4585
+rattler/package/paths_json.py,sha256=GWbhT_C-DnKAsYKIWw9L1vHIUJBAX2dvc5MYQjiQAD0,15567
 rattler/package/run_exports_json.py,sha256=p1Y8M2z82fiUySYphoRcGUjn6vh83fib_G5eJxFs8Z0,6332
 rattler/package/__init__.py,sha256=zaSLXHJgBjoI1VOsuVeUgYGdGn5xnW9pb_o7T-s-rN0,541
 rattler/platform/arch.py,sha256=l2kg4E1Z2x-nrYtiF4vERvIVcqjLqwMfUcx-VQoLfmU,1203
-rattler/platform/platform.py,sha256=gJpY_43bGMA0Hg9k6nVZrR7JN5f54ajXyJjCM7ffIwI,4169
+rattler/platform/platform.py,sha256=HmdY9Ssg7CrEq1kYhE1JMnHCNZ5xmQZN9W_kocw0kfo,4514
 rattler/platform/__init__.py,sha256=QKFVTYNuY8aZrUbi0kOjP0Iw0lbBH0BeUFtLUitUkGg,158
-rattler/prefix/prefix_paths.py,sha256=0sowl4iTi10eKcQOxUGykOwnBPAKdqkK_MDGey856UE,8845
-rattler/prefix/prefix_record.py,sha256=SYfCsqXT-mwvqFXMjdLAYXHWjfoFtCyx17Y99z738-Q,4667
+rattler/prefix/prefix_paths.py,sha256=JaK0j_2peGc566plCBLE7YjfbUJ5PAy25kfxoQOwO7E,13261
+rattler/prefix/prefix_record.py,sha256=Jo_Cr5POavX09LYy0xr9d7kbSvFmxilFN0OYp58dUbc,6058
 rattler/prefix/__init__.py,sha256=Pr1a0qnpUz_0FZgi79BBszdtWr1x84E_bd0f9ux9s64,225
 rattler/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rattler/repo_data/gateway.py,sha256=mrunz-HGVQvcanLTRfyFf9BIsEJoE0X6huGzJV4K9K4,8485
-rattler/repo_data/package_record.py,sha256=t59CkqlJR0gV0WMqjuyKYeIv566N6it_C88ar0au2vs,15474
+rattler/repo_data/gateway.py,sha256=iWy389xbjExt4wiqoYcIyngV4ksmobQlzXz23O24tFU,9804
+rattler/repo_data/package_record.py,sha256=B6SBu6S1hmpoZHPxUB0_iaSJaFIHAKWwlBm13EGrh0M,28754
 rattler/repo_data/patch_instructions.py,sha256=WlI9gXPEvbYQUkxZpr5hi1u3PypkaaXAjpu0Plp2kCA,716
-rattler/repo_data/record.py,sha256=0vHyXKuMQVY1KjskvKkTO-Mksn6E5PhiHT4gC0QlF28,2755
+rattler/repo_data/record.py,sha256=OTZrr2FUeBGqVKwjiu-1n7uiY_GnwDVFk77gZy6ozxk,4736
 rattler/repo_data/repo_data.py,sha256=PhFiR_A2YvjlTb6pU3bV0kIWwSla2A8CJeXd5lzVRpk,2338
 rattler/repo_data/sparse.py,sha256=9suNN-5LIzkXnAfJJvyJv3FVCsREZOGdOXDkTS3-5CE,6333
 rattler/repo_data/__init__.py,sha256=JdbHMi6RO2GpKp0ZyH32x7xvIig9cJjXgAJxuBpGpng,511
@@ -55,6 +58,6 @@ rattler/version/__init__.py,sha256=mstm5fHMHif1fXw0jo0giftoVUGjFGX2GxvASD5kSCU,1
 rattler/virtual_package/generic.py,sha256=XOCqsULIrVbZzjf2_629HZWnplZifqo-fWkjtUTvJFE,4547
 rattler/virtual_package/virtual_package.py,sha256=Ajikn1F6VMlJKzKmKcnolHnfhsPRZBgt9iMwKQVXoaI,6853
 rattler/virtual_package/__init__.py,sha256=PjKMWmztuN2ZbEn9u6l79dPntiRhH3f2zLH2Fvq8hu0,266
-rattler/__init__.py,sha256=_ck7oPHkD2mClp1QVlL9liQG303RetrEVdhZXNXbR2Q,2305
-rattler/rattler.pyd,sha256=XwfrGKjNSyTY4M0JLjajcA65YhOseOGMncbOqEWLXwU,13255168
-py_rattler-0.7.2.dist-info/RECORD,,
+rattler/__init__.py,sha256=rgdyfibWyIinwUiMH1SSlH65G-l5BynbS5amniKpMXc,2351
+rattler/rattler.pyd,sha256=dFuhBSyuHxJ6SWqB7rr_kjY59eMUJ3_ix9qFt5Ct6q4,13666304
+py_rattler-0.8.2.dist-info/RECORD,,

rattler/__init__.py

@@ -10,7 +10,7 @@ from rattler.repo_data import (
     SourceConfig,
 )
 from rattler.channel import Channel, ChannelConfig, ChannelPriority
-from rattler.networking import AuthenticatedClient, fetch_repo_data
+from rattler.networking import Client, fetch_repo_data
 from rattler.virtual_package import GenericVirtualPackage, VirtualPackage, VirtualPackageOverrides, Override
 from rattler.package import (
     PackageName,
@@ -23,6 +23,7 @@ from rattler.package import (
     FileMode,
     IndexJson,
 )
+from rattler.package.no_arch_type import NoArchType
 from rattler.prefix import PrefixRecord, PrefixPaths, PrefixPathsEntry, PrefixPathType
 from rattler.platform import Platform
 from rattler.utils.rattler_version import get_rattler_version as _get_rattler_version
@@ -51,7 +52,7 @@ __all__ = [
     "Channel",
     "ChannelConfig",
     "ChannelPriority",
-    "AuthenticatedClient",
+    "Client",
     "PatchInstructions",
     "RepoDataRecord",
     "RepoData",
@@ -88,4 +89,5 @@ __all__ = [
     "IndexJson",
     "Gateway",
     "SourceConfig",
+    "NoArchType",
 ]

rattler/exceptions.py

@@ -20,6 +20,7 @@ try:
         EnvironmentCreationError,
         ExtractError,
         GatewayError,
+        ValidatePackageRecordsException,
     )
 except ImportError:
     # They are only redefined for documentation purposes
@@ -85,6 +86,9 @@ except ImportError:
     class GatewayError(Exception):  # type: ignore[no-redef]
         """An error that can occur when querying the repodata gateway."""
 
+    class ValidatePackageRecordsException(Exception):  # type: ignore[no-redef]
+        """An error when validating package records."""
+
 
 __all__ = [
     "ActivationError",
@@ -107,4 +111,5 @@ __all__ = [
     "EnvironmentCreationError",
     "ExtractError",
     "GatewayError",
+    "ValidatePackageRecordsException",
 ]

rattler/explicit_environment/__init__.py

@@ -0,0 +1,3 @@
+from rattler.explicit_environment.environment import ExplicitEnvironmentSpec, ExplicitEnvironmentEntry
+
+__all__ = ["ExplicitEnvironmentSpec", "ExplicitEnvironmentEntry"]

rattler/explicit_environment/environment.py

@@ -0,0 +1,69 @@
+from pathlib import Path
+from typing import List, Optional
+
+from rattler.rattler import PyExplicitEnvironmentSpec as _PyExplicitEnvironmentSpec
+from rattler.rattler import PyExplicitEnvironmentEntry as _PyExplicitEnvironmentEntry
+from rattler.platform import Platform
+
+
+class ExplicitEnvironmentEntry:
+    """A wrapper around an explicit environment entry which represents a URL to a package"""
+
+    def __init__(self, inner: _PyExplicitEnvironmentEntry) -> None:
+        self._inner = inner
+
+    @property
+    def url(self) -> str:
+        """Returns the URL of the package"""
+        return self._inner.url()
+
+
+class ExplicitEnvironmentSpec:
+    """The explicit environment (e.g. env.txt) file that contains a list of all URLs in a environment"""
+
+    def __init__(self, inner: _PyExplicitEnvironmentSpec) -> None:
+        self._inner = inner
+
+    @classmethod
+    def from_path(cls, path: Path) -> "ExplicitEnvironmentSpec":
+        """Parses the object from a file specified by a `path`, using a format appropriate for the file type.
+
+        For example, if the file is in text format, this function reads the data from the file at
+        the specified path, parses the text and returns the resulting object. If the file is
+        not in a parsable format or if the file could not be read, this function raises an error.
+        """
+        return cls(_PyExplicitEnvironmentSpec.from_path(path))
+
+    @classmethod
+    def from_str(cls, content: str) -> "ExplicitEnvironmentSpec":
+        """
+        Parses the object from a string containing the explicit environment specification
+
+        Examples:
+
+        ```python
+        >>> spec = ExplicitEnvironmentSpec.from_str('''@EXPLICIT
+        ... # platform: linux-64
+        ... http://repo.anaconda.com/pkgs/main/linux-64/python-3.9.0-h3.tar.bz2
+        ... ''')
+        >>> spec.platform
+        Platform(linux-64)
+        >>> spec.packages[0].url
+        'http://repo.anaconda.com/pkgs/main/linux-64/python-3.9.0-h3.tar.bz2'
+        >>>
+        ```
+        """
+        return cls(_PyExplicitEnvironmentSpec.from_str(content))
+
+    @property
+    def platform(self) -> Optional[Platform]:
+        """Returns the platform specified in the explicit environment specification"""
+        platform = self._inner.platform()
+        if platform is not None:
+            return Platform._from_py_platform(platform)
+        return None
+
+    @property
+    def packages(self) -> List[ExplicitEnvironmentEntry]:
+        """Returns the environment entries (URLs) specified in the explicit environment specification"""
+        return [ExplicitEnvironmentEntry(p) for p in self._inner.packages()]

rattler/install/installer.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 import os
 from typing import List, Optional
 
-from rattler.networking.authenticated_client import AuthenticatedClient
+from rattler.networking.client import Client
 from rattler.platform.platform import Platform
 from rattler.prefix.prefix_record import PrefixRecord
 from rattler.repo_data.record import RepoDataRecord
@@ -18,7 +18,7 @@ async def install(
     platform: Optional[Platform] = None,
     execute_link_scripts: bool = False,
     show_progress: bool = True,
-    client: Optional[AuthenticatedClient] = None,
+    client: Optional[Client] = None,
 ) -> None:
     """
     Create an environment by downloading and linking the `dependencies` in

rattler/networking/__init__.py

@@ -1,4 +1,5 @@
-from rattler.networking.authenticated_client import AuthenticatedClient
+from rattler.networking.client import Client
+from rattler.networking.middleware import MirrorMiddleware, AuthenticationMiddleware
 from rattler.networking.fetch_repo_data import fetch_repo_data
 
-__all__ = ["AuthenticatedClient", "fetch_repo_data"]
+__all__ = ["fetch_repo_data", "Client", "MirrorMiddleware", "AuthenticationMiddleware"]

rattler/networking/client.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+from rattler.rattler import PyClientWithMiddleware
+from rattler.networking.middleware import AuthenticationMiddleware, MirrorMiddleware
+
+
+class Client:
+    """
+    A client that can be used to make requests.
+    """
+
+    def __init__(self, middlewares: list[AuthenticationMiddleware | MirrorMiddleware] | None = None) -> None:
+        self._client = PyClientWithMiddleware(
+            [middleware._middleware for middleware in middlewares] if middlewares else None
+        )
+
+    @classmethod
+    def _from_ffi_object(cls, client: PyClientWithMiddleware) -> Client:
+        """
+        Construct py-rattler Client from PyClientWithMiddleware FFI object.
+        """
+        client = cls.__new__(cls)
+        client._client = client
+        return client
+
+    def __repr__(self) -> str:
+        """
+        Returns a representation of the Client
+
+        Examples
+        --------
+        ```python
+        >>> Client()
+        Client()
+        >>>
+        ```
+        """
+        return f"{type(self).__name__}()"
+
+    @staticmethod
+    def authenticated_client() -> Client:
+        """
+        Returns an authenticated client.
+
+        Examples
+        --------
+        ```python
+        >>> Client.authenticated_client()
+        Client()
+        >>>
+        ```
+        """
+        return Client([AuthenticationMiddleware()])

rattler/networking/fetch_repo_data.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 from typing import Callable, List, Optional, Union, TYPE_CHECKING
 
 
+from rattler.networking.client import Client
 from rattler.rattler import py_fetch_repo_data
 from rattler.repo_data.sparse import SparseRepoData
 
@@ -17,6 +18,7 @@ async def fetch_repo_data(
     platforms: List[Platform],
     cache_path: Union[str, os.PathLike[str]],
     callback: Optional[Callable[[int, int], None]],
+    client: Optional[Client] = None,
 ) -> List[SparseRepoData]:
     """
     Returns a list of RepoData for given channels and platform.
@@ -29,6 +31,7 @@ async def fetch_repo_data(
                     be downloaded.
         callback: A `Callable[[int, int], None]` to report the download
                   progress of repo data.
+        client: A `Client` to use for fetching the repo data.
 
     Returns:
         A list of `SparseRepoData` for requested channels and platforms.
@@ -38,6 +41,7 @@ async def fetch_repo_data(
         [platform._inner for platform in platforms],
         cache_path,
         callback,
+        client,
     )
 
     return [SparseRepoData._from_py_sparse_repo_data(repo_data) for repo_data in repo_data_list]

rattler/networking/middleware.py

@@ -0,0 +1,63 @@
+from __future__ import annotations
+from rattler.rattler import PyMirrorMiddleware, PyAuthenticationMiddleware
+
+
+class MirrorMiddleware:
+    def __init__(self, mirrors: dict[str, list[str]]) -> None:
+        """
+        Create a new MirrorMiddleware instance.
+        The mirrors argument should be a dictionary where the keys are the
+        original mirror URLs and the values are lists of mirror URLs to
+        replace the original mirror with.
+
+        Examples
+        --------
+        ```python
+        >>> from rattler.networking import Client
+        >>> middleware = MirrorMiddleware({"https://conda.anaconda.org/conda-forge": ["https://repo.prefix.dev/conda-forge"]})
+        >>> middleware
+        MirrorMiddleware()
+        >>> Client([middleware])
+        Client()
+        >>>
+        ```
+        """
+        self._middleware = PyMirrorMiddleware(mirrors)
+
+    def __repr__(self) -> str:
+        """
+        Returns a representation of the Middleware
+
+        Examples
+        --------
+        ```python
+        >>> middleware = MirrorMiddleware({"https://conda.anaconda.org/conda-forge": ["https://repo.prefix.dev/conda-forge"]})
+        >>> middleware
+        MirrorMiddleware()
+        >>>
+        ```
+        """
+        return f"{type(self).__name__}()"
+
+
+class AuthenticationMiddleware:
+    def __init__(self) -> None:
+        self._middleware = PyAuthenticationMiddleware()
+
+    def __repr__(self) -> str:
+        """
+        Returns a representation of the Middleware
+
+        Examples
+        --------
+        ```python
+        >>> from rattler.networking import Client
+        >>> middleware = AuthenticationMiddleware()
+        >>> middleware
+        AuthenticationMiddleware()
+        >>> Client([middleware])
+        Client()
+        >>>
+        ```
+        """
+        return f"{type(self).__name__}()"

rattler/package/no_arch_type.py

@@ -10,13 +10,10 @@ class NoArchType:
     def __init__(self, noarch: Optional[str] = None) -> None:
         if noarch is None:
             self._noarch = PyNoArchType.none()
-            self._source = None
         elif noarch == "python":
             self._noarch = PyNoArchType.python()
-            self._source = "python"
         elif noarch == "generic":
             self._noarch = PyNoArchType.generic()
-            self._source = "generic"
         else:
             raise ValueError(
                 "NoArchType constructor received unsupported value " f"{noarch} for the `noarch` parameter"
@@ -27,7 +24,6 @@ class NoArchType:
         """Construct Rattler NoArchType from FFI PyNoArchType object."""
         no_arch_type = cls.__new__(cls)
         no_arch_type._noarch = py_no_arch_type
-        no_arch_type._source = py_no_arch_type
         return no_arch_type
 
     @property
@@ -137,4 +133,10 @@ class NoArchType:
         >>>
         ```
         """
-        return f'NoArchType("{self._source}")'
+
+        if self._noarch.is_python:
+            return 'NoArchType("python")'
+        elif self._noarch.is_generic:
+            return 'NoArchType("generic")'
+        else:
+            return "NoArchType(None)"

rattler/package/package_name.py

@@ -101,10 +101,15 @@ class PackageName:
         >>> PackageName("test-abc") == PackageName("test-ABC")
         True
         >>> PackageName("test-abc") == "test-abc"
+        True
+        >>> PackageName("test-abc") == "not-test-abc"
         False
         >>>
         ```
         """
+        if isinstance(other, str):
+            return self._name == PyPackageName(other)
+
         if not isinstance(other, PackageName):
             return False
 
@@ -124,10 +129,15 @@ class PackageName:
         >>> PackageName("test-abc") != PackageName("abc-test")
         True
         >>> PackageName("test-abc") != "test-abc"
+        False
+        >>> PackageName("test-abc") != "not-test-abc"
         True
         >>>
         ```
         """
+        if isinstance(other, str):
+            return self._name != PyPackageName(other)
+
         if not isinstance(other, PackageName):
             return True
 

rattler/package/paths_json.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 import os
 from pathlib import Path
-from typing import List, Optional
+from typing import List, Optional, Literal
 from rattler.rattler import (
     PyPathsJson,
     PyPathsEntry,
@@ -456,6 +456,9 @@ class FileMode:
 
     _inner: PyFileMode | None = None
 
+    def __init__(self, file_mode: Literal["binary", "text"]) -> None:
+        self._inner = PyFileMode(file_mode)
+
     @property
     def binary(self) -> bool:
         """

rattler/platform/platform.py

@@ -1,5 +1,5 @@
 from __future__ import annotations
-from typing import Any, Dict, Literal, Tuple
+from typing import Any, Dict, Literal, Tuple, Optional
 
 from rattler.rattler import PyPlatform
 from rattler.platform.arch import Arch
@@ -174,3 +174,18 @@ class Platform(metaclass=PlatformSingleton):
         ```
         """
         return Arch._from_py_arch(self._inner.arch())
+
+    @property
+    def only_platform(self) -> Optional[str]:
+        """
+        Return the platform without the architecture.
+
+        Examples
+        --------
+        ```python
+        >>> Platform("linux-64").only_platform
+        'linux'
+        >>>
+        ```
+        """
+        return self._inner.only_platform