Migrate template to uv

Author: claui

README.md

@@ -65,7 +65,7 @@ The Cookiecutter template will give you:
 
 - a global settings file that all modules can import;
 
-- a `pyproject.toml` file and an initial Poetry lockfile;
+- a `pyproject.toml` file and an initial `uv.lock` file;
 
 - a default linter configuration;
 
@@ -76,7 +76,7 @@ The Cookiecutter template will give you:
 - a configuration file for Read the Docs;
 
 - a set of `poe` tasks for running the module scripts, tests and the
-  linter (for details, run `poetry run poe tasks`);
+  linter (for details, run `uv run poe tasks`);
 
 - a virtual environment with initial dependencies installed and
   ready to use;
@@ -95,117 +95,36 @@ The Cookiecutter template will give you:
 
 To use this Cookiecutter template, you need:
 
-1. The Python version manager `pyenv`.
+1. The Python project management tool [uv](https://docs.astral.sh/uv).
 
-2. A system-wide Python installation.
+2. Optionally, Cookiecutter version 2.6.0 or newer.  
 
-3. Cookiecutter version 2.6.0 or newer.
+### Installing uv
 
-4. The Python dependency manager `poetry`.
+To install uv, see its
+[installation instructions](https://docs.astral.sh/uv/getting-started/installation/).
 
-### Installing pyenv
-
-You need the Python version manager `pyenv` so you can set up your
-generated package, and to make sure you can always keep that package
-up and running, regardless of your system Python.
-
-#### Installing pyenv on Windows
-
-While `pyenv` doesn’t support Windows, you can use a drop-in
-replacement called `pyenv-win`.
-
-To install `pyenv-win` on Windows, go to
-[github.com/pyenv-win/pyenv-win](https://github.com/pyenv-win/pyenv-win#installation)
-and follow one of the installation methods.
-
-#### Installing pyenv on Linux
-
-To install `pyenv` on Linux or WSL2, first make sure Python 3 is
-installed. Then follow the _Basic GitHub Checkout_ method described
-at [github.com/pyenv/pyenv](https://github.com/pyenv/pyenv#basic-github-checkout).
-
-#### Installing pyenv on macOS
-
-To install `pyenv` on macOS, run:
-
-```shell
-brew install pyenv
-```
-
-#### Checking your system-wide pyenv installation
-
-To verify your `pyenv` is working, run:
-
-```shell
-pyenv --version
-```
-
-### Checking your system-wide Python installation
-
-Make sure you have Python 3.8 or higher installed on your system
-and available in your PATH.
-
-To check, run:
-
-```shell
-python --version
-```
-
-If that fails, try:
+To verify uv is working, run:
 
 ```shell
-python3 --version
+uv
 ```
 
-Proceed after you’ve confirmed one of those to work.
-
 ### Installing Cookiecutter
 
-To install Cookiecutter, follow Cookiecutter’s [installation
-instructions](https://cookiecutter.readthedocs.io/en/stable/installation.html).
-
-### Installing Poetry
-
-You’ll need `poetry` to manage the generated Python package.
-
-#### Installing Poetry on Windows
-
-To install Poetry on Windows, use one of the
-[installation methods](https://python-poetry.org/docs/master/#installing-with-the-official-installer)
-described in Poetry’s documentation.
-
-#### Installing Poetry on Linux
-
-If you’re on Linux or WSL2, use your system package manager to
-install Poetry.
-
-Alternatively, use one of the
-[installation methods](https://python-poetry.org/docs/master/#installing-with-the-official-installer)
-described in Poetry’s documentation.
+Installing Cookiecutter is optional, because you can run
+`uvx cookiecutter` without installing Cookiecutter.
 
-#### Installing Poetry on macOS
-
-To install Poetry on macOS, run:
-
-```shell
-brew install poetry
-```
-
-#### Checking your Poetry installation
-
-To verify Poetry is working, run:
-
-```shell
-poetry --version
-```
+If you prefer to install Cookiecutter, follow Cookiecutter’s [installation
+instructions](https://cookiecutter.readthedocs.io/en/stable/installation.html).
 
 ### Basic usage
 
 To run the template generator, make sure you have a working
 Cookiecutter installation. Then run:
 
 ```shell
-cookiecutter gh:claui/cookiecutter-python-package
+uvx cookiecutter gh:claui/cookiecutter-python-package
 ```
 
 ### Alternative usage
@@ -221,12 +140,12 @@ abbreviations:
 Then, to generate a project, run:
 
 ```shell
-cookiecutter python
+uvx cookiecutter python
 ```
 
 ## License
 
-Copyright (c) 2021 – 2024 Claudia Pellegrino <[email protected]>
+Copyright (c) 2021 – 2025 Claudia Pellegrino <[email protected]>
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

hooks/post_gen_project.py

@@ -30,50 +30,12 @@
 {% endif -%}
 
 {%- if cookiecutter.install_dependencies_now == "y" %}
-def sysexit_formatted(message: str) -> None:
-    width = max((len(line) for line in message))
-    print('', width * '-', *message, width * '-',
-        file=sys.stderr, sep='\n')
-    sys.exit()
-
-pyenv_commands = [
-    'pyenv install -s',
-    'pyenv exec python -m venv .venv',
-]
-
 try:
-    for pyenv_command in pyenv_commands:
-        subprocess.run(pyenv_command, check=True, shell=True)
-except subprocess.CalledProcessError as e:
-    sysexit_formatted([
-        f'Pyenv failed with exit code {e.returncode}.',
-        'Go to the {{ cookiecutter.pypi_package_name }}'
-            ' directory and re-run:',
-        *[
-            f'    {command}'
-            for command in pyenv_commands + ['poetry install']
-        ],
-    ])
-
-poetry_environment = os.environ.copy()
-poetry_environment.update({
-    'LANG': poetry_environment.get('LANG', 'en_US.UTF-8'),
-    # https://github.com/python-poetry/poetry/issues/1917
-    'PYTHON_KEYRING_BACKEND': 'keyring.backends.null.Keyring',
-})
-
-logger.info('Running poetry. This may take a while.')
-try:
-    subprocess.run(
-        'poetry install',
-        env=poetry_environment,
-        check=True,
-        shell=True,
-        stdout=sys.stderr,
-    )
+    subprocess.run(['uv', 'python', 'install'], check=True, stdout=sys.stderr)
+    subprocess.run(['uv', 'lock'], check=True, stdout=sys.stderr)
 except subprocess.CalledProcessError as e:
     print(
-        f'Poetry failed with exit code {e.returncode}.',
+        f'uv failed with exit code {e.returncode}.',
         'Fix any issues, then go to the '
         '{{ cookiecutter.pypi_package_name }} directory and re-run:',
         f'    {e.cmd}',

hooks/pre_gen_project.py

@@ -35,10 +35,10 @@
         == '{{ cookiecutter.first_module_name }}':
     sys.exit('Package name and first module name cannot be the same')
 
-if not shutil.which('poetry'):
+if not shutil.which('uv'):
     sys.exit(
         """
-This Cookiecutter template depends on Poetry.
-For instructions on how to install Poetry, see `README.md`.
+This Cookiecutter template depends on uv.
+For instructions on how to install uv, see `README.md`.
 """
     )

{{ cookiecutter.pypi_package_name }}/.github/workflows/ci.yml

@@ -5,7 +5,7 @@ on:
   - workflow_call
 
 env:
-  CI_POETRY_VERSION: "1.7.1"
+  CI_UV_VERSION: "0.6.9"
 
 jobs:
   ci-checks:
@@ -15,54 +15,25 @@ jobs:
       - name: Check out source tree
         uses: actions/checkout@v4
 
-      - name: Load cached Poetry installation
-        id: load-cached-poetry
-        uses: actions/cache@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          path: ~/.local
-          key: poetry-release-v{{ '${{' }} env.CI_POETRY_VERSION }}
-
-      - name: Update PATH
-        if: steps.load-cached-poetry.outputs.cache-hit == 'true'
-        run: |
-          echo ~/.local/bin >> "${GITHUB_PATH}"
-
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-        if: steps.load-cached-poetry.outputs.cache-hit != 'true'
-        with:
-          version: {{ '${{' }} env.CI_POETRY_VERSION }}
-          virtualenvs-create: true
-          virtualenvs-in-project: true
+          version: env.CI_UV_VERSION
 
       - name: Print current package version
-        run: poetry version --no-ansi --no-interaction
-
-      - name: Use specified Python version
-        uses: actions/setup-python@v5
-        with:
-          cache: poetry
-          python-version-file: .python-version
-
-      - name: Install dependencies
-        # See also:
-        # https://github.com/python-poetry/poetry/issues/7184
-        run: poetry install --no-ansi --no-interaction --no-root
-
-      - name: Install target package
-        run: poetry install --no-ansi --no-interaction
+        run: uv tree -d 0
 
       - name: Run static typechecking
-        run: poetry run poe typecheck
+        run: uv run poe typecheck
 
       - name: Run linter
-        run: poetry run poe linter
+        run: uv run poe linter
 
       - name: Check for formatting style violations not covered by the linter
-        run: poetry run poe formatcheck
+        run: uv run poe formatcheck
 
       - name: Run unit tests
-        run: poetry run poe tests
+        run: uv run poe tests
 
       - name: Run man page and HTML documentation generator
-        run: poetry run poe doc
+        run: uv run poe doc

{{ cookiecutter.pypi_package_name }}/.github/workflows/prepare-release.yml

@@ -5,11 +5,11 @@ on:
     inputs:
       target_version:
         description: |-
-          New version number for the release (or a Poetry bump rule)
+          New version number for the release (or `major`, `minor`, `patch`)
         required: true
 
 env:
-  CI_POETRY_VERSION: "1.7.1"
+  CI_UV_VERSION: "0.6.9"
 
 jobs:
   bump-version:
@@ -20,39 +20,24 @@ jobs:
       - name: Check out source tree
         uses: actions/checkout@v4
 
-      - name: Load cached Poetry installation
-        id: load-cached-poetry
-        uses: actions/cache@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          path: ~/.local
-          key: poetry-release-v{{ '${{' }} env.CI_POETRY_VERSION }}
-
-      - name: Update PATH
-        if: steps.load-cached-poetry.outputs.cache-hit == 'true'
-        run: |
-          echo ~/.local/bin >> "${GITHUB_PATH}"
-
-      - name: Install Poetry
-        uses: snok/install-poetry@v1
-        if: steps.load-cached-poetry.outputs.cache-hit != 'true'
-        with:
-          version: {{ '${{' }} env.CI_POETRY_VERSION }}
-          virtualenvs-create: true
-          virtualenvs-in-project: true
+          version: env.CI_UV_VERSION
 
       - name: Print current package version
-        run: poetry version --no-ansi --no-interaction
+        run: uv tree -d 0
 
       - name: Bump package version
         env:
           TARGET_VERSION: {{ '${{' }} inputs.target_version }}
-        run: poetry version --no-ansi --no-interaction "${TARGET_VERSION}"
+        run: uvx bump-my-version bump "${TARGET_VERSION}"
 
       - id: gather_new_version
         name: Gather bumped package version
         run: |
           env -i >> "${GITHUB_OUTPUT}" \
-            "new_version=$(poetry version --no-ansi --no-interaction --short)"
+            "new_version=$(uvx bump-my-version show current_version)"
 
       - name: Print bumped package version
         env:

{{ cookiecutter.pypi_package_name }}/.redport/manifest.rpt.json

@@ -14,11 +14,7 @@
     {%- else -%}
     "replay": "cookiecutter_replay/{{ cookiecutter._repo_dir.split('/')[-1] }}.json",
     {%- endif %}
-    "patches": [
-      "patches/disable-install-step.patch"
-    ],
-    "nextPatches": [
-      "patches/disable-install-step.patch"
-    ]
+    "patches": [],
+    "nextPatches": []
   }
 }