Skip to content

vinceyyy/standard-template-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Standard Python Template

A Copier template for Python projects with modern tooling.

Features

  • Python 3.13 with uv package manager
  • src layout with proper build backend (uv_build)
  • ruff for linting and formatting
  • pytest for testing
  • pre-commit hooks (ruff, mdformat, gitleaks)
  • Claude Code configuration with recommended plugins
  • GitHub Actions CI (lint, test, secret scanning)
  • Optional fullstack: React 19 + TypeScript + Vite 7 + Tailwind v4 + shadcn/ui

Usage

uvx copier copy https://github.com/vinceyyy/standard-template-python ./my-project

You'll be prompted for:

  • Project name - Used for package name and directory
  • Include fullstack? - Adds React + TypeScript + Vite + Tailwind + shadcn/ui

After Creation

cd my-project

# Initialize git
git init

# Install dependencies
uv sync --dev --upgrade

# Install pre-commit hooks
uv run pre-commit install

# Run tests
uv run pytest

Fullstack Setup (if enabled)

cd frontend
npm install
npx shadcn@latest init
npm run dev

Template Development

To test the template locally:

# Test basic Python project
copier copy . /tmp/test-project

# Test with fullstack
copier copy . /tmp/test-fullstack --data fullstack=true

About

A basic Python project template with src/ layout, testing, linting, and formatting.

Topics

Resources

Stars

Watchers

Forks

Contributors