Initial commit

commands/py-init.md

@@ -0,0 +1,51 @@
+---
+description: Initialize a new Python project with modern tooling (uv, ruff, pytest)
+---
+
+# 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