feat: Integrate uv package manager and add to tool explanations

- Add use_uv option to cookiecutter.json
- Update template README, Makefile, CONTRIBUTING.md to support uv
- Add uv commands to generated project CI workflow
- Update pyproject.toml and .gitignore for uv compatibility
- Add uv to main README tool explanations table
- Verified uv sync, uv run, and all dev tools work in generated projects

Author: s-celles

README.md

@@ -19,6 +19,7 @@ This template provides extensive customization options through `cookiecutter.jso
 - `license`: License type (MIT, Apache-2.0, BSD-3-Clause, GPL-3.0, etc.)
 
 ### Development Tools
+- `use_uv`: Modern Python package manager (recommended: y)
 - `use_ruff`: Ultra-fast linter and formatter (recommended: y)
 - `use_mypy`: Static type checking (recommended: y)
 - `use_pytest`: Modern testing framework (recommended: y)
@@ -70,6 +71,7 @@ This template creates a Python package with modern best practices:
 - **Safety** - Dependency vulnerability scanning
 
 ### 🔧 **Development Tools**
+- **uv** - Ultra-fast Python package manager and project manager (optional)
 - **pre-commit** - Automated code quality checks before commits
 - **Tox** - Testing across multiple Python versions
 - **Nox** - Flexible task automation (alternative to Tox)
@@ -183,6 +185,7 @@ cookiecutter https://github.com/s-celles/cookiecutter-python-package.git
 
 | Tool | Purpose | Why Important |
 |------|---------|---------------|
+| **uv** | Package Management | Ultra-fast Python package installer and resolver |
 | **Ruff** | Linting & Formatting | 10-100x faster than flake8/black, combines multiple tools |
 | **MyPy** | Type Checking | Catches bugs early, improves code documentation |
 | **pytest** | Testing | Modern features, fixtures, parametrization |

cookiecutter.json

@@ -37,6 +37,7 @@
 
   "_project_management": "---",
   "_comment_project": "Project management tools",
+  "use_uv": ["y", "n"],
   "use_tox": ["n", "y"],
   "use_nox": ["n", "y"],
   "use_commitizen": ["n", "y"],

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

@@ -32,6 +32,17 @@ jobs:
       with:
         python-version: {% raw %}${{ matrix.python-version }}{% endraw %}
 
+{%- if cookiecutter.use_uv == "y" %}
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: |
+        uv sync --all-extras
+
+{%- else %}
     - name: Cache pip packages
       uses: actions/cache@v4
       with:
@@ -45,34 +56,57 @@ jobs:
         python -m pip install --upgrade pip
         pip install -e ".[dev]"
 
+{%- endif %}
+
 {%- if cookiecutter.use_ruff == "y" %}
     - name: Lint with Ruff
       run: |
+{%- if cookiecutter.use_uv == "y" %}
+        uv run ruff check .
+        uv run ruff format --check .
+{%- else %}
         ruff check .
         ruff format --check .
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_mypy == "y" %}
     - name: Type check with MyPy
       run: |
+{%- if cookiecutter.use_uv == "y" %}
+        uv run mypy src/{{ cookiecutter.project_slug }}
+{%- else %}
         mypy src/{{ cookiecutter.project_slug }}
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_bandit == "y" %}
     - name: Security check with Bandit
       run: |
+{%- if cookiecutter.use_uv == "y" %}
+        uv run bandit -r src/{{ cookiecutter.project_slug }}/
+{%- else %}
         bandit -r src/{{ cookiecutter.project_slug }}/
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_pytest == "y" %}
     - name: Test with pytest
       run: |
 {%- if cookiecutter.use_coverage == "y" %}
+{%- if cookiecutter.use_uv == "y" %}
+        uv run pytest --cov=src/{{ cookiecutter.project_slug }} --cov-report=xml --cov-report=html
+{%- else %}
         pytest --cov=src/{{ cookiecutter.project_slug }} --cov-report=xml --cov-report=html
+{%- endif %}
+{%- else %}
+{%- if cookiecutter.use_uv == "y" %}
+        uv run pytest
 {%- else %}
         pytest
 {%- endif %}
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_coverage == "y" and cookiecutter.use_codecov == "y" %}
     - name: Upload coverage to Codecov
@@ -94,14 +128,25 @@ jobs:
       with:
         python-version: '3.11'
 
+{%- if cookiecutter.use_uv == "y" %}
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+        
+    - name: Build package
+      run: uv build
+
+{%- else %}
     - name: Install build dependencies
       run: |
         python -m pip install --upgrade pip
         pip install build
     
     - name: Build package
       run: python -m build
-    
+
+{%- endif %}
     - name: Upload build artifacts
       uses: actions/upload-artifact@v4
       with:

{{cookiecutter.project_slug}}/.gitignore

@@ -104,6 +104,12 @@ ENV/
 env.bak/
 venv.bak/
 
+{%- if cookiecutter.use_uv == "y" %}
+# uv
+.uv_cache/
+uv.lock
+{%- endif %}
+
 # Spyder project settings
 .spyderproject
 .spyproject

{{cookiecutter.project_slug}}/CONTRIBUTING.md

@@ -18,6 +18,37 @@ Thank you for your interest in contributing to {{ cookiecutter.project_name }}!
    cd {{ cookiecutter.project_slug }}
    ```
 
+{%- if cookiecutter.use_uv == "y" %}
+
+2. **Set up development environment with uv (Recommended)**
+   
+   Install [uv](https://docs.astral.sh/uv/) if you haven't already:
+   ```bash
+   # On macOS and Linux
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   
+   # On Windows
+   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+   
+   Then set up the project:
+   ```bash
+   # Install dependencies and create virtual environment
+   uv sync
+   
+   # Install the package in development mode
+   uv pip install -e ".[dev]"
+   ```
+
+3. **Alternative: Create a virtual environment with pip**
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+   pip install -e ".[dev]"
+   ```
+
+{%- else %}
+
 2. **Create a virtual environment**
    ```bash
    python -m venv venv
@@ -29,11 +60,17 @@ Thank you for your interest in contributing to {{ cookiecutter.project_name }}!
    pip install -e ".[dev]"
    ```
 
+{%- endif %}
+
 {%- if cookiecutter.use_pre_commit == "y" %}
 
 4. **Install pre-commit hooks**
    ```bash
+{%- if cookiecutter.use_uv == "y" %}
+   uv run pre-commit install
+{%- else %}
    pre-commit install
+{%- endif %}
    ```
 {%- endif %}
 
@@ -46,13 +83,23 @@ We use [Ruff](https://github.com/astral-sh/ruff) for code formatting and linting
 
 ```bash
 # Format code
+{%- if cookiecutter.use_uv == "y" %}
+uv run ruff format
+
+# Check for linting issues
+uv run ruff check
+
+# Fix auto-fixable issues
+uv run ruff check --fix
+{%- else %}
 ruff format
 
 # Check for linting issues
 ruff check
 
 # Fix auto-fixable issues
 ruff check --fix
+{%- endif %}
 ```
 {%- endif %}
 
@@ -63,7 +110,11 @@ ruff check --fix
 We use [MyPy](https://mypy.readthedocs.io/) for static type checking:
 
 ```bash
+{%- if cookiecutter.use_uv == "y" %}
+uv run mypy src/{{ cookiecutter.project_slug }}
+{%- else %}
 mypy src/{{ cookiecutter.project_slug }}
+{%- endif %}
 ```
 {%- endif %}
 
@@ -75,6 +126,18 @@ We use [pytest](https://pytest.org/) for testing:
 
 ```bash
 # Run all tests
+{%- if cookiecutter.use_uv == "y" %}
+uv run pytest
+
+# Run with coverage
+uv run pytest --cov={{ cookiecutter.project_slug }}
+
+# Run specific test file
+uv run pytest tests/test_core.py
+
+# Run tests in parallel
+uv run pytest -n auto
+{%- else %}
 pytest
 
 # Run with coverage
@@ -85,6 +148,7 @@ pytest tests/test_core.py
 
 # Run tests in parallel
 pytest -n auto
+{%- endif %}
 ```
 
 Make sure to write tests for any new functionality you add.
@@ -97,7 +161,11 @@ Make sure to write tests for any new functionality you add.
 We use [Bandit](https://bandit.readthedocs.io/) for security checks:
 
 ```bash
+{%- if cookiecutter.use_uv == "y" %}
+uv run bandit -r src/{{ cookiecutter.project_slug }}/
+{%- else %}
 bandit -r src/{{ cookiecutter.project_slug }}/
+{%- endif %}
 ```
 {%- endif %}
 

{{cookiecutter.project_slug}}/Makefile

@@ -5,46 +5,91 @@ help: ## Show this help message
 	@echo "Available commands:"
 	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
 
+{%- if cookiecutter.use_uv == "y" %}
+install: ## Install the package
+	uv pip install -e .
+
+install-dev: ## Install package with development dependencies
+	uv sync
+
+{%- else %}
 install: ## Install the package
 	pip install -e .
 
 install-dev: ## Install package with development dependencies
 	pip install -e ".[dev]"
 
+{%- endif %}
+
 {%- if cookiecutter.use_pytest == "y" %}
+{%- if cookiecutter.use_uv == "y" %}
+test: ## Run tests
+	uv run pytest
+
+test-cov: ## Run tests with coverage
+	uv run pytest --cov={{ cookiecutter.project_slug }} --cov-report=html --cov-report=term-missing
+{%- else %}
 test: ## Run tests
 	pytest
 
 test-cov: ## Run tests with coverage
 	pytest --cov={{ cookiecutter.project_slug }} --cov-report=html --cov-report=term-missing
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_ruff == "y" %}
+{%- if cookiecutter.use_uv == "y" %}
+lint: ## Run linting
+	uv run ruff check .
+
+format: ## Format code
+	uv run ruff format .
+	uv run ruff check --fix .
+{%- else %}
 lint: ## Run linting
 	ruff check .
 
 format: ## Format code
 	ruff format .
 	ruff check --fix .
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_mypy == "y" %}
+{%- if cookiecutter.use_uv == "y" %}
+type-check: ## Run type checking
+	uv run mypy src/{{ cookiecutter.project_slug }}
+{%- else %}
 type-check: ## Run type checking
 	mypy src/{{ cookiecutter.project_slug }}
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_bandit == "y" %}
+{%- if cookiecutter.use_uv == "y" %}
+security: ## Run security checks
+	uv run bandit -r src/{{ cookiecutter.project_slug }}/
+{%- else %}
 security: ## Run security checks
 	bandit -r src/{{ cookiecutter.project_slug }}/
 {%- endif %}
+{%- endif %}
 
 {%- if cookiecutter.use_pre_commit == "y" %}
+{%- if cookiecutter.use_uv == "y" %}
+pre-commit: ## Run pre-commit hooks
+	uv run pre-commit run --all-files
+
+install-hooks: ## Install pre-commit hooks
+	uv run pre-commit install
+{%- else %}
 pre-commit: ## Run pre-commit hooks
 	pre-commit run --all-files
 
 install-hooks: ## Install pre-commit hooks
 	pre-commit install
 {%- endif %}
+{%- endif %}
 
 clean: ## Clean build artifacts
 	rm -rf build/
@@ -53,11 +98,19 @@ clean: ## Clean build artifacts
 	rm -rf .pytest_cache/
 	rm -rf .coverage
 	rm -rf htmlcov/
+{%- if cookiecutter.use_uv == "y" %}
+	rm -rf .venv/
+{%- endif %}
 	find . -type d -name __pycache__ -delete
 	find . -type f -name "*.pyc" -delete
 
+{%- if cookiecutter.use_uv == "y" %}
+build: ## Build package
+	uv build
+{%- else %}
 build: ## Build package
 	python -m build
+{%- endif %}
 
 {%- if cookiecutter.use_mkdocs == "y" %}
 docs: ## Build documentation