fix: Stop exposing dev tasks as published entry points for uv

The uv variant declared formatting, checks, tests, docs, changelog, release and clean under [project.scripts], so anyone who pip-installed the package would have those generic commands in their PATH. Drop the [project.scripts] block, delete the test_repo.cli proxy that backed it, and set nox.options (uv backend, error_on_external_run, reuse_existing_virtualenvs) at the top of the noxfile so plain uv run nox -s <session> reproduces the previous behavior. Update the GitHub Actions, GitLab, Azure DevOps and Bitbucket CI configs, the pre-commit hook and CONTRIBUTING.md to use uv run nox -s <session> instead.

Author: georgedouzas

project/.pre-commit-config.yaml.jinja

@@ -27,7 +27,7 @@ repos:
     hooks:
       - id: pytest
         name: Check pytest unit tests pass
-        entry: '{{ "pdm" if package_manager == "PDM" else "uv" }} run tests'
+        entry: '{{ "pdm tests" if package_manager == "PDM" else "uv run nox -s tests" }}'
         pass_filenames: false
         language: system
         types: [python]

project/CONTRIBUTING.md.jinja

@@ -9,43 +9,43 @@ the project for more details. You can run any of the following commands and subc
 
 ### Documentation
 
-- `{%- if package_manager == "PDM" -%}pdm docs serve` or `pdm docs{%- else -%}uv run docs{%- endif -%}`: Serve the documentation.
-- `{%- if package_manager == "PDM" -%}pdm docs build{%- else -%}uv run docs -- build{%- endif -%}`: Build locally the documentation.
+- `{%- if package_manager == "PDM" -%}pdm docs serve` or `pdm docs{%- else -%}uv run nox -s docs{%- endif -%}`: Serve the documentation.
+- `{%- if package_manager == "PDM" -%}pdm docs build{%- else -%}uv run nox -s docs -- build{%- endif -%}`: Build locally the documentation.
 
 ### Formatting
 
-- `{%- if package_manager == "PDM" -%}pdm formatting all` or `pdm formatting{%- else -%}uv run formatting{%- endif -%}`: Format both the code and docstrings.
-  - `{%- if package_manager == "PDM" -%}pdm formatting code{%- else -%}uv run formatting -- code{%- endif -%}`: Format only the code.
-  - `{%- if package_manager == "PDM" -%}pdm formatting docstrings{%- else -%}uv run formatting -- docstrings{%- endif -%}`: Format only the docstrings.
+- `{%- if package_manager == "PDM" -%}pdm formatting all` or `pdm formatting{%- else -%}uv run nox -s formatting{%- endif -%}`: Format both the code and docstrings.
+  - `{%- if package_manager == "PDM" -%}pdm formatting code{%- else -%}uv run nox -s formatting -- code{%- endif -%}`: Format only the code.
+  - `{%- if package_manager == "PDM" -%}pdm formatting docstrings{%- else -%}uv run nox -s formatting -- docstrings{%- endif -%}`: Format only the docstrings.
 
 ### Checks
 
-- `{%- if package_manager == "PDM" -%}pdm checks all` or `pdm checks{%- else -%}uv run checks{%- endif -%}`: Run all checks.
-  - `{%- if package_manager == "PDM" -%}pdm checks quality{%- else -%}uv run checks -- quality{%- endif -%}`: Check only code quality.
-  - `{%- if package_manager == "PDM" -%}pdm checks types{%- else -%}uv run checks -- types{%- endif -%}`: Check only type annotations.
-  - `{%- if package_manager == "PDM" -%}pdm checks dependencies{%- else -%}uv run checks -- dependencies{%- endif -%}`: Check only for vulnerabilities in dependencies.
+- `{%- if package_manager == "PDM" -%}pdm checks all` or `pdm checks{%- else -%}uv run nox -s checks{%- endif -%}`: Run all checks.
+  - `{%- if package_manager == "PDM" -%}pdm checks quality{%- else -%}uv run nox -s checks -- quality{%- endif -%}`: Check only code quality.
+  - `{%- if package_manager == "PDM" -%}pdm checks types{%- else -%}uv run nox -s checks -- types{%- endif -%}`: Check only type annotations.
+  - `{%- if package_manager == "PDM" -%}pdm checks dependencies{%- else -%}uv run nox -s checks -- dependencies{%- endif -%}`: Check only for vulnerabilities in dependencies.
 
 ### Tests
 
-- `{%- if package_manager == "PDM" -%}pdm tests{%- else -%}uv run tests{%- endif -%}`: Run the tests.
+- `{%- if package_manager == "PDM" -%}pdm tests{%- else -%}uv run nox -s tests{%- endif -%}`: Run the tests.
 
 ### Changelog
 
-- `{%- if package_manager == "PDM" -%}pdm changelog{%- else -%}uv run changelog{%- endif -%}`: Build the changelog.
+- `{%- if package_manager == "PDM" -%}pdm changelog{%- else -%}uv run nox -s changelog{%- endif -%}`: Build the changelog.
 
 ### Release
 
-- `{%- if package_manager == "PDM" -%}pdm release{%- else -%}uv run release{%- endif -%}`: Release a new Python package with an updated version.
+- `{%- if package_manager == "PDM" -%}pdm release{%- else -%}uv run nox -s release{%- endif -%}`: Release a new Python package with an updated version.
 
 ## Development
 
 The next steps should be followed during development:
 
 - `git checkout -b new-branch-name` to create a new branch and then modify the code.
-- `{%- if package_manager == "PDM" -%}pdm formatting{%- else -%}uv run formatting{%- endif -%}` to auto-format the code and docstrings.
-- `{%- if package_manager == "PDM" -%}pdm checks{%- else -%}uv run checks{%- endif -%}` to apply all checks.
-- `{%- if package_manager == "PDM" -%}pdm tests{%- else -%}uv run tests{%- endif -%}` to run the tests.
-- `{%- if package_manager == "PDM" -%}pdm docs serve{%- else -%}uv run docs{%- endif -%}` if you updated the documentation or the project dependencies to check that everything looks as expected.
+- `{%- if package_manager == "PDM" -%}pdm formatting{%- else -%}uv run nox -s formatting{%- endif -%}` to auto-format the code and docstrings.
+- `{%- if package_manager == "PDM" -%}pdm checks{%- else -%}uv run nox -s checks{%- endif -%}` to apply all checks.
+- `{%- if package_manager == "PDM" -%}pdm tests{%- else -%}uv run nox -s tests{%- endif -%}` to run the tests.
+- `{%- if package_manager == "PDM" -%}pdm docs serve{%- else -%}uv run nox -s docs{%- endif -%}` if you updated the documentation or the project dependencies to check that everything looks as expected.
 
 ## Commit message convention
 

project/noxfile.py.jinja

@@ -25,7 +25,11 @@ from git_changelog.cli import build_and_render
 {% if package_manager == "PDM" %}
 os.environ.update({'PDM_IGNORE_SAVED_PYTHON': '1'})
 {% endif %}
-{% if package_manager == "uv" -%}{% endif -%}
+{% if package_manager == "uv" -%}
+nox.options.default_venv_backend = 'uv'
+nox.options.error_on_external_run = True
+nox.options.reuse_existing_virtualenvs = True
+{% endif %}
 PYTHON_VERSIONS: list[str] = {{ versions }}
 FILES: list[str] = ['src', 'tests', 'docs', 'noxfile.py']
 CHANGELOG_ARGS: dict[str, Any] = {

project/pyproject.toml.jinja

@@ -223,15 +223,6 @@ dev = [
     "nox[uv]>=2024.4.15",
 ]
 
-[project.scripts]
-formatting = "{{ python_package_import_name }}.cli:formatting"
-checks = "{{ python_package_import_name }}.cli:checks"
-tests = "{{ python_package_import_name }}.cli:tests"
-docs = "{{ python_package_import_name }}.cli:docs"
-changelog = "{{ python_package_import_name }}.cli:changelog"
-release = "{{ python_package_import_name }}.cli:release"
-clean = "{{ python_package_import_name }}.cli:clean"
-
 [tool.hatch.version]
 source = "vcs"
 

project/src/{{python_package_import_name}}/{% if package_manager == 'uv' %}cli.py{% endif %}

@@ -32,7 +32,7 @@ stages:
         pdm run tests
         {% else -%}
         uv sync
-        uv run tests
+        uv run nox -s tests
         {% endif -%}
       displayName: 'Run tests'
 
@@ -72,7 +72,7 @@ stages:
         pdm run checks
         {% else -%}
         uv sync
-        uv run checks
+        uv run nox -s checks
         {% endif -%}
       displayName: 'Run quality checks'
 
@@ -102,7 +102,7 @@ stages:
         pdm run docs build
         {% else -%}
         uv sync
-        uv run docs build
+        uv run nox -s docs -- build
         {% endif -%}
       displayName: 'Build documentation'
 
@@ -138,7 +138,7 @@ stages:
         pdm run release
         {% else -%}
         uv sync
-        uv run release
+        uv run nox -s release
         {% endif -%}
       displayName: 'Release to PyPI'
       env:

project/{% if git_provider == 'Azure DevOps' %}azure-pipelines.yml{% endif %}.jinja

@@ -14,7 +14,7 @@ pipelines:
           {% else -%}
           - pip install uv
           - uv sync
-          - uv run tests
+          - uv run nox -s tests
           {% endif -%}
         artifacts:
           - coverage.xml
@@ -32,7 +32,7 @@ pipelines:
           {% else -%}
           - pip install uv
           - uv sync
-          - uv run checks
+          - uv run nox -s checks
           {% endif -%}
 
   branches:
@@ -49,7 +49,7 @@ pipelines:
             {% else -%}
             - pip install uv
             - uv sync
-            - uv run tests
+            - uv run nox -s tests
             {% endif -%}
           artifacts:
             - coverage.xml
@@ -67,7 +67,7 @@ pipelines:
             {% else -%}
             - pip install uv
             - uv sync
-            - uv run checks
+            - uv run nox -s checks
             {% endif -%}
 
       - step:
@@ -82,7 +82,7 @@ pipelines:
             {% else -%}
             - pip install uv
             - uv sync
-            - uv run docs build
+            - uv run nox -s docs -- build
             {% endif -%}
           artifacts:
             - site/**
@@ -101,7 +101,7 @@ pipelines:
             {% else -%}
             - pip install uv
             - uv sync
-            - uv run tests
+            - uv run nox -s tests
             {% endif -%}
 
       - step:
@@ -116,7 +116,7 @@ pipelines:
             {% else -%}
             - pip install uv
             - uv sync
-            - uv run checks
+            - uv run nox -s checks
             {% endif -%}
 
       {% if publish_pypi -%}
@@ -132,7 +132,7 @@ pipelines:
             {% else -%}
             - pip install uv
             - uv sync
-            - uv run release
+            - uv run nox -s release
             {% endif -%}
           trigger: manual
       {% endif -%}

project/{% if git_provider == 'Bitbucket' %}bitbucket-pipelines.yml{% endif %}.jinja

@@ -68,13 +68,13 @@ jobs:
       run: uv sync --only-dev
 
     - name: Check code quality
-      run: uv run checks quality
+      run: uv run nox -s checks -- quality
 
     - name: Check type annotations
-      run: uv run checks types
+      run: uv run nox -s checks -- types
 
     - name: Check vulnerabilities in dependencies
-      run: uv run checks dependencies
+      run: uv run nox -s checks -- dependencies
     {%- endif %}
 
   tests:
@@ -123,7 +123,7 @@ jobs:
       run: uv sync
 
     - name: Run the test suite
-      run: uv run tests
+      run: uv run nox -s tests
     {%- endif %}
 
   doc:
@@ -164,5 +164,5 @@ jobs:
       run: uv sync
 
     - name: Build documentation with Python {% raw %}${{ matrix.python-version }}{% endraw %}
-      run: uv run docs build
+      run: uv run nox -s docs -- build
     {%- endif %}

project/{% if git_provider == 'GitHub' %}.github{% endif %}/workflows/ci.yml.jinja

@@ -54,7 +54,7 @@ jobs:
       run: uv sync
 
     - name: Build documentation
-      run: uv run docs build
+      run: uv run nox -s docs -- build
     {%- endif %}
 
     - name: Upload artifact

project/{% if git_provider == 'GitHub' %}.github{% endif %}/workflows/doc.yml.jinja

@@ -30,7 +30,7 @@ test:
     - pdm run tests
     {% else -%}
     - uv sync
-    - uv run tests
+    - uv run nox -s tests
     {% endif -%}
   coverage: '/TOTAL.*\s+(\d+%)$/'
   artifacts:
@@ -48,7 +48,7 @@ quality:
     - pdm run checks
     {% else -%}
     - uv sync
-    - uv run checks
+    - uv run nox -s checks
     {% endif -%}
 
 docs:
@@ -60,7 +60,7 @@ docs:
     - pdm run docs build
     {% else -%}
     - uv sync
-    - uv run docs build
+    - uv run nox -s docs -- build
     {% endif -%}
   artifacts:
     paths:
@@ -90,7 +90,7 @@ release:
     - pdm run release
     {% else -%}
     - uv sync
-    - uv run release
+    - uv run nox -s release
     {% endif -%}
   only:
     - tags