Metadata-Version: 2.4
Name: cookiecutter-uv-package
Version: 1.0.10
Summary: Modern cookiecutter template for creating Python packages with complete CI/CD setup and automatic PyPI publishing.
Project-URL: Homepage, https://github.com/serafinovsky/cookiecutter-uv-package
Project-URL: Documentation, https://serafinovsky.github.io/cookiecutter-uv-package
Project-URL: Repository, https://github.com/serafinovsky/cookiecutter-uv-package
Project-URL: Issues, https://github.com/serafinovsky/cookiecutter-uv-package/issues
Author-email: Mark Serafinovsky <m.serafinovsky@gmail.com>
License: MIT
Keywords: ci-cd,cookiecutter,development,github-actions,package,pypi,python,template
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Hatch
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Documentation
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: click==8.1.8
Requires-Dist: cookiecutter==2.6.0
Description-Content-Type: text/markdown

# Python Package Template

![Cookiecutter](https://img.shields.io/badge/cookiecutter-template-red)
[![Tests passed](https://github.com/serafinovsky/cookiecutter-uv-package/workflows/Checks/badge.svg)](https://github.com/serafinovsky/cookiecutter-uv-package/actions)
![License](https://img.shields.io/badge/license-MIT-green)
![Tox](https://img.shields.io/badge/tox-multi--version-blue)
![Pytest](https://img.shields.io/badge/pytest-testing-blue)
![Ruff](https://img.shields.io/badge/ruff-linting-blue)
[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://serafinovsky.github.io/cookiecutter-uv-package)

**Cookiecutter template for creating Python packages with complete CI/CD setup and automatic PyPI publishing.**

## Features

- **Modern tools**: Hatchling, uv, Ruff, MyPy, Pytest
- **CI/CD out of the box**: GitHub Actions with automatic PyPI publishing
- **Release management**: Release Please + Conventional Commits
- **Code quality**: linting, typing, tests, security checks
- **Ready commands**: Makefile for all development tasks

## Quick Start

### Using cookiecutter directly

```bash
# Install cookiecutter
pip install cookiecutter

# Create project
cookiecutter https://github.com/serafinovsky/cookiecutter-uv-package

# Setup development environment
cd your-project-name
make dev-setup
```

### Using CLI tool

```bash
# Install the CLI tool
pip install cookiecutter-uv-package

# Get help with available arguments
cookiecutter-uv-package --help

# Create project with CLI
cookiecutter-uv-package

# Or with custom options
cookiecutter-uv-package --output-dir /path/to/projects --no-input

# Setup development environment
cd your-project-name
make dev-setup
```

## Configuration Options

When creating a project, you'll be asked to configure:

- **project_name**: Display name for your package (e.g., "My Awesome Package")
- **project_short_description**: Brief description of what your package does
- **author_name**: Your name
- **author_email**: Your email address
- **github_username**: Your GitHub username
- **python_versions**: Supported Python versions (default: "3.11, 3.12, 3.13")
- **use_docker**: Whether to include Docker support (yes/no)
- **deployment_setup**: Choose deployment setup (none/github-ci/github-ci-pypi)
- **license**: Choose license (MIT/Apache-2.0/BSD-3-Clause/GPL-3.0/ISC/none)

## Main Commands

```bash
make dev-setup     # Setup development environment
make test          # Run tests
make check         # Check code
make format        # Format code
make build         # Build package
```

## What You Get

- Ready Python package with proper structure
- CI/CD pipeline with GitHub Actions
- Automatic PyPI publishing
- Version management via Release Please

## Example Project

See a real example of this template in action:
**[demo-example-package](https://github.com/serafinovsky/demo-example-package)**

## Documentation

- **[Full Documentation](https://serafinovsky.github.io/cookiecutter-uv-package)** - Complete guide and reference
- **[Tutorial](https://serafinovsky.github.io/cookiecutter-uv-package/tutorial/)** - Step-by-step setup guide
- **[Features](https://serafinovsky.github.io/cookiecutter-uv-package/features/)** - Detailed feature descriptions
- **[Examples](https://serafinovsky.github.io/cookiecutter-uv-package/examples/)** - Usage examples and scenarios

## License

MIT License
