nox-uv 0.1.0__py3-none-any.whl

nox_uv/__init__.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+from collections.abc import Sequence
+import functools
+from typing import Any, Callable, TypeVar
+
+import nox
+
+R = TypeVar("R")
+
+Python = Sequence[str] | str | bool | None
+
+
+def session(
+    *args: Any,
+    python: Python | None = None,
+    reuse_venv: bool | None = None,
+    name: str | None = None,
+    venv_backend: Any | None = None,
+    venv_params: Sequence[str] = (),
+    tags: Sequence[str] | None = None,
+    default: bool = True,
+    requires: Sequence[str] | None = None,
+    uv_groups: Sequence[str] = (),
+    uv_extras: Sequence[str] = (),
+    uv_all_extras: bool = False,
+    uv_all_groups: bool = False,
+) -> Callable[..., R]:
+    """Drop-in replacement for the :func:`nox.session` decorator.
+
+    Use this decorator instead of ``@nox.session``. Session functions are passed
+    :class:`Session` instead of :class:`nox.sessions.Session`; otherwise, the
+    decorators work exactly the same.
+
+    Args:
+        args: Positional arguments are forwarded to ``nox.session``.
+        kwargs: Keyword arguments are forwarded to ``nox.session``.
+
+    Returns:
+        The decorated session function.
+    """
+    if not args:
+        return functools.partial(
+            session,
+            python=python,
+            reuse_venv=reuse_venv,
+            name=name,
+            venv_backend=venv_backend,
+            venv_params=venv_params,
+            tags=tags,
+            default=default,
+            requires=requires,
+            uv_groups=uv_groups,
+            uv_extras=uv_extras,
+            uv_all_extras=uv_all_extras,
+            uv_all_groups=uv_all_groups,
+        )  # type: ignore
+
+    [function] = args
+
+    is_uv = venv_backend == "uv"
+
+    # Create the `uv sync` command
+    sync_cmd = ["uv", "sync", "--no-default-groups"]
+
+    # Add the groups
+    for g in uv_groups:
+        sync_cmd.append(f"--group={g}")
+
+    # Add the extras
+    for e in uv_extras:
+        sync_cmd.append(f"--extra={e}")
+
+    if uv_all_groups:
+        sync_cmd.append("--all-groups")
+
+    if uv_all_extras:
+        sync_cmd.append("--all-extras")
+
+    @functools.wraps(function)
+    def wrapper(s: nox.Session, *_args: Any, **_kwargs: Any) -> None:
+        if is_uv:
+            env: dict[str, Any] = {"UV_PROJECT_ENVIRONMENT": s.virtualenv.location}
+
+            # UV called from Nox does not respect the Python version set in the Nox session.
+            # We need to pass the Python version to UV explicitly.
+            if s.python is not None:
+                env["UV_PYTHON"] = s.python
+
+            s.run_install(
+                *sync_cmd,
+                env=env,
+            )
+        function(nox.Session(s._runner), *_args, **_kwargs)
+
+    return nox.session(  # type: ignore
+        wrapper,
+        python=python,
+        reuse_venv=reuse_venv,
+        name=name,
+        venv_backend=venv_backend,
+        venv_params=venv_params,
+        tags=tags,
+        default=default,
+        requires=requires,
+    )

nox_uv-0.1.0.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: nox-uv
+Version: 0.1.0
+Summary: Facilitate nox integration with uv for Python projects
+Project-URL: Homepage, https://github.com/dantebben/nox-uv
+Author-email: Dan Tebben <dantebben@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Requires-Python: <3.14,>=3.9
+Requires-Dist: nox>=2025.2.9
+Description-Content-Type: text/markdown
+
+## Intro
+
+This is heavliy influcenced by, but much more limited than, 
+[nox-poetry](https://nox-poetry.readthedocs.io).
+
+This is a basic drop-in replacement for `nox.session` of [nox](https://nox.thea.codes/) to be used 
+with the [uv](https://docs.astral.sh/uv/) package manager.
+
+To use, import `session` from `nox-uv` in your `nox-file`.
+
+**NOTE**: All `@session(...)` parameters are keyword-only, no positional parameters are allowed.
+
+**NOTE**: The `default_groups` defined in `pyproject.toml` are _not_ installed by default. The
+user must explicitly list the desired groups in the `uv_groups` parameter. 
+
+## Added parameters
+
+- `uv_groups`: list of `uv` dependency groups
+- `uv_extras`: list of `uv` extras
+- `uv_all_extras`: boolean to install all extras from `pyproject.toml`
+- `uv_all_groups`: boolean to install all dependency groups
+

nox_uv-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+nox_uv/__init__.py,sha256=z--lgqfIK0Gct163ynH9As7uRbcYNimDWiRUzJ4nljQ,2961
+nox_uv/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nox_uv-0.1.0.dist-info/METADATA,sha256=cB7mMOq9UKdTh1yYgv0cvcwYYTQFADDKGE-ZF84b9ag,1214
+nox_uv-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nox_uv-0.1.0.dist-info/licenses/LICENSE.txt,sha256=iTZ5ALF1isnM6Ey9Tjom0XIGBBysArB0I2NHZ9a-b8I,1067
+nox_uv-0.1.0.dist-info/RECORD,,

nox_uv-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

nox_uv-0.1.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dan Tebben
+
+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.