Skip to content

Releases: Atyantik/python-modern-template

Release list

Python Modern Template v1.0.1

Python Modern Template v1.0.1 Latest
Latest

Choose a tag to compare

View all tags
@tirthbodawala tirthbodawala released this 05 Nov 12:49
v1.0.1
8a0e4f0

Move to Documentation first approach

Full Changelog: v1.0.0...v1.0.1

Assets 2
Loading

Python Modern Template v1.0.0

Python Modern Template v1.0.0

Choose a tag to compare

View all tags
@tirthbodawala tirthbodawala released this 05 Nov 10:31
v1.0.0
ea70e26

🎉 Python Modern Template v1.0.0

We're excited to announce the first stable release of Python Modern Template - a comprehensive Copier template for modern Python projects!

🌟 Highlights

Production-Ready from Day One

  • ✅ Modern Python: Full support for Python 3.11, 3.12, and 3.13
  • ✅ Fast Package Management: Powered by uv
  • ✅ 100% Test Coverage: 219 tests covering all functionality
  • ✅ 20+ Configuration Options: Customize your project exactly how you want it

🤖 AI-Assisted Development

Built with AI coding assistants in mind! Out-of-the-box support for:

  • Claude Code - Automatic CLAUDE.md configuration
  • Cursor IDE - .cursorrules integration
  • GitHub Copilot - VS Code instructions
  • Google Gemini - Style guide support
  • Aider - YAML configuration

🛠️ Quality Enforcement

Never compromise on code quality:

  • Formatting: Black + isort
  • Linting: Ruff + mypy + Pylint
  • Testing: pytest with 80%+ coverage enforcement
  • Security: Bandit vulnerability scanning
  • Pre-commit: 12+ automated checks

📦 What's Included

Core Features

  • Modern Python 3.11-3.13 support with type hints
  • Fast dependency management with uv
  • Single source of truth configuration (pyproject.toml)
  • Smart defaults derived from folder name
  • Production-ready Docker support (optional)
  • Beautiful MkDocs Material documentation (optional)

AI Session Management

  • Session tracking with context preservation
  • TDD workflow guidelines
  • Task templates (feature, bugfix, refactor, docs, security)
  • Multi-session context management
  • Decision and convention tracking
  • Documentation synchronization validation

Developer Experience

  • Comprehensive Makefile commands
  • 7 example configurations ready to use
  • Complete beginner's guide (GETTING_STARTED.md)
  • GitHub Actions CI/CD pipelines
  • Pre-commit hooks for quality enforcement

🚀 Quick Start

# Install Copier
pip install copier

# Create your project (interactive mode)
copier copy gh:Atyantik/python-modern-template my-awesome-project
cd my-awesome-project

# Install dependencies
uv sync --all-extras --dev

# Run tests
make test

# Run all quality checks
make check

📚 7 Example Configurations

Example Features Best For
Minimal Basic structure Quick prototypes
CLI Tool Typer CLI + quality Command-line apps
Library 90% coverage, strict quality PyPI packages
Data Science Docker + docs + notebooks ML/AI projects
Web API Docker + PostgreSQL REST APIs
AI-Assisted Multi-AI + session mgmt AI pair programming
Full-Featured Everything enabled Production apps

See examples/README.md for detailed guides.

🎯 Perfect For

Solo Developers

  • Quality enforcement built-in
  • AI coding assistant integration
  • TDD workflow for better code
  • Production-ready from day one

Teams

  • Consistent project structure
  • Automated quality checks
  • Comprehensive documentation
  • CI/CD pipelines included

Learning

  • Best practices enforced
  • Modern Python patterns
  • Type hints everywhere
  • Well-documented examples

📖 Documentation

🔧 Recent Improvements

This release includes several critical enhancements:

  • Improved Copier UX with smart folder name defaults
  • Enhanced AI task management system
  • Better session tracking and context preservation
  • Documentation synchronization validation
  • Upgraded to latest tool versions (Black 25.9.0, Ruff 0.14.3, etc.)
  • Fixed template generation issues
  • Comprehensive test suite with 100% coverage

📊 Project Statistics

  • 219 tests with 100% coverage
  • 68 files in full-featured configuration
  • 12+ pre-commit hooks
  • 5 AI documentation files
  • 20+ configuration options
  • 7 example projects

🙏 Acknowledgments

Built with best-of-breed tools:

📞 Support

📄 License

MIT License - see LICENSE for details.

Full Changelog: https://github.com/Atyantik/python-modern-template/commits/v1.0.0

Made with ❤️ by Atyantik Technologies

⭐ Star this repo if you find it useful!

Loading