extensionmethods 0.1.0__tar.gz

extensionmethods-0.1.0/.github/workflows/build-test-publish.yml

@@ -0,0 +1,133 @@
+name: Build, unittest and publish
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+  workflow_dispatch:
+
+env:
+  UV_VERSION: "0.9.7"
+
+jobs:
+  build:
+    name: Build package
+    runs-on: "ubuntu-latest"
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # required for setuptools-scm
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: ${{ env.UV_VERSION }}
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install the project
+        run: uv sync --locked --dev
+
+      - name: Build packages
+        run: uv build --all-packages
+
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  test:
+    name: Test package
+    runs-on: "ubuntu-latest"
+    needs:
+      - build
+    strategy:
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: ${{ env.UV_VERSION }}
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Install package
+        run: |
+          uv venv
+          uv pip install dist/*.whl
+          uv pip install pytest
+
+      - name: Test with pytest
+        run: |
+          uv run pytest
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    if: startsWith(github.ref, 'refs/tags/') # only publish on tag pushes
+    needs:
+      - test
+    runs-on: ubuntu-latest
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/extensionmethods
+
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          verbose: true
+
+  publish-pypi:
+    name: Publish to PyPI
+    if: startsWith(github.ref, 'refs/tags/') # only publish on tag pushes
+    needs:
+      - publish-testpypi
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/extensionmethods
+
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

extensionmethods-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

extensionmethods-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff version.
+    rev: v0.11.2 # Same as VS Code extension
+    hooks:
+      # Run the linter.
+      - id: ruff
+        args:
+          - --fix
+      # Run the formatter.
+      - id: ruff-format

extensionmethods-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

extensionmethods-0.1.0/.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "charliermarsh.ruff"
+    ]
+}

extensionmethods-0.1.0/.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+    "python.analysis.typeCheckingMode": "standard",
+    "editor.codeActionsOnSave": {
+        "source.fixAll": "always",
+        "source.organizeImports.ruff": "always"
+    },
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

extensionmethods-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pim Mostert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

extensionmethods-0.1.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: extensionmethods
+Version: 0.1.0
+Summary: Add your description here
+Author-email: Pim Mostert <pim.mostert@pimmostert.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Pim-Mostert/extensionmethods
+Project-URL: Issues, https://github.com/Pim-Mostert/extensionmethods/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# extensionmethods
+
+Mimics C#-style extension methods in Python.
+
+`extensionmethods` is a tiny package that lets you “attach” functions to existing types without modifying their source code, enabling method-like syntax, better chaining, and cleaner separation of optional dependencies.
+
+- [extensionmethods](#extensionmethods)
+  - [Example usage](#example-usage)
+  - [Type safety and type checking](#type-safety-and-type-checking)
+  - [Installation](#installation)
+  - [Why use extension methods?](#why-use-extension-methods)
+    - [Readability through chaining](#readability-through-chaining)
+    - [Modularity and dependency isolation](#modularity-and-dependency-isolation)
+  - [Known caveats](#known-caveats)
+    - [IDE type hints may be misleading](#ide-type-hints-may-be-misleading)
+    - [Uses the `|` operator (`__ror__`)](#uses-the--operator-__ror__)
+  - [License](#license)
+
+
+## Example usage
+
+In C#, you can add methods to existing types:
+
+```csharp
+public static class IntExtensions
+{
+    public static int Double(this int x)
+    {
+        return x * 2;
+    }
+}
+
+int result = 7.Double();
+```
+
+You get method syntax without modifying `int`.
+
+With the `extensionmethods` package you can achieve similiar functionality like so:
+
+```python
+from extensionmethods import extension
+
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+
+result = 7 | double()
+print(result)  # 14
+```
+
+With parameters:
+
+```python
+@extension(to=int)
+def add_then_multiply(x: int, to_add: int, to_multiply: int) -> int:
+    return (x + to_add) * to_multiply
+
+result = 7 | add_then_multiply(11, 3)
+print(result)  # 54
+```
+
+The value on the left side becomes the first argument of the function.
+
+## Type safety and type checking
+
+The extension methods are type-aware.
+
+When you declare an extension, you bind it to a specific type:
+
+```python
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+```
+
+This gives you safety at two levels:
+
+- **IDE / static type checking**
+    Type checkers and editors can detect incorrect usage:
+
+    ```python
+    "hello" | double()  # type error
+    ```
+
+    Your IDE (e.g. VS Code) can flag this because the extension is declared for `int`, not `str`.
+
+- **Runtime enforcement**
+
+    Even if type checking is bypassed, the library validates the type at runtime:
+
+    ```python
+    >>> "hello" | double()
+    TypeError: Extension 'double' can only be used on 'int', not 'str'
+    ```
+
+## Installation
+
+Using **pip**:
+
+```bash
+pip install extensionmethods
+```
+
+Using **uv**:
+
+```bash
+uv pip install extensionmethods
+```
+
+## Why use extension methods?
+
+### Readability through chaining
+
+Instead of nested calls:
+
+```python
+result = normalize(scale(center(data)))
+```
+
+You can express the same flow step-by-step:
+
+```python
+result = data | center() | scale() | normalize()
+```
+
+This reads left-to-right and mirrors how data is conceptually transformed.
+
+### Modularity and dependency isolation
+
+Suppose you maintain a core class:
+
+```python
+class Dataset:
+    ...
+```
+
+You want export helpers:
+
+- `to_pandas()`
+- `to_numpy()`
+- `to_torch()`
+
+If you put these methods directly on `Dataset`, your core package must depend on `pandas`, `numpy`, and `torch`.
+
+Instead, keep the core dependency-free:
+
+```python
+# core package
+class Dataset:
+    ...
+```
+
+Then provide optional extensions:
+
+```python
+# dataset_pandas package
+import pandas as pd
+from extensionmethods import extension
+from core import Dataset
+
+@extension(to=Dataset)
+def to_pandas(ds: Dataset) -> pd.DataFrame:
+    ...
+```
+
+Usage:
+
+```python
+import dataset_pandas  # registers the extension
+
+df = dataset | to_pandas()
+```
+
+Now:
+
+- The core package has zero heavy dependencies
+- Users only install what they need
+- Functionality stays logically grouped
+
+## Known caveats
+
+### IDE type hints may be misleading
+
+Editors like VS Code may show hover/type information for the decorator wrapper, not the original function.
+
+```python
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+```
+
+Hovering `double` may not show the expected signature `(x: int) -> int`, but instead `(function) double: ExtensionDecoratorFactory[int]`.
+
+### Uses the `|` operator (`__ror__`)
+
+The system works by overriding the right-side bitwise OR operator.
+
+```python
+result = value | extension_call()
+```
+
+This only works if the left-hand type does not fully consume the `|` operator itself.
+
+For example, sets already use `|`:
+
+```python
+{1, 2} | {3}   # set union
+```
+
+If a type defines its own `__or__` in a way that prevents fallback to `__ror__`, the extension method will not run.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for details.

extensionmethods-0.1.0/README.md

@@ -0,0 +1,214 @@
+# extensionmethods
+
+Mimics C#-style extension methods in Python.
+
+`extensionmethods` is a tiny package that lets you “attach” functions to existing types without modifying their source code, enabling method-like syntax, better chaining, and cleaner separation of optional dependencies.
+
+- [extensionmethods](#extensionmethods)
+  - [Example usage](#example-usage)
+  - [Type safety and type checking](#type-safety-and-type-checking)
+  - [Installation](#installation)
+  - [Why use extension methods?](#why-use-extension-methods)
+    - [Readability through chaining](#readability-through-chaining)
+    - [Modularity and dependency isolation](#modularity-and-dependency-isolation)
+  - [Known caveats](#known-caveats)
+    - [IDE type hints may be misleading](#ide-type-hints-may-be-misleading)
+    - [Uses the `|` operator (`__ror__`)](#uses-the--operator-__ror__)
+  - [License](#license)
+
+
+## Example usage
+
+In C#, you can add methods to existing types:
+
+```csharp
+public static class IntExtensions
+{
+    public static int Double(this int x)
+    {
+        return x * 2;
+    }
+}
+
+int result = 7.Double();
+```
+
+You get method syntax without modifying `int`.
+
+With the `extensionmethods` package you can achieve similiar functionality like so:
+
+```python
+from extensionmethods import extension
+
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+
+result = 7 | double()
+print(result)  # 14
+```
+
+With parameters:
+
+```python
+@extension(to=int)
+def add_then_multiply(x: int, to_add: int, to_multiply: int) -> int:
+    return (x + to_add) * to_multiply
+
+result = 7 | add_then_multiply(11, 3)
+print(result)  # 54
+```
+
+The value on the left side becomes the first argument of the function.
+
+## Type safety and type checking
+
+The extension methods are type-aware.
+
+When you declare an extension, you bind it to a specific type:
+
+```python
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+```
+
+This gives you safety at two levels:
+
+- **IDE / static type checking**
+    Type checkers and editors can detect incorrect usage:
+
+    ```python
+    "hello" | double()  # type error
+    ```
+
+    Your IDE (e.g. VS Code) can flag this because the extension is declared for `int`, not `str`.
+
+- **Runtime enforcement**
+
+    Even if type checking is bypassed, the library validates the type at runtime:
+
+    ```python
+    >>> "hello" | double()
+    TypeError: Extension 'double' can only be used on 'int', not 'str'
+    ```
+
+## Installation
+
+Using **pip**:
+
+```bash
+pip install extensionmethods
+```
+
+Using **uv**:
+
+```bash
+uv pip install extensionmethods
+```
+
+## Why use extension methods?
+
+### Readability through chaining
+
+Instead of nested calls:
+
+```python
+result = normalize(scale(center(data)))
+```
+
+You can express the same flow step-by-step:
+
+```python
+result = data | center() | scale() | normalize()
+```
+
+This reads left-to-right and mirrors how data is conceptually transformed.
+
+### Modularity and dependency isolation
+
+Suppose you maintain a core class:
+
+```python
+class Dataset:
+    ...
+```
+
+You want export helpers:
+
+- `to_pandas()`
+- `to_numpy()`
+- `to_torch()`
+
+If you put these methods directly on `Dataset`, your core package must depend on `pandas`, `numpy`, and `torch`.
+
+Instead, keep the core dependency-free:
+
+```python
+# core package
+class Dataset:
+    ...
+```
+
+Then provide optional extensions:
+
+```python
+# dataset_pandas package
+import pandas as pd
+from extensionmethods import extension
+from core import Dataset
+
+@extension(to=Dataset)
+def to_pandas(ds: Dataset) -> pd.DataFrame:
+    ...
+```
+
+Usage:
+
+```python
+import dataset_pandas  # registers the extension
+
+df = dataset | to_pandas()
+```
+
+Now:
+
+- The core package has zero heavy dependencies
+- Users only install what they need
+- Functionality stays logically grouped
+
+## Known caveats
+
+### IDE type hints may be misleading
+
+Editors like VS Code may show hover/type information for the decorator wrapper, not the original function.
+
+```python
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+```
+
+Hovering `double` may not show the expected signature `(x: int) -> int`, but instead `(function) double: ExtensionDecoratorFactory[int]`.
+
+### Uses the `|` operator (`__ror__`)
+
+The system works by overriding the right-side bitwise OR operator.
+
+```python
+result = value | extension_call()
+```
+
+This only works if the left-hand type does not fully consume the `|` operator itself.
+
+For example, sets already use `|`:
+
+```python
+{1, 2} | {3}   # set union
+```
+
+If a type defines its own `__or__` in a way that prevents fallback to `__ror__`, the extension method will not run.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for details.

extensionmethods-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "extensionmethods"
+dynamic = ["version"]
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Pim Mostert", email = "pim.mostert@pimmostert.com" }
+]
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/Pim-Mostert/extensionmethods"
+Issues = "https://github.com/Pim-Mostert/extensionmethods/issues"
+
+[build-system]
+requires = ["setuptools", "wheel", "setuptools-scm"]
+build-backend = "setuptools.build_meta"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.5.1",
+    "pytest>=9.0.2",
+]
+
+[tool.setuptools_scm]
+tag_regex = 'v(\d+\.\d+\.\d+)$' # vX.Y.Z (major, minor, patch)

extensionmethods-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

extensionmethods-0.1.0/src/extensionmethods/__init__.py

@@ -0,0 +1,12 @@
+from importlib.metadata import PackageNotFoundError, version
+
+from .extensions import extension
+
+try:
+    __version__ = version("extensionmethods")
+except PackageNotFoundError:
+    __version__ = "noinstall"
+
+__all__ = [
+    "extension",
+]

extensionmethods-0.1.0/src/extensionmethods/extensions.py

@@ -0,0 +1,44 @@
+from functools import wraps
+from typing import Any, Callable, Generic, Type, TypeVar
+
+T = TypeVar("T")
+
+
+class ExtensionDecorator(Generic[T]):
+    def __init__(self, func: Callable[..., Any], args, kwargs, to: Type[T]):
+        self._func = func
+        self._to = to
+        self._args = args
+        self._kwargs = kwargs
+
+    def __call__(self, _: Any) -> Any:
+        raise NotImplementedError("Don't call an extension method directly.")
+
+    def __ror__(self, other: T) -> Any:
+        if not isinstance(other, self._to):
+            raise TypeError(
+                f"Extension '{self._func.__name__}' can only be used on '{self._to.__name__}', "
+                f"not '{type(other).__name__}'"
+            )
+
+        return self._func(other, *self._args, **self._kwargs)
+
+
+class ExtensionDecoratorFactory(Generic[T]):
+    def __init__(self, func: Callable[..., Any], to: Type[T]):
+        self._func = func
+        self._to = to
+
+        wraps(func)(self)
+
+    def __call__(self, *args, **kwargs) -> ExtensionDecorator[T]:
+        return ExtensionDecorator(self._func, args, kwargs, self._to)
+
+
+def extension(
+    *, to: Type[T]
+) -> Callable[[Callable[..., Any]], ExtensionDecoratorFactory[T]]:
+    def wrapper(func: Callable[..., Any]) -> ExtensionDecoratorFactory[T]:
+        return ExtensionDecoratorFactory(func, to)
+
+    return wrapper

extensionmethods-0.1.0/src/extensionmethods.egg-info/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: extensionmethods
+Version: 0.1.0
+Summary: Add your description here
+Author-email: Pim Mostert <pim.mostert@pimmostert.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Pim-Mostert/extensionmethods
+Project-URL: Issues, https://github.com/Pim-Mostert/extensionmethods/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# extensionmethods
+
+Mimics C#-style extension methods in Python.
+
+`extensionmethods` is a tiny package that lets you “attach” functions to existing types without modifying their source code, enabling method-like syntax, better chaining, and cleaner separation of optional dependencies.
+
+- [extensionmethods](#extensionmethods)
+  - [Example usage](#example-usage)
+  - [Type safety and type checking](#type-safety-and-type-checking)
+  - [Installation](#installation)
+  - [Why use extension methods?](#why-use-extension-methods)
+    - [Readability through chaining](#readability-through-chaining)
+    - [Modularity and dependency isolation](#modularity-and-dependency-isolation)
+  - [Known caveats](#known-caveats)
+    - [IDE type hints may be misleading](#ide-type-hints-may-be-misleading)
+    - [Uses the `|` operator (`__ror__`)](#uses-the--operator-__ror__)
+  - [License](#license)
+
+
+## Example usage
+
+In C#, you can add methods to existing types:
+
+```csharp
+public static class IntExtensions
+{
+    public static int Double(this int x)
+    {
+        return x * 2;
+    }
+}
+
+int result = 7.Double();
+```
+
+You get method syntax without modifying `int`.
+
+With the `extensionmethods` package you can achieve similiar functionality like so:
+
+```python
+from extensionmethods import extension
+
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+
+result = 7 | double()
+print(result)  # 14
+```
+
+With parameters:
+
+```python
+@extension(to=int)
+def add_then_multiply(x: int, to_add: int, to_multiply: int) -> int:
+    return (x + to_add) * to_multiply
+
+result = 7 | add_then_multiply(11, 3)
+print(result)  # 54
+```
+
+The value on the left side becomes the first argument of the function.
+
+## Type safety and type checking
+
+The extension methods are type-aware.
+
+When you declare an extension, you bind it to a specific type:
+
+```python
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+```
+
+This gives you safety at two levels:
+
+- **IDE / static type checking**
+    Type checkers and editors can detect incorrect usage:
+
+    ```python
+    "hello" | double()  # type error
+    ```
+
+    Your IDE (e.g. VS Code) can flag this because the extension is declared for `int`, not `str`.
+
+- **Runtime enforcement**
+
+    Even if type checking is bypassed, the library validates the type at runtime:
+
+    ```python
+    >>> "hello" | double()
+    TypeError: Extension 'double' can only be used on 'int', not 'str'
+    ```
+
+## Installation
+
+Using **pip**:
+
+```bash
+pip install extensionmethods
+```
+
+Using **uv**:
+
+```bash
+uv pip install extensionmethods
+```
+
+## Why use extension methods?
+
+### Readability through chaining
+
+Instead of nested calls:
+
+```python
+result = normalize(scale(center(data)))
+```
+
+You can express the same flow step-by-step:
+
+```python
+result = data | center() | scale() | normalize()
+```
+
+This reads left-to-right and mirrors how data is conceptually transformed.
+
+### Modularity and dependency isolation
+
+Suppose you maintain a core class:
+
+```python
+class Dataset:
+    ...
+```
+
+You want export helpers:
+
+- `to_pandas()`
+- `to_numpy()`
+- `to_torch()`
+
+If you put these methods directly on `Dataset`, your core package must depend on `pandas`, `numpy`, and `torch`.
+
+Instead, keep the core dependency-free:
+
+```python
+# core package
+class Dataset:
+    ...
+```
+
+Then provide optional extensions:
+
+```python
+# dataset_pandas package
+import pandas as pd
+from extensionmethods import extension
+from core import Dataset
+
+@extension(to=Dataset)
+def to_pandas(ds: Dataset) -> pd.DataFrame:
+    ...
+```
+
+Usage:
+
+```python
+import dataset_pandas  # registers the extension
+
+df = dataset | to_pandas()
+```
+
+Now:
+
+- The core package has zero heavy dependencies
+- Users only install what they need
+- Functionality stays logically grouped
+
+## Known caveats
+
+### IDE type hints may be misleading
+
+Editors like VS Code may show hover/type information for the decorator wrapper, not the original function.
+
+```python
+@extension(to=int)
+def double(x: int) -> int:
+    return x * 2
+```
+
+Hovering `double` may not show the expected signature `(x: int) -> int`, but instead `(function) double: ExtensionDecoratorFactory[int]`.
+
+### Uses the `|` operator (`__ror__`)
+
+The system works by overriding the right-side bitwise OR operator.
+
+```python
+result = value | extension_call()
+```
+
+This only works if the left-hand type does not fully consume the `|` operator itself.
+
+For example, sets already use `|`:
+
+```python
+{1, 2} | {3}   # set union
+```
+
+If a type defines its own `__or__` in a way that prevents fallback to `__ror__`, the extension method will not run.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for details.

extensionmethods-0.1.0/src/extensionmethods.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+.gitignore
+.pre-commit-config.yaml
+.python-version
+LICENSE
+README.md
+pyproject.toml
+uv.lock
+.github/workflows/build-test-publish.yml
+.vscode/extensions.json
+.vscode/settings.json
+src/extensionmethods/__init__.py
+src/extensionmethods/extensions.py
+src/extensionmethods.egg-info/PKG-INFO
+src/extensionmethods.egg-info/SOURCES.txt
+src/extensionmethods.egg-info/dependency_links.txt
+src/extensionmethods.egg-info/top_level.txt
+tests/test_extensions.py

extensionmethods-0.1.0/src/extensionmethods.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

extensionmethods-0.1.0/src/extensionmethods.egg-info/top_level.txt

@@ -0,0 +1 @@
+extensionmethods

extensionmethods-0.1.0/tests/test_extensions.py

@@ -0,0 +1,53 @@
+import pytest
+
+from extensionmethods import extension
+
+
+def test_extension():
+    # Assign
+    @extension(to=int)
+    def double(x: int) -> int:
+        return x * 2
+
+    # Act
+    output = 7 | double()
+
+    # Assert
+    assert output == 7 * 2
+
+
+def test_extension_single_parameter():
+    # Assign
+    @extension(to=int)
+    def add(x: int, to_add: int) -> int:
+        return x + to_add
+
+    # Act
+    output = 7 | add(11)
+
+    # Assert
+    assert 7 + 11 == output
+
+
+def test_extension_two_parameters():
+    # Assign
+    @extension(to=int)
+    def add_then_multiply(x: int, to_add: int, to_multiply: int) -> int:
+        return (x + to_add) * to_multiply
+
+    # Act
+    output = 7 | add_then_multiply(11, 3)
+
+    # Assert
+    assert (7 + 11) * 3 == output
+
+
+def test_extension_wrong_type():
+    # Assign
+    @extension(to=str)
+    def upper(x: str) -> str:
+        return x.upper()
+
+    # Act
+    with pytest.raises(TypeError):
+        _ = 1 | upper()  # pyright: ignore[reportOperatorIssue]

extensionmethods-0.1.0/uv.lock

@@ -0,0 +1,221 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "cfgv"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4e/b5/721b8799b04bf9afe054a3899c6cf4e880fcf8563cc71c15610242490a0c/cfgv-3.5.0.tar.gz", hash = "sha256:d5b1034354820651caa73ede66a6294d6e95c1b00acc5e9b098e917404669132", size = 7334, upload-time = "2025-11-19T20:55:51.612Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/3c/33bac158f8ab7f89b2e59426d5fe2e4f63f7ed25df84c036890172b412b5/cfgv-3.5.0-py2.py3-none-any.whl", hash = "sha256:a8dc6b26ad22ff227d2634a65cb388215ce6cc96bbcc5cfde7641ae87e8dacc0", size = 7445, upload-time = "2025-11-19T20:55:50.744Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "distlib"
+version = "0.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/96/8e/709914eb2b5749865801041647dc7f4e6d00b549cfe88b65ca192995f07c/distlib-0.4.0.tar.gz", hash = "sha256:feec40075be03a04501a973d81f633735b4b69f98b05450592310c0f401a4e0d", size = 614605, upload-time = "2025-07-17T16:52:00.465Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/33/6b/e0547afaf41bf2c42e52430072fa5658766e3d65bd4b03a563d1b6336f57/distlib-0.4.0-py2.py3-none-any.whl", hash = "sha256:9659f7d87e46584a30b5780e43ac7a2143098441670ff0a49d5f9034c54a6c16", size = 469047, upload-time = "2025-07-17T16:51:58.613Z" },
+]
+
+[[package]]
+name = "extensionmethods"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pre-commit" },
+    { name = "pytest" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pre-commit", specifier = ">=4.5.1" },
+    { name = "pytest", specifier = ">=9.0.2" },
+]
+
+[[package]]
+name = "filelock"
+version = "3.20.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1d/65/ce7f1b70157833bf3cb851b556a37d4547ceafc158aa9b34b36782f23696/filelock-3.20.3.tar.gz", hash = "sha256:18c57ee915c7ec61cff0ecf7f0f869936c7c30191bb0cf406f1341778d0834e1", size = 19485, upload-time = "2026-01-09T17:55:05.421Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b5/36/7fb70f04bf00bc646cd5bb45aa9eddb15e19437a28b8fb2b4a5249fac770/filelock-3.20.3-py3-none-any.whl", hash = "sha256:4b0dda527ee31078689fc205ec4f1c1bf7d56cf88b6dc9426c4f230e46c2dce1", size = 16701, upload-time = "2026-01-09T17:55:04.334Z" },
+]
+
+[[package]]
+name = "identify"
+version = "2.6.16"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5b/8d/e8b97e6bd3fb6fb271346f7981362f1e04d6a7463abd0de79e1fda17c067/identify-2.6.16.tar.gz", hash = "sha256:846857203b5511bbe94d5a352a48ef2359532bc8f6727b5544077a0dcfb24980", size = 99360, upload-time = "2026-01-12T18:58:58.201Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b8/58/40fbbcefeda82364720eba5cf2270f98496bdfa19ea75b4cccae79c698e6/identify-2.6.16-py2.py3-none-any.whl", hash = "sha256:391ee4d77741d994189522896270b787aed8670389bfd60f326d677d64a6dfb0", size = 99202, upload-time = "2026-01-12T18:58:56.627Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "nodeenv"
+version = "1.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/bf/d1bda4f6168e0b2e9e5958945e01910052158313224ada5ce1fb2e1113b8/nodeenv-1.10.0.tar.gz", hash = "sha256:996c191ad80897d076bdfba80a41994c2b47c68e224c542b48feba42ba00f8bb", size = 55611, upload-time = "2025-12-20T14:08:54.006Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl", hash = "sha256:5bb13e3eed2923615535339b3c620e76779af4cb4c6a90deccc9e36b274d3827", size = 23438, upload-time = "2025-12-20T14:08:52.782Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+]
+
+[[package]]
+name = "platformdirs"
+version = "4.5.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cf/86/0248f086a84f01b37aaec0fa567b397df1a119f73c16f6c7a9aac73ea309/platformdirs-4.5.1.tar.gz", hash = "sha256:61d5cdcc6065745cdd94f0f878977f8de9437be93de97c1c12f853c9c0cdcbda", size = 21715, upload-time = "2025-12-05T13:52:58.638Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/28/3bfe2fa5a7b9c46fe7e13c97bda14c895fb10fa2ebf1d0abb90e0cea7ee1/platformdirs-4.5.1-py3-none-any.whl", hash = "sha256:d03afa3963c806a9bed9d5125c8f4cb2fdaf74a55ab60e5d59b3fde758104d31", size = 18731, upload-time = "2025-12-05T13:52:56.823Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pre-commit"
+version = "4.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/40/f1/6d86a29246dfd2e9b6237f0b5823717f60cad94d47ddc26afa916d21f525/pre_commit-4.5.1.tar.gz", hash = "sha256:eb545fcff725875197837263e977ea257a402056661f09dae08e4b149b030a61", size = 198232, upload-time = "2025-12-16T21:14:33.552Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/19/fd3ef348460c80af7bb4669ea7926651d1f95c23ff2df18b9d24bab4f3fa/pre_commit-4.5.1-py2.py3-none-any.whl", hash = "sha256:3b3afd891e97337708c1674210f8eba659b52a38ea5f822ff142d10786221f77", size = 226437, upload-time = "2025-12-16T21:14:32.409Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
+[[package]]
+name = "pyyaml"
+version = "6.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" },
+    { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" },
+    { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" },
+    { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
+    { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
+    { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
+    { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
+    { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
+    { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
+    { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
+    { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
+    { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
+    { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
+    { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
+    { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
+    { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
+    { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
+    { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
+]
+
+[[package]]
+name = "virtualenv"
+version = "20.36.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/aa/a3/4d310fa5f00863544e1d0f4de93bddec248499ccf97d4791bc3122c9d4f3/virtualenv-20.36.1.tar.gz", hash = "sha256:8befb5c81842c641f8ee658481e42641c68b5eab3521d8e092d18320902466ba", size = 6032239, upload-time = "2026-01-09T18:21:01.296Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6a/2a/dc2228b2888f51192c7dc766106cd475f1b768c10caaf9727659726f7391/virtualenv-20.36.1-py3-none-any.whl", hash = "sha256:575a8d6b124ef88f6f51d56d656132389f961062a9177016a50e4f507bbcc19f", size = 6008258, upload-time = "2026-01-09T18:20:59.425Z" },
+]