uvpg 1.1.3__tar.gz

uvpg-1.1.3/.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release and Publish
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run Ruff check
+        run: uv run ruff check .
+
+      - name: Run Ruff format check
+        run: uv run ruff format --check .
+
+      - name: Run Ty type check
+        run: uv run ty check
+
+  build-release:
+    runs-on: ubuntu-latest
+    needs: lint
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Build (wheel + sdist)
+        run: uv build
+
+      - name: Create GitHub Release and upload assets
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

uvpg-1.1.3/.gitignore

@@ -0,0 +1,49 @@
+# 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

uvpg-1.1.3/.vscode/extensions.json

@@ -0,0 +1,16 @@
+{
+    // 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"
+    ]
+}

uvpg-1.1.3/.vscode/settings.json

@@ -0,0 +1,103 @@
+{
+    // 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": "make clean"
+            },
+            {
+                "name": "$(beaker)",
+                "tooltip": "Run Tests",
+                "singleInstance": true,
+                "cwd": "${workspaceFolder}",
+                "command": "uv run pytest"
+            },
+            {
+                "name": "$(check)",
+                "tooltip": "Lint Project",
+                "singleInstance": true,
+                "cwd": "${workspaceFolder}",
+                "command": "make check"
+            },
+            {
+                "name": "$(terminal)",
+                "tooltip": "Open New Terminal",
+                "useVsCodeApi": true,
+                "command": "workbench.action.terminal.new"
+            },
+            {
+                "name": "$(package)",
+                "tooltip": "UV Sync",
+                "singleInstance": true,
+                "cwd": "${workspaceFolder}",
+                "command": "uv sync"
+            },
+            {
+                "name": "$(build)",
+                "tooltip": "UV Build",
+                "singleInstance": true,
+                "cwd": "${workspaceFolder}",
+                "command": "make 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": "${workspaceFolder}/.venv/bin/python",
+    "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"
+}

uvpg-1.1.3/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.

uvpg-1.1.3/Makefile

@@ -0,0 +1,84 @@
+# Makefile for uvpg development
+.PHONY: help install sync lint format clean build security version
+
+# Default target
+.DEFAULT_GOAL := help
+
+help: ## Show this help message
+	@echo "Available targets:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+sync: ## Sync dependencies
+	uv sync
+
+install: ## Install the package (for testing after build)
+	uv tool install dist/uvpg-*.whl
+
+lint: ## Run linters
+	uv run ruff check .
+
+format: ## Format code
+	uv run ruff format .
+
+type: ## Run type checker
+	uv run ty check .
+
+security: ## Run security checks
+	@uvx bandit -r .
+# 	@uvx bandit -r . -lll
+
+clean: ## Clean build artifacts
+	@echo "✅ Clean build artifacts"
+	@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
+	@find . -type d -name 'dist' -exec rm -rf {} + 2>/dev/null || true
+	@find . -type d -name 'build' -exec rm -rf {} + 2>/dev/null || true
+	@find . -type d -name 'coverage' -exec rm -rf {} + 2>/dev/null || true
+	@find . -type d -name 'htmlcov' -exec rm -rf {} + 2>/dev/null || true
+
+build: clean ## Build package
+	uv build
+
+version: ## Show current version
+	uv version
+
+version-patch: ## Bump patch version (0.1.0 -> 0.1.1)
+	@echo "Bumping patch version..."
+	@uv version --bump patch --dry-run
+	@printf "Continue? [y/n] "
+	@read REPLY; \
+	if [ "$$REPLY" = "y" ] || [ "$$REPLY" = "Y" ]; then \
+		uv version --bump patch; \
+	else \
+		echo "Aborted."; \
+	fi
+
+version-minor: ## Bump minor version (0.1.0 -> 0.2.0)
+	@echo "Bumping minor version..."
+	@uv version --bump minor --dry-run
+	@printf "Continue? [y/n] "
+	@read REPLY; \
+	echo; \
+	if [ "$$REPLY" = "y" ] || [ "$$REPLY" = "Y" ]; then \
+		uv version --bump minor; \
+	else \
+		echo "Aborted."; \
+	fi
+
+version-major: ## Bump major version (0.1.0 -> 1.0.0)
+	@echo "Bumping major version..."
+	@uv version --bump major --dry-run
+	@printf "Continue? [y/n] "
+	@read REPLY; \
+	echo; \
+	if [ "$$REPLY" = "y" ] || [ "$$REPLY" = "Y" ]; then \
+		uv version --bump major; \
+	else \
+		echo "Aborted."; \
+	fi
+
+check: format lint type ## Run all checks (lint, format, type)

uvpg-1.1.3/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: uvpg
+Version: 1.1.3
+Summary: UV Project Generator - Create Python monorepos with workspaces.
+Project-URL: repository, https://github.com/lucasmaziero/uvpg
+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)
+[![PyPI downloads](https://img.shields.io/pypi/dm/uvpg)](https://pypi.org/project/uvpg)
+[![PyPI total downloads](https://img.shields.io/pepy/dt/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 basic example included
+
+## 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
+```
+
+## Uninstall
+
+```bash
+# Via uv
+uv tool uninstall uvpg
+
+# Via pip
+pip uninstall uvpg
+```
+
+## Upgrade
+
+```bash
+# Via pip
+pip install --upgrade uvpg
+
+# Via uv
+uv tool upgrade 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/
+├── 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
+├── Makefile                # Build automation
+├── 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
+
+### Windows (for Makefile support)
+
+```bash
+# Install Make
+winget install --id=GnuWin32.Make -e
+
+# Use Git Bash terminal for make commands. Launch from batch/command line:
+start "" "%ProgramFiles%\Git\bin\bash.exe"
+```
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/lucasmaziero/uvpg.git
+cd uvpg
+
+# Install dependencies
+uv sync
+
+# Run locally
+uv run uvpg --help
+
+# Build
+uv build
+```
+
+## License
+
+MIT License - See [LICENSE](https://github.com/lucasmaziero/uvpg/blob/main/LICENSE) for details.