mypy-setup

mypy-setup

Category: Python Development

Usage

/mypy-setup [--strict] [--django] [--format=<ini|toml>] [--install]

Arguments

Argument	Required	Description
--strict	No	Use strict type checking configuration
--django	No	Add Django-specific configuration and plugin
--format=<ini|toml>	No	Config format (default: ini)
--install	No	Install Mypy and required plugins

Purpose

Set up Mypy static type checking in a Python project:

1. Create Configuration: Generate mypy.ini or pyproject.toml config
2. Install Dependencies: Install Mypy and type stub packages
3. Configure IDE: Add Mypy settings for VS Code/PyCharm
4. Setup CI/CD: Generate GitHub Actions workflow
5. Add Pre-commit: Configure pre-commit hook for Mypy

Execution Instructions for Claude Code

When this command is run, Claude Code should:

1. Parse Arguments

STRICT_MODE = true if --strict specified
DJANGO_MODE = true if --django specified
FORMAT = value after --format= (default: "ini")
INSTALL = true if --install specified

2. Detect Project Type

Scan the project to determine:

# Check for Django
HAS_DJANGO=false
if [ -f "manage.py" ] || grep -q "django" requirements.txt 2>/dev/null; then
    HAS_DJANGO=true
    echo "✓ Django project detected"
fi

# Check for existing config
HAS_CONFIG=false
if [ -f "mypy.ini" ] || [ -f ".mypy.ini" ] || grep -q "\[tool.mypy\]" pyproject.toml 2>/dev/null; then
    HAS_CONFIG=true
    echo "⚠ Existing Mypy configuration found"
fi

# Check Python version
PYTHON_VERSION=$(python --version | cut -d' ' -f2 | cut -d'.' -f1,2)
echo "Python version: $PYTHON_VERSION"

3. Install Mypy (if --install)

if [ "$INSTALL" = true ]; then
    echo "Installing Mypy..."

    # Use uv if available, otherwise pip
    if command -v uv &> /dev/null; then
        PKG_MANAGER="uv pip install"
    else
        PKG_MANAGER="pip install"
    fi

    # Install Mypy
    $PKG_MANAGER mypy

    # Install Django plugin if needed
    if [ "$DJANGO_MODE" = true ] || [ "$HAS_DJANGO" = true ]; then
        $PKG_MANAGER django-stubs mypy-django-plugin
    fi

    # Install common type stubs
    $PKG_MANAGER types-requests types-PyYAML types-redis

    echo "✓ Mypy installed successfully"
fi