hyperfast-uv-template 0.3.2__tar.gz → 0.4.0__tar.gz

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-config.yaml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier; do NOT edit manually
-_commit: v0.2.0-1-gc667855
+_commit: v0.3.3-43-g0a473d1
 _src_path: .
 author: Young Joon Lee
 build_and_release: true

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.envrc.jinja

@@ -12,5 +12,18 @@ else
     make install
     # shellcheck disable=SC1091
     source "${VIRTUAL_ENV}/bin/activate"
+    python3 -m ensurepip --upgrade
     python3 -m pip install --upgrade pip setuptools wheel
 fi
+# Load .env if it exists
+if [ -f .env ]; then
+    # Load each line in .env file
+    while IFS= read -r line || [ -n "$line" ]; do
+        # Skip comments and empty lines
+        if [[ $line =~ ^[[:space:]]*# ]] || [[ -z $line ]]; then
+            continue
+        fi
+        # Export the valid environment variables
+        eval "export ${line}"
+    done < .env
+fi

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.github/workflows/{% if build_and_release %}lint_and_test.yaml{% endif %}

@@ -25,12 +25,12 @@ jobs:
     steps:
       # Checkout the code base #
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
 

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.github/workflows/{% if build_and_release %}release-test.yaml{% endif %}

@@ -12,7 +12,6 @@ jobs:
   release:
     runs-on: ubuntu-latest
     concurrency: release
-    environment: release
 
     permissions:
       id-token: write
@@ -23,7 +22,7 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
@@ -35,7 +34,7 @@ jobs:
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v9.17.0
+        uses: python-semantic-release/python-semantic-release@v10.3.1
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -50,7 +49,7 @@ jobs:
             repository-url: https://test.pypi.org/legacy/
 
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v9.17.0
+        uses: python-semantic-release/publish-action@v10.3.1
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.github/workflows/{% if build_and_release %}release.yaml{% endif %}

@@ -25,7 +25,7 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
@@ -37,7 +37,7 @@ jobs:
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v9.17.0
+        uses: python-semantic-release/python-semantic-release@v10.3.1
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -49,7 +49,7 @@ jobs:
         if: steps.release.outputs.released == 'true'
 
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v9.17.0
+        uses: python-semantic-release/publish-action@v10.3.1
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.github/workflows/{% if documentaion_tool == 'jupyter-book' %}deploy-docs.yaml{% endif %}.jinja

@@ -18,7 +18,7 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-python@v5
         with:

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.github/workflows/{% if documentaion_tool == 'mkdocs' %}deploy-docs.yaml{% endif %}

@@ -21,7 +21,7 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-python@v5
         with:

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/.github/workflows/{% if not build_and_release %}release.yaml{% endif %}

@@ -25,7 +25,7 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
@@ -37,7 +37,7 @@ jobs:
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v9.12.0
+        uses: python-semantic-release/python-semantic-release@v10.3.1
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.copier-template/pyproject.toml.jinja

@@ -174,7 +174,7 @@ branch = true
 source = ["src/{{ package_name }}"]
 
 [tool.deptry]
-ignore = ["DEP001"]
+ignore = ["DEP001", "DEP003"]
 
 [tool.semantic_release]
 # General settings

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.envrc

@@ -12,5 +12,18 @@ else
     make install
     # shellcheck disable=SC1091
     source "${VIRTUAL_ENV}/bin/activate"
+    python3 -m ensurepip --upgrade
     python3 -m pip install --upgrade pip setuptools wheel
 fi
+# Load .env if it exists
+if [ -f .env ]; then
+    # Load each line in .env file
+    while IFS= read -r line || [ -n "$line" ]; do
+        # Skip comments and empty lines
+        if [[ $line =~ ^[[:space:]]*# ]] || [[ -z $line ]]; then
+            continue
+        fi
+        # Export the valid environment variables
+        eval "export ${line}"
+    done < .env
+fi

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.github/workflows/deploy-docs.yaml

@@ -21,7 +21,7 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-python@v5
         with:

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.github/workflows/lint_and_test.yaml

@@ -25,12 +25,12 @@ jobs:
     steps:
       # Checkout the code base #
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
 

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.github/workflows/release-test.yaml

@@ -22,7 +22,7 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
@@ -34,7 +34,7 @@ jobs:
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v9.17.0
+        uses: python-semantic-release/python-semantic-release@v10.3.1
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -49,7 +49,7 @@ jobs:
             repository-url: https://test.pypi.org/legacy/
 
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v9.17.0
+        uses: python-semantic-release/publish-action@v10.3.1
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/.github/workflows/release.yaml

@@ -25,7 +25,7 @@ jobs:
       # the branch was updated. To keep PSR working with the configured release branches,
       # we force a checkout of the desired release branch but at the workflow sha HEAD.
       - name: Setup | Checkout Repository at workflow sha
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
           ref: ${{ github.sha }}
@@ -37,7 +37,7 @@ jobs:
       - name: Action | Semantic Version Release
         id: release
         # Adjust tag with desired version if applicable.
-        uses: python-semantic-release/python-semantic-release@v9.17.0
+        uses: python-semantic-release/python-semantic-release@v10.3.1
         with:
           build: true
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -49,7 +49,7 @@ jobs:
         if: steps.release.outputs.released == 'true'
 
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v9.17.0
+        uses: python-semantic-release/publish-action@v10.3.1
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

hyperfast_uv_template-0.4.0/CLAUDE.md

@@ -0,0 +1,103 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Development Setup
+```bash
+make install        # Install virtual environment with uv and pre-commit hooks
+uv sync            # Sync dependencies
+uv run pre-commit install  # Install pre-commit hooks manually
+```
+
+### Code Quality
+```bash
+make check         # Run all code quality checks (lint, type check, dependency check)
+uv run ruff check src/  # Run linter only
+uv run ruff format src/  # Format code with ruff
+uv run mypy src/   # Run type checking only
+uv run deptry .    # Check for obsolete dependencies
+uv run pre-commit run -a  # Run all pre-commit hooks
+```
+
+### Testing
+```bash
+make test          # Run all tests with coverage (outputs to tests/pytest-coverage.txt)
+uv run pytest      # Run tests without coverage
+uv run pytest tests/hyperfastuv/test_cli.py  # Run specific test file
+uv run pytest -k "test_function_name"  # Run specific test by name
+uv run pytest --cov --cov-report=xml  # Generate coverage.xml for CI
+uv run tox-uv      # Test across Python 3.9-3.13
+```
+
+### Building & Publishing
+```bash
+make build         # Build wheel file using hatchling
+make publish       # Publish to PyPI (requires credentials)
+uvx twine upload dist/*  # Manual upload to PyPI
+```
+
+### Documentation
+```bash
+make docs          # Build and serve documentation locally (http://127.0.0.1:8000)
+make docs-test     # Test documentation build without serving
+uv run mkdocs build  # Build static docs to site/
+```
+
+### Template Management (Copier)
+```bash
+make init-project  # Initialize new project from this template
+make reinit-project  # Update existing project from template
+copier copy --trust --answers-file .copier-config.yaml gh:entelecheia/hyperfast-uv-template .
+```
+
+## Architecture
+
+This is a Copier-based Python package template designed for rapid project bootstrapping with modern tooling.
+
+### Project Purpose
+This repository serves as a **template generator** for Python projects. It uses Copier to create customized project scaffolds based on user inputs. The generated projects include pre-configured development tools, CI/CD pipelines, and documentation.
+
+### Package Structure
+- **src/hyperfastuv/**: Template demonstration package
+  - `__init__.py`: Package initialization with `get_version()` function
+  - `__cli__.py`: Click-based CLI with greeting functionality
+  - `_version.py`: Semantic versioning managed by python-semantic-release
+  - `conf/about/`: YAML configuration files for package metadata
+
+### Template System
+- **copier.yaml**: Template configuration with questions for project customization
+- **.copier-template/**: Template source files (Jinja2 templates)
+- **.copier-config.yaml**: Saved answers for template regeneration
+- Supports nested templates via `code_template_source` parameter
+
+### Development Stack
+- **Package Manager**: uv (high-performance Python package installer)
+- **Build System**: Hatchling with wheel distribution
+- **Testing**: pytest with coverage reporting, tox for multi-version testing
+- **Linting/Formatting**: Ruff (replaces black, isort, flake8)
+- **Type Checking**: mypy with strict configuration
+- **Pre-commit**: Automated checks for YAML, TOML, merge conflicts
+- **Documentation**: MkDocs Material with mkdocstrings for API docs
+- **CI/CD**: GitHub Actions workflows for testing, releasing, and docs deployment
+
+### Key Configuration Files
+- `pyproject.toml`: Unified configuration for all tools (PEP 621 compliant)
+- `uv.lock`: Reproducible dependency resolution
+- `.python-version`: Python 3.11 as default
+- `tox.ini`: Test matrix for Python 3.9-3.13
+- `.pre-commit-config.yaml`: Git hooks for code quality
+
+### CI/CD Workflows
+- **lint_and_test.yaml**: Runs on push to main, executes checks and tests
+- **release.yaml**: Semantic release on main branch merges
+- **deploy-docs.yaml**: Publishes documentation to GitHub Pages
+
+### Release Process
+Uses python-semantic-release with Angular commit convention:
+- `feat:` triggers minor version bump
+- `fix:` or `perf:` triggers patch version bump
+- `BREAKING CHANGE:` triggers major version bump
+- Automatically updates version in `pyproject.toml` and `_version.py`
+- Creates GitHub releases with changelog

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperfast-uv-template
-Version: 0.3.2
+Version: 0.4.0
 Summary: Streamlining Python Project Development with a Comprehensive Toolset for Quality, Efficiency, and Maintainability
 Project-URL: Homepage, https://hyperfast-uv.entelecheia.ai
 Project-URL: Repository, https://github.com/entelecheia/hyperfast-uv-template

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hyperfast-uv-template"
-version = "0.3.2"
+version = "0.4.0"
 description = "Streamlining Python Project Development with a Comprehensive Toolset for Quality, Efficiency, and Maintainability"
 authors = [{ name = "Young Joon Lee", email = "entelecheia@hotmail.com" }]
 license = "MIT"
@@ -199,7 +199,7 @@ branch = true
 source = ["src/hyperfastuv"]
 
 [tool.deptry]
-ignore = ["DEP001"]
+ignore = ["DEP001", "DEP003"]
 
 [tool.semantic_release]
 # General settings

{hyperfast_uv_template-0.3.2 → hyperfast_uv_template-0.4.0}/src/hyperfastuv/_version.py

@@ -13,4 +13,4 @@ Example:
     '0.1.0'
 """
 
-__version__ = "0.3.2"
+__version__ = "0.4.0"