uvpg 1.0.1__py3-none-any.whl

uvpg/main.py

@@ -0,0 +1,283 @@
+#!/usr/bin/env python3
+"""
+uvpg - UV Project generator based on monorepo template with uv workspaces.
+
+Usage:
+    uvpg my-project
+    uvpg my-project --package my-lib
+    uvpg my-project -p lib1 -p lib2
+"""
+
+import argparse
+import platform
+import re
+import subprocess
+import sys
+from datetime import UTC, datetime
+
+# ============================================================================
+# Configuration
+# ============================================================================
+from importlib.metadata import version
+from pathlib import Path
+
+from uvpg.templates import (
+    TEMPLATE_CLEAN_SCRIPT,
+    TEMPLATE_COMPOSE,
+    TEMPLATE_DOCKERFILE,
+    TEMPLATE_DOCKERIGNORE,
+    TEMPLATE_GITIGNORE,
+    TEMPLATE_LICENSE_MIT,
+    TEMPLATE_MAIN_APP,
+    TEMPLATE_PACKAGE_MAIN,
+    TEMPLATE_PYPROJECT_PACKAGE,
+    TEMPLATE_PYPROJECT_ROOT,
+    TEMPLATE_README,
+    TEMPLATE_VSCODE_EXTENSIONS,
+    TEMPLATE_VSCODE_SETTINGS,
+)
+
+VERSION: str = version(distribution_name="uvpg")
+AUTHORS_NAME = "John Doe"
+AUTHORS_EMAIL = "john@example.com"
+PYTHON_VERSION_DEFAULT = f"{sys.version_info.major}.{sys.version_info.minor}"
+
+
+# ============================================================================
+# Functions
+# ============================================================================
+
+
+def run_command(cmd: list[str], cwd: Path | None = None) -> bool:
+    """Execute command and return success status."""
+    try:
+        subprocess.run(cmd, cwd=cwd, check=True, capture_output=True)  # noqa: S603
+    except subprocess.CalledProcessError as e:
+        print(f"Error running {' '.join(cmd)}: {e.stderr.decode()}")
+        return False
+    else:
+        return True
+
+
+def create_package(root: Path, name: str, python_version: str = PYTHON_VERSION_DEFAULT) -> bool:
+    """Create a package inside packages/."""
+    package_name = name.replace("-", "_")
+    package_dir = root / "packages" / package_name
+
+    if package_dir.exists():
+        print(f"Package '{name}' already exists!")
+        return False
+
+    print(f"Creating package: {name}")
+
+    # Package structure
+    src_dir = package_dir / "src" / package_name
+    src_dir.mkdir(parents=True)
+    (package_dir / "tests").mkdir()
+
+    # Files
+    (package_dir / "pyproject.toml").write_text(
+        TEMPLATE_PYPROJECT_PACKAGE.format(
+            name=name,
+            package_name=package_name,
+            python_version=python_version,
+        )
+    )
+    (src_dir / "__init__.py").touch()
+    (src_dir / "main.py").write_text(TEMPLATE_PACKAGE_MAIN.format(name=name))
+    (package_dir / "tests" / "__init__.py").touch()
+
+    # Register package in root pyproject.toml
+    register_package_in_root(root, package_name)
+
+    return True
+
+
+def register_package_in_root(root: Path, package_name: str) -> None:
+    """Register a package in root pyproject.toml dependencies and sources."""
+    pyproject_path = root / "pyproject.toml"
+    if not pyproject_path.exists():
+        return
+
+    content = pyproject_path.read_text()
+
+    # Add to dependencies = []
+    if "dependencies = []" in content:
+        content = content.replace("dependencies = []", f'dependencies = ["{package_name}"]')
+    elif "dependencies = [" in content:
+        # Find the dependencies line and add the package
+        pattern = r"dependencies = \[([^\]]*)\]"
+        match = re.search(pattern, content)
+        if match:
+            current_deps = match.group(1).strip()
+            if current_deps and f'"{package_name}"' not in current_deps:
+                new_deps = f'{current_deps}, "{package_name}"'
+                content = re.sub(pattern, f"dependencies = [{new_deps}]", content)
+            elif not current_deps:
+                content = re.sub(pattern, f'dependencies = ["{package_name}"]', content)
+
+    # Add to [tool.uv.sources]
+    source_entry = f"{package_name} = {{ workspace = true }}"
+    if "[tool.uv.sources]" in content and f"{package_name} = " not in content:
+        content = content.replace("[tool.uv.sources]", f"[tool.uv.sources]\n{source_entry}")
+
+    pyproject_path.write_text(content)
+
+
+def create_project(
+    name: str,
+    packages: list[str] | None = None,
+    python_version: str = PYTHON_VERSION_DEFAULT,
+    authors_name: str = AUTHORS_NAME,
+    authors_email: str = AUTHORS_EMAIL,
+) -> bool:
+    """Create complete project with monorepo structure."""
+    root = Path(name).resolve()
+
+    # If directory exists and has pyproject.toml, only add packages
+    if root.exists() and (root / "pyproject.toml").exists():
+        if packages:
+            print(f"Adding packages to existing project: {root}")
+            for pkg in packages:
+                create_package(root, pkg, python_version)
+            print("\nRun 'uv sync' to update dependencies.")
+            return True
+        print(f"Project already exists at {root}")
+        return False
+
+    print(f"Creating project: {name} (Python {python_version})")
+
+    # Create directory structure
+    root.mkdir(exist_ok=True)
+    (root / "src" / "app").mkdir(parents=True)
+    (root / "packages").mkdir()
+    (root / "scripts").mkdir()
+    (root / "tests").mkdir()
+    (root / ".vscode").mkdir()
+
+    # Create root files
+    py_target = f"py{python_version.replace('.', '')}"
+    (root / "pyproject.toml").write_text(
+        TEMPLATE_PYPROJECT_ROOT.format(
+            name=name,
+            python_version=python_version,
+            py_target=py_target,
+            authors_name=authors_name,
+            authors_email=authors_email,
+        )
+    )
+    (root / "README.md").write_text(TEMPLATE_README.format(name=name))
+    (root / "LICENSE").write_text(
+        TEMPLATE_LICENSE_MIT.format(year=datetime.now(tz=UTC).year, authors_name=authors_name)
+    )
+    (root / ".gitignore").write_text(TEMPLATE_GITIGNORE)
+    (root / ".python-version").write_text(f"{python_version}\n")
+    (root / "Dockerfile").write_text(TEMPLATE_DOCKERFILE.format(python_version=python_version))
+    (root / ".dockerignore").write_text(TEMPLATE_DOCKERIGNORE)
+    (root / "compose.yaml").write_text(TEMPLATE_COMPOSE)
+
+    # Create VSCode config (detect OS for python path)
+    if platform.system() == "Windows":
+        python_interpreter_path = "${workspaceFolder}\\.venv\\Scripts\\python.exe"
+    else:
+        python_interpreter_path = "${workspaceFolder}/.venv/bin/python"
+
+    (root / ".vscode" / "settings.json").write_text(
+        TEMPLATE_VSCODE_SETTINGS.format(python_interpreter_path=python_interpreter_path)
+    )
+    (root / ".vscode" / "extensions.json").write_text(TEMPLATE_VSCODE_EXTENSIONS)
+
+    # Create main app
+    (root / "src" / "app" / "__init__.py").touch()
+    (root / "src" / "app" / "main.py").write_text(TEMPLATE_MAIN_APP)
+    (root / "tests" / "__init__.py").touch()
+
+    # Cleanup script
+    clean_script = root / "scripts" / "project_clean.sh"
+    clean_script.write_text(TEMPLATE_CLEAN_SCRIPT)
+    clean_script.chmod(0o755)
+
+    # Create initial packages
+    if packages:
+        for pkg in packages:
+            create_package(root, pkg, python_version)
+
+    # Initialize with uv
+    print("Initializing with uv...")
+    if not run_command(["uv", "sync"], cwd=root):
+        print("Warning: failed to run 'uv sync'")
+
+    # Initialize git
+    print("Initializing git...")
+    run_command(["git", "init"], cwd=root)
+
+    print(f"\n✓ Project created at: {root}")
+    print("\nNext steps:")
+    print(f"  cd {name}")
+    print("  uv sync")
+    print("  uv run python src/app/main.py")
+
+    return True
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        prog="uvpg",
+        description="uvpg - UV Project generator for Python monorepos with uv workspaces.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=f"""\
+Examples:
+  %(prog)s my-project                        # Create new project (Python {PYTHON_VERSION_DEFAULT})
+  %(prog)s my-project --python {PYTHON_VERSION_DEFAULT}
+  %(prog)s my-project -p utils -p core       # With initial packages
+  %(prog)s my-project --author "John Doe" --email "john@example.com"
+  %(prog)s . -p new-lib                      # Add package to current project
+""",
+    )
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"%(prog)s {VERSION}",
+    )
+    parser.add_argument("name", help="Project name or '.' for current directory")
+    parser.add_argument(
+        "-p",
+        "--package",
+        action="append",
+        dest="packages",
+        metavar="NAME",
+        help="Package name to create (can be repeated)",
+    )
+    parser.add_argument(
+        "--python",
+        default=PYTHON_VERSION_DEFAULT,
+        metavar="VERSION",
+        help=f"Python version (default: {PYTHON_VERSION_DEFAULT})",
+    )
+    parser.add_argument(
+        "--author",
+        default=AUTHORS_NAME,
+        metavar="NAME",
+        help=f"Author name (default: {AUTHORS_NAME})",
+    )
+    parser.add_argument(
+        "--email",
+        default=AUTHORS_EMAIL,
+        metavar="EMAIL",
+        help=f"Author email (default: {AUTHORS_EMAIL})",
+    )
+
+    args = parser.parse_args()
+
+    # Use current directory if '.'
+    name = args.name
+    if name == ".":
+        name = str(Path.cwd())
+
+    success = create_project(name, args.packages, args.python, args.author, args.email)
+    return 0 if success else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

uvpg/templates.py

@@ -0,0 +1,687 @@
+"""Templates for uvpg project generator."""
+
+TEMPLATE_PYPROJECT_ROOT = """\
+# ============================
+# UV Instructions
+# ============================
+# # On macOS and Linux.
+# curl -LsSf https://astral.sh/uv/install.sh | sh
+# #  On Windows (PowerShell).
+# powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+# uv --version
+# # Initialized project
+# uv init
+# # Initialized project with python version
+# uv init --python {python_version}
+# # Update uv to the latest version
+# uv self update
+# # Resolve and install dependencies
+# uv sync
+# #  Upgrade all packages in the workspace
+# uv sync --upgrade
+# # Cache directory
+# uv cache dir
+# # Install python versions
+# uv python install {python_version}
+# # Set project python version
+# uv python pin {python_version}
+
+# ============================
+# Project Metadata
+# ============================
+[project]
+name = "{name}"
+version = "1.0.0"
+description = ""
+readme = "README.md"
+license = "MIT"
+authors = [{{ name = "{authors_name}", email = "{authors_email}" }}]
+requires-python = ">={python_version}"
+dependencies = ["uvicorn", "fastapi"]
+
+# ============================
+# Dependency Groups
+# dependencies: "ruff", "ty", "watchfiles", "pytest", "pytest-cov"
+# ============================
+[dependency-groups]
+dev = ["ruff", "ty", "watchfiles"]
+
+# # ============================
+# # UV Configuration
+# # ============================
+# [tool.uv]
+# link-mode = "copy"
+
+# ============================
+# Workspace Configuration
+# https://docs.astral.sh/uv/concepts/projects/workspaces/#workspace-layouts
+# ============================
+[tool.uv.workspace]
+members = ["packages/*"]
+
+[tool.uv.sources]
+
+# ============================
+# Scripts Entry Points
+# ============================
+[project.scripts]
+app = "app.main:main"
+
+# ============================
+# Build System Configuration
+# ============================
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/app"]
+
+# ============================
+# Linting Configuration (Ruff)
+# uv add ruff --dev
+# ruff --version
+# uv sync --upgrade-package ruff
+# ============================
+[tool.ruff]
+line-length = 100
+target-version = "{py_target}"
+fix = true
+show-fixes = true
+indent-width = 4
+exclude = ["venv", ".venv", "env", ".env", "node_modules", "__pycache__"]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "T201",   # Checks for print statements,
+    "COM812", # Checks for the absence of trailing commas.
+    "INP001", # Checks for packages that are missing an __init__.py file.
+    "D",      # All pydocstyle (D)
+    "ANN401", # Checks that function arguments are annotated with a more specific type than Any.
+    "ERA001", # Checks for commented-out Python code.
+    "A004",   # Shadowing Python Builtin
+    "EXE001",  # Shebang is present but file is not executable.
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["ANN201", "S101", "ANN001"]
+"packages/**/tests/*.py" = ["ANN201", "S101", "ANN001"]
+
+# ============================
+# Typing Configuration (Ty)
+# uv add ty --dev
+# ty --version
+# uv sync --upgrade-package ty
+# ============================
+[tool.ty.rules]
+possibly-unresolved-reference = "warn"
+# division-by-zero = "ignore"
+
+# # ============================
+# # Testing Configuration (pytest)
+# # uv add pytest --dev
+# # pytest --version
+# # uv sync --upgrade-package pytest
+# # ============================
+# [tool.pytest.ini_options]
+# addopts = "-vs --color=yes --tb=short --cov=packages --cov=src --cov-report=term-missing"
+# testpaths = ["packages", "tests"]
+
+# # ============================
+# # Coverage Configuration (pytest-cov)
+# # uv add pytest-cov --dev
+# # pytest --version
+# # uv sync --upgrade-package pytest-cov
+# # ============================
+# [tool.coverage.run]
+# source = ["packages", "src"]
+# omit = ["*/__pycache__/*", "*/tests/*"]
+
+# [tool.coverage.report]
+# exclude_lines = [
+#     "pragma: no cover",           # Ignore pragma no cover ex.: def foo():  # pragma: no cover
+#     "if __name__ == .__main__.:", # Ignore if __name__ == "__main__" blocks
+# ]
+"""
+
+TEMPLATE_PYPROJECT_PACKAGE = """\
+# ============================
+# Project Metadata
+# ============================
+[project]
+name = "{name}"
+version = "1.0.0"
+description = ""
+requires-python = ">={python_version}"
+dependencies = []
+
+# # ============================
+# # Scripts Entry Points
+# # ============================
+# [project.scripts]
+# {package_name} = "{package_name}.main:hello"
+
+# ============================
+# Build System Configuration
+# ============================
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/{package_name}"]
+"""
+
+TEMPLATE_README = """\
+# {name}
+
+## Structure
+
+```
+{name}/
+├── src/app/          # FastAPI application
+├── packages/         # Internal libraries (uv workspace)
+├── scripts/          # Utility scripts
+├── tests/            # Test files
+├── Dockerfile        # Multi-stage Docker build
+└── compose.yaml      # Docker Compose config
+```
+
+## Getting Started
+
+### Local Development
+
+```bash
+# Install dependencies
+uv sync
+
+# Run application
+uv run app
+
+# Or run directly
+uv run python src/app/main.py
+
+# Run with auto-reload
+uv run watchfiles 'python src/app/main.py'
+```
+
+### Docker
+
+```bash
+# Build and run
+docker compose up --build
+
+# Run with watch mode (auto-reload on file changes)
+docker compose up --watch
+
+# Stop
+docker compose down
+```
+
+## API
+
+Once running, access:
+
+- **API:** http://localhost:8000
+- **Docs:** http://localhost:8000/docs
+- **ReDoc:** http://localhost:8000/redoc
+
+## Development Commands
+
+```bash
+# Run tests
+uv run pytest
+
+# Lint
+uv run ruff check .
+
+# Type check
+uv run ty check
+
+# Format
+uv run ruff format .
+
+# Clean project
+bash scripts/project_clean.sh
+```
+
+## Add new package
+
+```bash
+uvpg . --package package-name
+```
+
+## Build
+
+```bash
+uv build
+```
+"""
+
+TEMPLATE_MAIN_APP = """\
+\"\"\"Main application.\"\"\"
+
+from datetime import UTC, datetime
+
+import uvicorn
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def home() -> dict[str, str | int]:
+    return {"message": "Hello, world!", "now": datetime.now(tz=UTC).isoformat()}
+
+
+def main() -> None:
+    uvicorn.run(app, host="0.0.0.0", port=8000)  # noqa: S104
+
+
+if __name__ == "__main__":
+    main()
+"""
+
+TEMPLATE_PACKAGE_MAIN = """\
+\"\"\"{name} main module.\"\"\"
+
+
+def hello() -> str:
+    return "Hello from {name}!"
+"""
+
+TEMPLATE_CLEAN_SCRIPT = """\
+#!/bin/bash
+# Clean temporary files and caches
+
+set -e
+
+echo "Cleaning project..."
+
+# Python caches
+find . -type d -name '__pycache__' -exec rm -rf {} + 2>/dev/null || true
+find . -type d -name '*.egg-info' -exec rm -rf {} + 2>/dev/null || true
+find . -type f -name '*.pyc' -delete 2>/dev/null || true
+find . -type d -name '.pytest_cache' -exec rm -rf {} + 2>/dev/null || true
+find . -type d -name '.ruff_cache' -exec rm -rf {} + 2>/dev/null || true
+find . -type f -name '*.Identifier' -delete 2>/dev/null || true
+
+# Build artifacts
+find . -type d -name "dist" -exec rm -rf {} + 2>/dev/null || true
+find . -type d -name "build" -exec rm -rf {} + 2>/dev/null || true
+
+echo "Cleanup complete!"
+"""
+
+TEMPLATE_LICENSE_MIT = """\
+MIT License
+
+Copyright (c) {year} {authors_name}
+
+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.
+"""
+
+TEMPLATE_GITIGNORE = """\
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# uv
+.python-version
+
+# Testing
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover
+
+# Ruff
+.ruff_cache/
+
+# IDEs
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+*.Identifier
+"""
+
+TEMPLATE_VSCODE_SETTINGS = """\
+{{
+    // VsCode general settings
+    "editor.fontSize": 14,
+    "window.zoomLevel": 0,
+    "explorer.compactFolders": false,
+    // Action Buttons settings
+    "actionButtons": {{
+        "defaultColor": "Lime",
+        "reloadButton": "$(refresh)",
+        "commands": [
+            {{
+                "name": "$(sync)",
+                "tooltip": "Reload Windows",
+                "useVsCodeApi": true,
+                "command": "workbench.action.reloadWindow"
+            }},
+            {{
+                "name": "$(trash)",
+                "tooltip": "Clean Project",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "bash scripts/project_clean.sh"
+            }},
+            {{
+                "name": "$(beaker)",
+                "tooltip": "Run Tests",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "uv run pytest"
+            }},
+            {{
+                "name": "$(terminal)",
+                "tooltip": "Open New Terminal",
+                "useVsCodeApi": true,
+                "command": "workbench.action.terminal.new"
+            }},
+            {{
+                "name": "$(versions)",
+                "tooltip": "Python Version",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "uv run python --version"
+            }},
+            {{
+                "name": "$(package)",
+                "tooltip": "UV Sync",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "uv sync"
+            }},
+            {{
+                "name": "$(build)",
+                "tooltip": "UV Build",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "uv build"
+            }},
+            {{
+                "name": "$(run)",
+                "tooltip": "UV Run",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "uv run src/app/main.py"
+            }},
+            {{
+                "name": "$(debug-alt)",
+                "tooltip": "Run Watch Files",
+                "singleInstance": true,
+                "cwd": "${{workspaceFolder}}",
+                "command": "uv run watchfiles 'python src/app/main.py'"
+            }}
+        ]
+    }},
+    // Code Runner settings
+    "code-runner.clearPreviousOutput": true,
+    "code-runner.ignoreSelection": true,
+    "code-runner.saveFileBeforeRun": true,
+    "code-runner.runInTerminal": true,
+    "code-runner.preserveFocus": false,
+    "code-runner.executorMap": {{
+        "python": "clear ; python -u"
+    }},
+    // Python settings
+    "[python]": {{
+        "editor.formatOnSave": true,
+        "editor.tabSize": 4,
+        "editor.insertSpaces": true,
+        "editor.codeActionsOnSave": {{
+            "source.fixAll": "explicit",
+            "source.organizeImports": "explicit"
+        }},
+        "editor.defaultFormatter": "charliermarsh.ruff"
+    }},
+    "python.defaultInterpreterPath": "{python_interpreter_path}",
+    "python.analysis.autoImportCompletions": true,
+    "python.terminal.activateEnvInCurrentTerminal": true,
+    "python.terminal.activateEnvironment": true,
+    "python.languageServer": "None",
+    "python.venvPath": ".venv",
+    // Ty settings (https://docs.astral.sh/ty/reference/editor-settings)
+    "ty.disableLanguageServices": false,
+    "ty.diagnosticMode": "workspace"
+}}
+"""
+
+TEMPLATE_VSCODE_EXTENSIONS = """\
+{
+    // Search for extensions in the Marketplace: @recommended
+    "recommendations": [
+        "dracula-theme.theme-dracula",
+        "pkief.material-icon-theme",
+        "seunlanlege.action-buttons",
+        "mhutchie.git-graph",
+        "ms-python.python",
+        "formulahendry.code-runner",
+        "tamasfe.even-better-toml",
+        "charliermarsh.ruff",
+        "astral-sh.ty",
+        "tal7aouy.rainbow-bracket",
+        "ms-vscode-remote.remote-wsl"
+    ]
+}
+"""
+
+TEMPLATE_DOCKERFILE = """\
+FROM debian:trixie-slim AS builder
+
+RUN apt-get update \\
+  && apt-get install -y --no-install-recommends build-essential \\
+  && apt-get clean \\
+  && rm -rf /var/lib/apt/lists/*
+
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+ENV UV_COMPILE_BYTECODE=1 \\
+  UV_LINK_MODE=copy \\
+  UV_PYTHON_PREFERENCE=only-managed \\
+  UV_NO_DEV=1 \\
+  UV_PYTHON_INSTALL_DIR=/python
+
+RUN uv python install {python_version}
+
+WORKDIR /app
+
+RUN --mount=type=cache,target=/root/.cache/uv \\
+  --mount=type=bind,source=uv.lock,target=uv.lock \\
+  --mount=type=bind,source=pyproject.toml,target=pyproject.toml \\
+  --mount=type=bind,source=packages,target=packages \\
+  uv sync --frozen --no-install-project
+
+COPY . /app
+
+RUN --mount=type=cache,target=/root/.cache/uv \\
+  uv sync --frozen
+
+################################################################################
+FROM debian:trixie-slim AS runtime
+
+ARG UID=1000
+ARG GID=1000
+ARG USERNAME=python
+
+ENV PYTHONUNBUFFERED=1 \\
+  PATH="/app/.venv/bin:${{PATH}}"
+
+RUN groupadd --gid ${{GID}} ${{USERNAME}} \\
+  && useradd --uid ${{UID}} --gid ${{USERNAME}} --shell /bin/bash --create-home ${{USERNAME}}
+
+COPY --from=builder --chown=${{UID}}:${{GID}} /python /python
+COPY --from=builder --chown=${{UID}}:${{GID}} /app /app
+
+USER ${{USERNAME}}
+
+WORKDIR /app
+
+EXPOSE 8000
+
+CMD ["app"]
+"""
+
+TEMPLATE_DOCKERIGNORE = """\
+# ADDED
+tests/
+scripts/
+docs/
+Dockerfile*
+*compose*.yaml
+*compose*.yml
+.python-version
+model_cache/
+TEMP.md
+TMP.md
+temp/
+LICENSE
+.ruff_cache/
+# Git
+.git
+.gitignore
+.gitattributes
+# CI
+.codeclimate.yml
+.travis.yml
+.taskcluster.yml
+# Docker
+docker-compose.yml
+Dockerfile
+.docker
+.dockerignore
+# Byte-compiled / optimized / DLL files
+**/__pycache__/
+**/*.py[cod]
+# C extensions
+*.so
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+# Translations
+*.mo
+*.pot
+# Django stuff:
+*.log
+# Sphinx documentation
+docs/_build/
+# PyBuilder
+target/
+# Virtual environment
+.env
+.venv/
+venv/
+# PyCharm
+.idea
+# Python mode for VIM
+.ropeproject
+**/.ropeproject
+# Vim swap files
+**/*.swp
+# VS Code
+.vscode/
+"""
+
+TEMPLATE_COMPOSE = """\
+services:
+  app:
+    pull_policy: never
+    image: app
+    container_name: app
+    restart: unless-stopped
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: runtime
+    ports:
+      - 8000:8000
+    develop:
+      watch:
+        - action: sync+restart # this depends on the project
+          path: .
+          target: /app
+
+          ignore:
+            - .venv/
+            - __pycache__/
+
+        - action: rebuild
+          path: ./uv.lock
+"""

uvpg-1.0.1.dist-info/METADATA

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: uvpg
+Version: 1.0.1
+Summary: UV Project Generator - Create Python monorepos with workspaces.
+Author-email: Lucas Maziero <lucas.mazie.ro@hotmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# uvpg - UV Project Generator
+
+[![PyPI version](https://img.shields.io/pypi/v/uvpg)](https://pypi.org/project/uvpg/)
+[![License](https://img.shields.io/pypi/l/uvpg)](https://github.com/lucasmaziero/uvpg/blob/main/LICENSE)
+[![Release and Publish](https://github.com/lucasmaziero/uvpg/actions/workflows/release.yml/badge.svg)](https://github.com/lucasmaziero/uvpg/actions/workflows/release.yml)
+
+A CLI tool to scaffold Python monorepo projects using [uv](https://docs.astral.sh/uv/) workspaces.
+
+## Features
+
+- 🚀 Creates monorepo structure with uv workspaces
+- 📦 Adds internal packages with automatic dependency registration
+- 🐍 Configurable Python version
+- 👤 Configurable author name and email
+- 📄 MIT License auto-generated
+- 🔧 Pre-configured tools: Ruff, Ty, pytest, coverage
+- 💻 VSCode settings with recommended extensions
+- 🖥️ Auto-detects OS for correct Python interpreter path
+- 🐳 Docker support with multi-stage build and compose
+- ⚡ FastAPI + Uvicorn ready
+
+## Installation
+
+```bash
+# Install from PyPI
+pip install uvpg
+
+# Or install from PyPI with uv
+uv tool install uvpg
+
+# Or clone the repository
+git clone https://github.com/lucasmaziero/uvpg.git
+cd uvpg
+
+# Install with uv
+uv sync
+uv build
+uv tool install dist/uvpg-*.whl
+
+# Or install with pip
+pip install dist/uvpg-*.whl --break-system-packages
+```
+
+## Uninstall
+
+```bash
+# Via uv
+uv tool uninstall uvpg
+
+# Via pip
+pip uninstall uvpg
+```
+
+## Usage
+
+### Create a new project
+
+```bash
+# Basic project
+uvpg my-project
+
+# With specific Python version
+uvpg my-project --python 3.14
+
+# With author information
+uvpg my-project --author "John Doe" --email "john@example.com"
+
+# With initial packages
+uvpg my-project -p core -p utils -p api
+
+# Combining options
+uvpg my-project --python 3.14 --author "John Doe" --email "john@example.com" -p core
+```
+
+### Add packages to existing project
+
+```bash
+cd my-project
+uvpg . -p new-package
+```
+
+### Show version
+
+```bash
+uvpg --version
+```
+
+### Show help
+
+```bash
+uvpg --help
+```
+
+## Generated Structure
+
+```
+my-project/
+├── .vscode/
+│   ├── settings.json       # VSCode settings (Ruff, Ty, Action Buttons)
+│   └── extensions.json     # Recommended extensions
+├── packages/
+│   └── core/
+│       ├── pyproject.toml
+│       ├── src/
+│       │   └── core/
+│       │       ├── __init__.py
+│       │       └── main.py
+│       └── tests/
+├── scripts/
+│   └── project_clean.sh    # Cleanup script
+├── src/
+│   └── app/
+│       ├── __init__.py
+│       └── main.py         # FastAPI application
+├── tests/
+├── .dockerignore
+├── .gitignore
+├── .python-version
+├── compose.yaml            # Docker Compose config
+├── Dockerfile              # Multi-stage Docker build
+├── LICENSE                 # MIT License
+├── pyproject.toml          # Root config with workspace
+├── README.md
+└── uv.lock
+```
+
+## Configuration
+
+The generated `pyproject.toml` includes:
+
+- **FastAPI + Uvicorn** - Web framework and ASGI server
+- **Ruff** - Linting with `select = ["ALL"]`
+- **Ty** - Type checking
+- **pytest** - Testing (commented, ready to enable)
+- **coverage** - Code coverage (commented, ready to enable)
+- **uv workspaces** - Monorepo package management
+- **hatchling** - Build system
+
+## Docker
+
+Run with Docker Compose:
+
+```bash
+# Build and run
+docker compose up --build
+
+# Run with watch mode (auto-reload)
+docker compose up --watch
+```
+
+## Requirements
+
+- Python >= 3.12
+- [uv](https://docs.astral.sh/uv/) package manager
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/lucasmaziero/uvpg.git
+cd uvpg
+
+# Install dependencies
+uv sync
+
+# Run locally
+uv run uvpg --help
+
+# Run tests
+uv run pytest
+
+# Build
+uv build
+```
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details.

uvpg-1.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+uvpg/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+uvpg/main.py,sha256=doSBwNONLCQNItximr0MrKkkgTTBMEGm8OO92R_LJjY,9325
+uvpg/templates.py,sha256=7oOcalfQAwIpFTg_RBQkWd9PwI9xZH4GdZ2hNw6-LPg,15887
+uvpg-1.0.1.dist-info/METADATA,sha256=BhTk_NEOJkoeC0vMUDzD4-ftRhGQJZZKlX9fDy_umwE,4191
+uvpg-1.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+uvpg-1.0.1.dist-info/entry_points.txt,sha256=A2qYLAP0vHidOtba62Y8i665RHYt8sC9xMd2aeSwoB0,40
+uvpg-1.0.1.dist-info/licenses/LICENSE,sha256=m-3xgK4dm033H8KWdXDGwqZb3nutJAR3MhDj6hX6WzE,1070
+uvpg-1.0.1.dist-info/RECORD,,

uvpg-1.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

uvpg-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+uvpg = uvpg.main:main

uvpg-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Maziero
+
+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.