pytemplate-uv 0.1.0__py3-none-any.whl

pytemplate/__init__.py

@@ -0,0 +1 @@
+# Pytemplate package initialization

pytemplate/main.py

@@ -0,0 +1,142 @@
+"""Command-line interface for creating Python projects from templates."""
+
+from __future__ import annotations
+
+import os
+import subprocess
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+app = typer.Typer(
+    name="pytemplate-uv",
+    help="Create Python projects from templates using uv package manager",
+    add_completion=True,
+    rich_help_panel=True,
+)
+console = Console()
+
+
+def _validate_template(template: str) -> Path:
+    """Validate and return the path to the specified template.
+
+    Args:
+        template (str): Name of the project template.
+
+    Returns:
+        Path: Path to the template directory.
+
+    Raises:
+        typer.BadParameter: If template is not found.
+
+    """
+    templates_dir = Path(__file__).parent.parent / "templates"
+    template_path = templates_dir / f"{template}-template"
+
+    console.print(f"[yellow]Checking template path: {template_path}[/]")
+
+    if not template_path.exists():
+        available_templates = [
+            d.name.replace("-template", "") for d in templates_dir.glob("*-template") if d.is_dir()
+        ]
+
+        error_text = Text("Template not found!", style="bold red")
+        suggestion_text = Text(
+            f"\nAvailable templates: {', '.join(available_templates)}", style="yellow"
+        )
+
+        console.print(Panel(Text.assemble(error_text, suggestion_text), border_style="red"))
+        raise typer.BadParameter(f"Template '{template}' not found")
+
+    console.print(f"[green]Using template path: {template_path}[/]")
+    return template_path
+
+
+def _get_context() -> dict[str, str]:
+    """Retrieve context variables for project template.
+
+    Returns:
+        A dictionary of context variables.
+
+    """
+    return {
+        "author": os.environ.get("USER", "your name"),
+        "email": os.environ.get("USER_EMAIL", "your@email.com"),
+        "github_username": os.environ.get("GITHUB_USERNAME", "your_username"),
+    }
+
+
+def _build_cookiecutter_command(
+    template_path: Path, context: dict, no_input: bool = False, force: bool = False
+) -> list[str]:
+    """Build the cookiecutter command with appropriate options.
+    Args:
+        template_path: Path to the project template
+        context: Context variables for the template
+        no_input: Whether to skip interactive prompts
+        force: Whether to overwrite existing project directory
+    Returns:
+        A list of command arguments.
+
+    """  # noqa: D205, D411
+    cookiecutter_cmd = [
+        "cookiecutter",
+        str(template_path),
+        *[f"{k}={v}" for k, v in context.items()],
+    ]
+
+    if no_input:
+        cookiecutter_cmd.append("--no-input")
+
+    if force:
+        cookiecutter_cmd.append("--overwrite-if-exists")
+
+    return cookiecutter_cmd
+
+
+@app.command()
+def create_project(
+    project_name: str = typer.Argument(None, help="Name of the project"),
+    template: str = typer.Option(
+        "pyproject", "--template", "-t", help="Template to use for project creation"
+    ),
+    no_input: bool = typer.Option(
+        False, "--no-input", "-y", help="Skip prompts and use default values"
+    ),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing project directory"),
+):
+    """Create a new project from a specified template."""
+    template_path = _validate_template(template)
+    context = _get_context()
+    if project_name:
+        context["project_name"] = project_name
+
+    cookiecutter_cmd = _build_cookiecutter_command(template_path, context, no_input, force)
+
+    try:
+        result = subprocess.run(cookiecutter_cmd, text=True, check=True)
+        console.print("[green]Project created successfully![/]")
+
+        if result.stdout:
+            console.print(f"[green]{result.stdout.strip()}[/]")
+
+    except subprocess.CalledProcessError as e:
+        console.print("[red]Project creation failed:[/]")
+        console.print(f"Command: {' '.join(e.cmd)}")
+
+        if e.stdout:
+            console.print("[yellow]Standard Output:[/]")
+            console.print(e.stdout)
+
+        if e.stderr:
+            console.print("[red]Error Output:[/]")
+            console.print(e.stderr)
+
+        raise typer.Exit(code=1)  # noqa: B904
+
+
+if __name__ == "__main__":
+    app()

pytemplate_uv-0.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Leo Liu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pytemplate_uv-0.1.0.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.2
+Name: pytemplate-uv
+Version: 0.1.0
+Summary: A template for creating Python projects using uv package manager
+Author-email: Leo Liu <yuxuzi@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yuxuzi/pytemplate-uv
+Project-URL: Repository, https://github.com/yuxuzi/pytemplate-uv
+Project-URL: Issues, https://github.com/yuxuzi/pytemplate-uv/issues
+Project-URL: Changelog, https://github.com/yuxuzi/pytemplate-uv/blob/main/CHANGELOG.md
+Keywords: python,template,project-generator,uv,cookiecutter,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: cookiecutter>=2.5.0
+Requires-Dist: pytest>=7.4.4
+Provides-Extra: dev
+Requires-Dist: ruff>=0.1.9; extra == "dev"
+Requires-Dist: black>=23.12.1; extra == "dev"
+Requires-Dist: pytest>=7.4.4; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Requires-Dist: mypy>=1.7.1; extra == "dev"
+Requires-Dist: coverage>=7.3.2; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.3; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+
+# PyTemplate UV
+
+## Overview
+
+PyTemplate UV is a powerful CLI tool for creating Python project templates using the `uv` package manager. It provides a seamless way to generate standardized project structures with modern development practices.
+
+## Features
+
+- 🚀 Quick project initialization
+- 🔧 Support for multiple project templates (FastAPI, Standard Python)
+- 📦 Integrated with `uv` package management
+- 🧪 Comprehensive testing infrastructure
+- 🔍 Linting and type checking support
+
+## Prerequisites
+
+- Python 3.11+
+- `uv` package manager
+- `cookiecutter`
+
+## Installation
+
+```bash
+pip install pytemplate-uv
+# or
+uv pip install pytemplate-uv
+```
+
+## Usage
+
+### Create a Project
+
+```bash
+# Create a standard Python project (default)
+pytemplate-uv create-project
+
+# Create a FastAPI project
+pytemplate-uv create-project --template fastapi
+
+# Create a project with a custom name
+pytemplate-uv create-project --name my-awesome-project
+
+# Create a project with custom template and name
+pytemplate-uv create-project --template fastapi --name my-api-project
+```
+
+### Project Creation Options
+
+- `--template`: Choose the project template (default: pyproject)
+  - Options: `pyproject`, `fastapi`
+- `--name`: Specify a custom project name
+- Additional template-specific options can be passed as needed
+
+### Next Steps After Project Creation
+
+1. `cd` into your project directory
+2. Run `uv venv` to create a virtual environment
+3. Run `uv pip install -e .` to install dependencies
+4. Run `make setup` to set up the development environment
+
+## Development
+
+### Setup
+
+1. Clone the repository
+2. Create a virtual environment:
+   ```bash
+   uv venv
+   source .venv/bin/activate
+   ```
+
+3. Install development dependencies:
+   ```bash
+   uv pip install -e .[dev]
+   ```
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Linting
+
+```bash
+ruff check .
+black .
+mypy .
+```
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details.
+
+## Contact
+
+Leo Liu - [GitHub](https://github.com/yuxuzi)
+
+---
+
+*Simplifying Python project creation with modern best practices* 🐍✨

pytemplate_uv-0.1.0.dist-info/RECORD

@@ -0,0 +1,53 @@
+pytemplate/__init__.py,sha256=VY5oWgjrWxifkHlWGCMvKNgCXT-MHQKoHTCerVYpd_I,36
+pytemplate/main.py,sha256=ZWq98WOMtwcXkA_pVqWS0Tmc7aeij3woeQuOOjIqmNU,4258
+templates/fastapi-template/cookiecutter.json,sha256=PPdGDw3mt0qIdkke_Sh0u_yWbTWzobwmXZnVV5WrKcA,660
+templates/fastapi-template/{{cookiecutter.project_name}}/Dockerfile,sha256=dA0wD9ct9jyrYy-hRoUZUYI-TYApaRVT4vsCOwz9vJ4,1057
+templates/fastapi-template/{{cookiecutter.project_name}}/Makefile,sha256=PFeKW96hdb9Wyq9Y09m_H0RXgSe976IfoD8qXqrlndQ,3689
+templates/fastapi-template/{{cookiecutter.project_name}}/README.md,sha256=vmSIwHIK--ZyyREBmqM-WXXeqWEVHFUopUExtUNXRtc,1649
+templates/fastapi-template/{{cookiecutter.project_name}}/pyproject.toml,sha256=vBacMor5LFcX9bzehgZhMcbElet89ldGAUA5IWImoQI,2964
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.envfile}},sha256=F7VgE-qK4V5UkncPsSXI6fs8nTGMpX7TPumXyuHni14,782
+templates/fastapi-template/{{cookiecutter.project_name}}/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+templates/fastapi-template/{{cookiecutter.project_name}}/tests/conftest.py,sha256=K8ePAhQuDhc-3IqmDy-zX8OzJOv722VfOjJeiwqieK8,2382
+templates/fastapi-template/{{cookiecutter.project_name}}/tests/test_cli.py,sha256=WrAM11xHJYToK9vGDMzWLDe5Rul1XU3lxrd13_AHIn8,1047
+templates/fastapi-template/{{cookiecutter.project_name}}/tests/test_example.py,sha256=EUF-8PnvP-abBjH-cDR8v02ZGFctIlGb18AVLcZu7n4,3573
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/cli.py,sha256=bkn_TQxTYy0QLHHWMirhPChqOitffSA1KwNtk82VjT4,1595
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/db.py,sha256=R9OTAOt8WZWLP8ZtmbobrLbtGV_8PzEQaBJZbRStMQI,458
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/main.py,sha256=m7Iwt8I__9BOTFRKIOiE-OXuxiPw-9NS6zZRbVCEmjQ,1481
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/models.py,sha256=WLLtpctDIO6P39d4nUobRdmn774177KONrQjgzxdngU,273
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/__init__.cpython-311.pyc,sha256=rpvf30Q0nPPW6jJW27HgT77rn5Uytuj7Pxg41InoMUs,397
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/db.cpython-311.pyc,sha256=MZNvPK3jTLBQtgX6zIl-_rv1Fy1QsrcrdPFQAIY4mlM,1366
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/main.cpython-311.pyc,sha256=WTK9Oj_JfSC_FYY5foGSKBJCV0O6UMFgARtFdVjQLRU,2826
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/models.cpython-311.pyc,sha256=j46wmZckuJXvXJA08bU1Elu8QnqoJXpTBOUIIBrJELc,847
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/core/config.py,sha256=LfXNZVw2oju5HwUxO0vYrwIcb6n5Z9ljy6AxAEjmBxc,1236
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/core/exceptions.py,sha256=QxlrAOTTvEQAcrvGHVzfWAalGBLKEvRPRAeRVfShjSU,2125
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/core/middleware.py,sha256=ZsYXcPvIcOYBD2sIueXUIsXBu7zCeCKnF3iufwH_ltg,3122
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/core/__pycache__/config.cpython-311.pyc,sha256=kCGo1K1u1TusGDardoXyIQ4HnZzzy9S1D0oocnTDyEE,2294
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/core/__pycache__/exceptions.cpython-311.pyc,sha256=cB6SKzzzwWHjpfnv24pRgZeF9TdKoF9qAi_uPNfL5_A,5211
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/core/__pycache__/middleware.cpython-311.pyc,sha256=dTVnxQBZ1SyhVEoXld2qbx6CNZIzlVi3CfaueoRsSLc,4434
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/routers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/routers/example.py,sha256=oS1kC18aJK9xhFvqGGkHpDY7XGUK0yEsSWn2l6LsY98,2831
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/routers/__pycache__/__init__.cpython-311.pyc,sha256=oF7_NSYEmm7TINmuYJ8zAdubRdMrpLkmbFbw1u_Sr6s,252
+templates/fastapi-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/routers/__pycache__/example.cpython-311.pyc,sha256=W4wS240XIEuXNiRXXRAtlXqI5yQx7baaTLQ2hY3dDm0,5244
+templates/pyproject-template/cookiecutter.json,sha256=ZCqlDi3Z4nG8wN8Cf3vNwyTE7_aBdmZDVQdmMla6Xx8,688
+templates/pyproject-template/{{cookiecutter.project_name}}/Dockerfile,sha256=YBLJVbKfJQlhImd_eT9IFAvk899PpVqDirdD4aiDF5w,1046
+templates/pyproject-template/{{cookiecutter.project_name}}/Makefile,sha256=CQnKkpd8inbVDZRcIg8LPKPzSpV6kX1pJg4t3WCAzCc,3683
+templates/pyproject-template/{{cookiecutter.project_name}}/README.md,sha256=6CXB-ke6-TjH47dQ-KXlZHFCLA7_6A9XPs8iPShmiEM,1248
+templates/pyproject-template/{{cookiecutter.project_name}}/pyproject.toml,sha256=wADwFzOGeYil-Z7_JDNpc7c3LyPQ3mFbYzeNCXJFnAs,2396
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.envfile}},sha256=H0tMaYSKUwgObikNNGd1mXivYpIjasxNG27HvHF7WJU,968
+templates/pyproject-template/{{cookiecutter.project_name}}/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+templates/pyproject-template/{{cookiecutter.project_name}}/tests/test_cli.py,sha256=WrAM11xHJYToK9vGDMzWLDe5Rul1XU3lxrd13_AHIn8,1047
+templates/pyproject-template/{{cookiecutter.project_name}}/tests/test_main.py,sha256=KG9-9kwp105ODKM-UV0TvOoA49h7E9nxSfNIt78X3tw,36
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/cli.py,sha256=oVkN8vEs-k1LTzYB7jyNT01IiZ_v9xO_xSlENXfpFII,1594
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/example_module.py,sha256=UfwjmUgqo_Pev8mZi6HuAOk4PT0Z1tWReZB7WapENl8,17
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/main.py,sha256=bkPX2DwXt65x2NLnIFPNoOWMTn0M5OXmr8XMr9xTl8o,78
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/__init__.cpython-311.pyc,sha256=64PchSH6nA26CgiIvfN1S-Ko7sSjEXft2c9q9rH43uU,399
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/example_module.cpython-311.pyc,sha256=m6eflFezuGlnjcwcZR_InP0IhHNQSLBGAMJ3a-nc8m4,252
+templates/pyproject-template/{{cookiecutter.project_name}}/{{cookiecutter.package_name}}/__pycache__/main.cpython-311.pyc,sha256=Xre-KLGyTkkicox5fIEgahZ-ouxEW_lkvsn-F8cXXRI,498
+pytemplate_uv-0.1.0.dist-info/LICENSE,sha256=qGN1csUyIHsyQcOo3taVjJbE0Z_mNoZUULIGY0Mc-lY,1064
+pytemplate_uv-0.1.0.dist-info/METADATA,sha256=8mwONgHSxrnSReZbo9osggah3DpAxYExCoJRNtF3ars,3702
+pytemplate_uv-0.1.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+pytemplate_uv-0.1.0.dist-info/entry_points.txt,sha256=JpY20DCqntUnmu5HOA8sXqoHpB2oKZ10pi1n8DrrLek,88
+pytemplate_uv-0.1.0.dist-info/top_level.txt,sha256=m4b8YiLi0BJ7kR2AXXY3_Me075SCU1C7qEzucz92qgY,11
+pytemplate_uv-0.1.0.dist-info/RECORD,,

pytemplate_uv-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.8.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pytemplate_uv-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+create-project = pytemplate.main:app
+pytemplate = pytemplate.main:app

pytemplate_uv-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pytemplate

templates/fastapi-template/cookiecutter.json

@@ -0,0 +1,23 @@
+{
+    "project_name": "my-fastapi-project",
+    "package_name": "{{cookiecutter.project_name|lower|replace('-', '_')}}",
+    "author": "{{ cookiecutter.get('author', 'Your Name') }}",
+    "email": "{{ cookiecutter.get('email', 'your@email.com') }}",
+    "github_username": "{{ cookiecutter.get('github_username', 'your_username') }}",
+    "description": "A FastAPI project template",
+    "python_version": "3.11",
+    "docs": "y",
+    "coverage": "y",
+    "dockerfile": "y",
+    "mypy": "y",
+    "license": "MIT",
+    "envfile": ".env",
+    "_copy_without_render": [
+    "docs",
+    "coverage", 
+    "dockerfile", 
+    "mypy", 
+    "envfile",
+    "license"
+]
+}

templates/fastapi-template/{{cookiecutter.project_name}}/Dockerfile

@@ -0,0 +1,38 @@
+FROM python:{{cookiecutter.python_version}}-slim as builder
+
+WORKDIR /{{cookiecutter.project_name}}
+
+# Install uv
+RUN pip install --no-cache-dir uv
+
+# Copy only the files needed for dependency installation
+COPY pyproject.toml .
+COPY {{cookiecutter.project_name}} ./{{cookiecutter.project_name}}
+
+# Use uv to install dependencies
+RUN uv pip install --system .
+
+FROM python:{{cookiecutter.python_version}}-slim
+
+WORKDIR /{{cookiecutter.project_name}}
+
+# Create non-root user
+RUN adduser --disabled-password --gecos '' appuser && \
+    pip install --no-cache-dir uv
+
+# Copy the installed dependencies and project files
+COPY --from=builder /usr/local/lib/python*/site-packages /usr/local/lib/python*/site-packages/
+COPY {{cookiecutter.project_name}} ./{{cookiecutter.project_name}}
+COPY pyproject.toml .
+
+# Switch to non-root user
+USER appuser
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Use make start to run the application
+ENTRYPOINT ["make"]
+CMD ["start"]

templates/fastapi-template/{{cookiecutter.project_name}}/Makefile

@@ -0,0 +1,145 @@
+# Detect the operating system
+ifeq ($(OS),Windows_NT)
+    VENV_ACTIVATE = .venv\Scripts\activate
+    PYTHON = .venv\Scripts\python
+    RM = rmdir /s /q
+    MKDIR = mkdir
+else
+    VENV_ACTIVATE = . .venv/bin/activate
+    PYTHON = .venv/bin/python
+    RM = rm -rf
+    MKDIR = mkdir -p
+endif
+
+# Global prerequisite to ensure virtual environment is activated
+.PHONY: venv-activate
+venv-activate:
+	@if [ ! -d ".venv" ]; then \
+		echo "Virtual environment not found. Creating..."; \
+		uv venv; \
+	fi
+	@echo "Activating virtual environment..."
+	@$(VENV_ACTIVATE)
+
+# Wrapper function to ensure virtual environment is activated
+define ensure_venv
+	@if [ -z "$(VIRTUAL_ENV)" ]; then \
+		echo "Activating virtual environment..."; \
+		. .venv/bin/activate; \
+	fi
+endef
+
+# Apply venv-activate as a global prerequisite
+.PHONY: all
+all: venv-activate
+
+# Modify all targets to depend on venv-activate
+.PHONY: help setup dev start run lint lint-fix format format-check test test-cov clean docs build publish
+
+help: venv-activate
+	@echo " {{cookiecutter.project_name}} - Project Management Commands"
+	@echo ""
+	@echo "Development:"
+	@echo "  make setup    - Create virtual environment and install dependencies"
+	@echo "  make dev      - Set up development environment (pre-commit, etc.)"
+	@echo "  make start    - Start the application"
+	@echo "  make run      - Alias for 'start'"
+	@echo ""
+	@echo "Code Quality:"
+	@echo "  make lint     - Run code linting"
+	@echo "  make lint-fix - Run linter with auto-fix"
+	@echo "  make format   - Format code using Black"
+	@echo "  make format-check - Check code formatting"
+	@echo ""
+	@echo "Testing:"
+	@echo "  make test     - Run tests"
+	@echo "  make test-cov - Run tests with coverage report"
+	@echo ""
+	@echo "Documentation:"
+	@echo "  make docs     - Generate documentation"
+	@echo ""
+	@echo "Packaging:"
+	@echo "  make build    - Build distribution packages"
+	@echo "  make publish  - Publish package to PyPI"
+	@echo ""
+	@echo "Cleanup:"
+	@echo "  make clean    - Remove virtual environment and cache files"
+
+# Setup project dependencies
+setup: venv-activate
+	@echo "Installing dependencies..."
+	$(ensure_venv)
+	uv pip install -e ".[dev, docs, test]" && pre-commit install
+
+# Start the application
+start: venv-activate
+	@echo "Starting application..."
+	$(ensure_venv)
+	fastapi dev {{cookiecutter.package_name}}/main.py
+
+# Alias for start
+run: start
+
+# Linting
+lint: venv-activate
+	@echo "Running linter..."
+	$(ensure_venv)
+	ruff check .
+
+# Linting with auto-fix
+lint-fix: venv-activate
+	@echo "Running linter with auto-fix..."
+	$(ensure_venv)
+	ruff check . --fix
+
+# Code formatting
+format: venv-activate
+	@echo "Formatting code with Black..."
+	$(ensure_venv)
+	black .
+
+# Check code formatting
+format-check: venv-activate
+	@echo "Checking code formatting..."
+	$(ensure_venv)
+	black . --check
+
+# Run tests
+test: venv-activate
+	@echo "Running tests..."
+	$(ensure_venv)
+	pytest tests/
+
+# Run tests with coverage
+test-cov: venv-activate
+	@echo "Running tests with coverage..."
+	$(ensure_venv)
+	pytest --cov={{cookiecutter.package_name}} --cov-report=term-missing 
+
+# Clean up virtual environment and cache files
+clean:
+	@echo "Cleaning up..."
+	$(RM) .venv
+	$(RM) .pytest_cache
+	$(RM) .coverage
+	find . -type d -name "__pycache__" -exec $(RM) {} +
+
+# Generate documentation
+docs: venv-activate
+	@echo "Generating documentation..."
+	$(ensure_venv)
+	pdoc -o docs {{cookiecutter.package_name}}
+
+# Build distribution packages
+build: venv-activate
+	@echo "Building distribution packages..."
+	$(ensure_venv)
+	uv pip install build
+	python -m build
+
+# Publish to PyPI
+publish: build
+	@echo "Publishing to PyPI..."
+	$(ensure_venv)
+	uv pip install twine
+	twine upload dist/*

templates/fastapi-template/{{cookiecutter.project_name}}/README.md

@@ -0,0 +1,99 @@
+# {{cookiecutter.project_name}}
+
+{{cookiecutter.description}}
+
+## 🚀 Features
+
+- Modern FastAPI web application
+- Async SQLModel database integration
+- Comprehensive development tooling
+- Robust testing and type checking
+- Docker support
+
+## 📦 Installation
+
+```bash
+# Using pip
+pip install {{cookiecutter.package_name}}
+
+# Using uv
+uv pip install {{cookiecutter.package_name}}
+```
+
+## 🔧 Development Setup
+
+1. Clone the repository
+2. Create a virtual environment
+```bash
+uv venv
+. .venv/bin/activate
+```
+
+3. Install dependencies
+```bash
+make setup
+```
+
+## 💻 Usage
+
+### CLI Commands
+
+```bash
+# Show help
+{{cookiecutter.package_name}} --help
+
+# Hello command
+{{cookiecutter.package_name}} hello --name World
+
+# Project info
+{{cookiecutter.package_name}} info
+```
+
+### API Endpoints
+
+- Swagger UI: `http://localhost:8000/docs`
+- OpenAPI JSON: `http://localhost:8000/openapi.json`
+
+## 🧪 Testing
+
+Run tests with comprehensive coverage:
+
+```bash
+make test
+```
+
+## 📝 Development Workflow
+
+- `make start`: Start the FastAPI server
+- `make lint`: Run code linters
+- `make format`: Auto-format code
+- `make test`: Run tests
+- `make docs`: Generate documentation
+
+## 🐳 Docker Support
+
+Build and run the Docker container:
+
+```bash
+# Build the image
+docker build -t {{cookiecutter.package_name}} .
+
+# Run the container
+docker run -p 8000:8000 {{cookiecutter.package_name}}
+```
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create your feature branch
+3. Commit your changes
+4. Push to the branch
+5. Create a Pull Request
+
+## 📄 License
+
+{{cookiecutter.license}} License
+
+## 👥 Authors
+
+- {{cookiecutter.author}} <{{cookiecutter.email}}>