Initialize Python Project

Initialize a new Python project following modern best practices. This command sets up the project structure, tooling, and configuration.

Tasks to Complete

1. Project Initialization

   • Run uv init <project-name> to create the project
   • Create .python-version file for pyenv compatibility
   • Initialize git repository if not already present

2. Directory Structure

   • Create src/<project_name>/ for main code
   • Create tests/ directory for test files
   • Create .vscode/ for editor configuration
   • Create docs/ for documentation

3. Essential Dependencies

   • Add pytest as dev dependency: uv add --dev pytest
   • Add ruff as dev dependency: uv add --dev ruff
   • Add mypy as dev dependency: uv add --dev mypy
   • Add pydantic as runtime dependency: uv add pydantic

4. Configuration Files

   • Create pyproject.toml with ruff and pytest configuration
   • Create .gitignore for Python projects
   • Create .vscode/settings.json with Python and ruff settings

5. Documentation

   • Create README.md with project overview and setup instructions
   • Create initial documentation structure

Expected Outcome

A fully initialized Python project ready for development with:

• Modern package management (uv)
• Fast linting and formatting (ruff)
• Testing framework (pytest)
• Type checking (mypy)
• Editor configuration (VSCode)
• Version control (git)

User Inputs Required

• Project name
• Python version (default: latest stable)
• Whether to include FastAPI for API projects