# Maverick Python Peps

> Python Enhancement Proposals (PEPs) and style guidelines Use when this capability is needed.

- Skill: `tomevault-io/maverick-python-peps` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/maverick-python-peps`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/maverick-python-peps/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/maverick-python-peps

---


# Python PEPs Skill

Python Enhancement Proposals reference and style guidelines.

## PEP 8 - Style Guide

### Naming Conventions
- **modules**: `lowercase`, `lower_with_under`
- **packages**: `lowercase` (no underscores)
- **classes**: `PascalCase`
- **functions/methods**: `snake_case`
- **constants**: `SCREAMING_SNAKE_CASE`
- **private**: `_leading_underscore`

### Imports
```python
# Standard library
import os
import sys
from pathlib import Path

# Third-party
import requests
from pydantic import BaseModel

# Local
from myapp.models import User
from myapp.utils import helper
```

### Line Length
- Limit lines to 88-100 characters (Black default: 88)
- Break long lines at logical points

### Docstrings (PEP 257)
```python
def function(arg1: str, arg2: int) -> bool:
    """One-line summary.

    Detailed description if needed.

    Args:
        arg1: Description of arg1.
        arg2: Description of arg2.

    Returns:
        Description of return value.

    Raises:
        ValueError: When validation fails.
    """
```

## Key PEPs

- **PEP 8**: Style Guide
- **PEP 20**: Zen of Python
- **PEP 257**: Docstring Conventions
- **PEP 484**: Type Hints
- **PEP 585**: Type Hinting Generics In Standard Collections (list[str])
- **PEP 604**: Union Operator (str | None)
- **PEP 3134**: Exception Chaining (raise...from)

## Review Severity

- **MINOR**: PEP 8 violations (naming, import order, line length)
- **SUGGESTION**: Could follow PEP 257 for docstrings

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/get2knowio) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->