✨ Use uv in still more places

Author: sgraaf

.pre-commit-config.yaml

@@ -19,19 +19,20 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.31.1
+    rev: 0.33.2
     hooks:
       - id: check-dependabot
       - id: check-github-workflows
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.9.6
+    rev: v0.12.3
     hooks:
-      - id: ruff
+      - id: ruff-check
         args:
           - --fix
+          - --unsafe-fixes
+          - --show-fixes
       - id: ruff-format
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v4.0.0-alpha.8
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.6.2
     hooks:
       - id: prettier
-        additional_dependencies: ["prettier@3.1.0"]

README.md

@@ -21,17 +21,17 @@ cookiecutter gh:sgraaf/cookiecutter-python-cli-app
 
 <!-- TODO: mention optional use of rich, choice of licenses, git and venv initialization -->
 
--   Beautiful and powerful command-line interfaces with [Click](https://click.palletsprojects.com/)
--   Linting with autofix (i.e. removing unused imports, formatting and Python syntax upgrades) with [ruff](https://beta.ruff.rs/docs/)
--   Code formatting with [ruff](https://beta.ruff.rs/docs/) and [Prettier](https://prettier.io/)
--   Static type-checking with [mypy](http://www.mypy-lang.org/)
--   Checks and fixes before every commit with [pre-commit](https://pre-commit.com/)
--   Testing with [pytest](https://docs.pytest.org/en/stable/index.html)
--   Project automation with [Nox](https://nox.thea.codes/en/stable/)
--   Extremely fast Python package and project management with [uv](https://docs.astral.sh/uv/)
--   Continuous Integration with [GitHub Actions](https://github.com/features/actions) and [pre-commit.ci](https://pre-commit.ci/)
--   Automated version updates for GitHub Actions with [Dependabot](https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot)
--   Documentation with [Sphinx](https://www.sphinx-doc.org/en/master/), [MyST](https://myst-parser.readthedocs.io/en/latest/), and [Read the Docs](https://readthedocs.org/) using the [Furo](https://pradyunsg.me/furo/) theme
--   Automated release builds and uploads to [PyPI](https://pypi.org/)
+- Beautiful and powerful command-line interfaces with [Click](https://click.palletsprojects.com/)
+- Linting with autofix (i.e. removing unused imports, formatting and Python syntax upgrades) with [ruff](https://beta.ruff.rs/docs/)
+- Code formatting with [ruff](https://beta.ruff.rs/docs/) and [Prettier](https://prettier.io/)
+- Static type-checking with [mypy](http://www.mypy-lang.org/)
+- Checks and fixes before every commit with [pre-commit](https://pre-commit.com/)
+- Testing with [pytest](https://docs.pytest.org/en/stable/index.html)
+- Project automation with [Nox](https://nox.thea.codes/en/stable/)
+- Extremely fast Python package and project management with [uv](https://docs.astral.sh/uv/)
+- Continuous Integration with [GitHub Actions](https://github.com/features/actions) and [pre-commit.ci](https://pre-commit.ci/)
+- Automated version updates for GitHub Actions with [Dependabot](https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot)
+- Documentation with [Sphinx](https://www.sphinx-doc.org/en/master/), [MyST](https://myst-parser.readthedocs.io/en/latest/), and [Read the Docs](https://readthedocs.org/) using the [Furo](https://pradyunsg.me/furo/) theme
+- Automated release builds and uploads to [PyPI](https://pypi.org/)
 
 This template supports Python 3.9, 3.10, 3.11, 3.12 and 3.13.

cookiecutter.json

@@ -7,7 +7,7 @@
     "author": "",
     "email": "",
     "github_username": "",
-    "version": "0.1.0",
+    "version": "{% now 'utc', '%Y' %}.1.0",
     "copyright_year": "{% now 'utc', '%Y' %}",
     "license": [
         "mit",

{{ cookiecutter.app_name }}/.pre-commit-config.yaml

@@ -21,34 +21,33 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.23
+    rev: v0.24.1
     hooks:
       - id: validate-pyproject
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.31.1
+    rev: 0.33.2
     hooks:
       - id: check-dependabot
       - id: check-github-workflows
       - id: check-readthedocs
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.9.6
+    rev: v0.12.3
     hooks:
-      - id: ruff
+      - id: ruff-check
         args:
           - --fix
           - --unsafe-fixes
           - --show-fixes
       - id: ruff-format
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.15.0
+    rev: v1.16.1
     hooks:
       - id: mypy
   - repo: https://github.com/codespell-project/codespell
     rev: v2.4.1
     hooks:
       - id: codespell
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v4.0.0-alpha.8
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.6.2
     hooks:
       - id: prettier
-        additional_dependencies: ["prettier@3.1.0"]

{{ cookiecutter.app_name }}/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Calendar Versioning](https://calver.org/).
+
+The **first number** of the version is the year.
+The **second number** is incremented with each release, starting at 1 for each year.
+The **third number** is for emergencies when we need to start branches for older releases.
+
+## Unreleased
+
+### Added
+
+-   Initial release of {{ cookiecutter.friendly_name }}

{{ cookiecutter.app_name }}/docs/changelog.md

@@ -1,7 +1,3 @@
-# Changelog
-
-## {{ cookiecutter.version }} ({% now 'utc', '%Y-%m-%d' %})
-
-### Changes
-
--   Initial release of {{ cookiecutter.friendly_name }}
+```{include} ../CHANGELOG.md
+:relative-docs: docs/
+```

{{ cookiecutter.app_name }}/docs/conf.py

@@ -1,21 +1,16 @@
 """Sphinx configuration."""
 
-from __future__ import annotations
-
-import sys
-from pathlib import Path
+from importlib import metadata
 from typing import Any
 
-sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
-import {{ cookiecutter.package_name }}
-
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = "{{ cookiecutter.friendly_name }}"
 copyright = "{{ cookiecutter.copyright_year }}, {{ cookiecutter.author }}"
 author = "{{ cookiecutter.author }}"
-release = {{ cookiecutter.package_name }}.__version__
+release = metadata.version("{{ cookiecutter.package_name }}")
+version = release.rsplit(".", 1)[0]
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{{ cookiecutter.app_name }}/noxfile.py

@@ -4,9 +4,9 @@
 import nox
 
 nox.options.sessions = ["pre-commit", "tests", "docs"]
-nox.options.default_venv_backend = "uv|virtualenv"
-nox.options.reuse_existing_virtualenvs = True
+nox.options.default_venv_backend = "uv"
 nox.options.error_on_external_run = True
+nox.needs_version = ">=2025.5.1"
 
 ALL_PYTHON_VERSIONS = [
     # [[[cog
@@ -52,18 +52,22 @@ def dev(session: nox.Session) -> None:
         "--seed",
         "--prompt",
         "{{ cookiecutter.app_name }}",
+        "--python",
+        ALL_PYTHON_VERSIONS[0],
         str(VENV_DIR),
         external=True,
         silent=True,
     )
 
-    # install the current package in editable mode (along with its dependencies)
+    # install the current package in editable mode (along with development dependencies)
     session.run(
         "uv",
         "pip",
         "install",
         "--editable",
-        ".[dev]",
+        ".",
+        "--group",
+        "dev",
         env={"VIRTUAL_ENV": str(VENV_DIR)},
         external=True,
         silent=True,
@@ -97,22 +101,23 @@ def pre_commit(session: nox.Session) -> None:
 @nox.session(python=ALL_PYTHON_VERSIONS, tags=["tests"])
 def tests(session: nox.Session) -> None:
     """Run tests."""
-    session.install(".[tests]")
+    session.install(".", "--group", "tests")
     session.run("pytest", *session.posargs)
 
 
 @nox.session(python=DOCS_PYTHON_VERSION)
 def docs(session: nox.Session) -> None:
     """Builds and tests the docs."""
-    session.install(".[docs]")
+    args = session.posargs or ["html", "doctest"]
+
+    session.install(".", "--group", "docs")
 
     # create a temporary directory to store the doctrees
     tmp_dir = session.create_tmp()
 
-    for builder in ["html", "doctest"]:
-        # fmt: off
+    for builder in args:
         session.run(
-            "python", "-m", "sphinx",
+            "python", "-Im", "sphinx",
             "-T",  # display full traceback when an exception occurs
             "-E",  # rebuild the environment
             "-W", "--keep-going",  # turn warnings into errors, but continue to the end of the build
@@ -121,9 +126,7 @@ def docs(session: nox.Session) -> None:
             "-D", "language=en",  # set language
             str(DOCS_SOURCE_DIR),  # source directory
             str(DOCS_BUILD_DIR),  # output directory
-        )
-        # fmt: on
-    session.run("python", "-m", "doctest", "README.md")
+        )  # fmt: skip
 
 
 @nox.session(name="docs-live", python=DOCS_PYTHON_VERSION)
@@ -137,8 +140,7 @@ def docs_live(session: nox.Session) -> None:
     ]
     # fmt: on
 
-    session.install(".[docs]")
-    session.install("sphinx-autobuild")
+    session.install(".", "--group", "docs", "sphinx-autobuild")
 
     session.run("sphinx-autobuild", *args)
 

{{ cookiecutter.app_name }}/pyproject.toml

@@ -1,9 +1,10 @@
 [build-system]
-requires = ["setuptools"]
-build-backend = "setuptools.build_meta"
+requires = ["uv-build"]
+build-backend = "uv_build"
 
 [project]
 name = "{{ cookiecutter.app_name }}"
+version = "{{ cookiecutter.version }}"
 description = "{{ cookiecutter.short_description }}"
 authors = [{name = "{{ cookiecutter.author }}", email = "{{ cookiecutter.email }}"}]
 readme = "README.md"
@@ -45,22 +46,21 @@ dependencies = [
     "rich_click",
 {%- endif %}
 ]
-dynamic = ["version"]
 
-[project.optional-dependencies]
+[dependency-groups]
 tests = [
     "pytest",
 ]
 docs = [
     "furo",
     "myst-parser",
     "sphinx",
-    "sphinx-autobuild",
     "sphinx-copybutton",
     "sphinxext-opengraph",
 ]
 dev = [
-    "{{ cookiecutter.app_name }}[tests,docs]",
+    { include-group = "tests" },
+    { include-group = "docs" },
 ]
 
 [project.urls]
@@ -70,10 +70,7 @@ Changelog = "https://{{ cookiecutter.app_name }}.readthedocs.io/en/stable/change
 "Issue Tracker" = "https://github.com/{{ cookiecutter.github_username }}/{{ cookiecutter.app_name }}/issues"
 
 [project.scripts]
-{{ cookiecutter.app_name }} = "{{ cookiecutter.package_name }}.cli:cli"
-
-[tool.setuptools.dynamic]
-version = {attr = "{{ cookiecutter.package_name }}.__version__"}
+{{ cookiecutter.app_name }} = "{{ cookiecutter.package_name }}.__main__:cli"
 
 [tool.ruff]
 lint.select = ["ALL"]
@@ -88,7 +85,6 @@ lint.ignore = [
     "INP",  # flake8-no-pep420
 ]
 src = ["src", "tests", "docs"]
-target-version = "py39"  # the minimum Python version supported, used by pyupgrade
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = [

{{ cookiecutter.app_name }}/src/{{cookiecutter.package_name}}/__init__.py

@@ -1,3 +1 @@
 """{{ cookiecutter.short_description }}"""
-
-__version__ = "{{ cookiecutter.version }}"