Standard

A small Python utility library with predictable behavior and agent-first guidance.

The project and PyPI distribution are named standard; the Python import package and command are named std. Standard is an alpha Python library published on PyPI. The documentation site is live at appunni-m.github.io/python-standard.

Install from PyPI

python -m pip install standard
python -m pip install 'standard[fastapi]'
python -m pip install 'standard[aws]'
python -m pip install 'standard[fastapi,aws]'

The core provides YAML/TOML configuration, Pydantic Settings sources, immutable snapshots, recursive mapping helpers, and atomic text writes. FastAPI and AWS integrations are optional extras.

Install from this checkout

Run these commands from the repository root. Choose one integration command if you need that extra; each installs this checkout and its dependencies.

First use

Create config/settings.yaml:

database:
  host: localhost

Then load a value from it:

from std.config import ConfigManager

config = ConfigManager.from_file("config/settings.yaml")
host = config.snapshot.get_path("database.host", "localhost")

For Pydantic Settings, create config/app.yaml:

host: localhost
port: 8080

from std.config import YamlSettings


class Settings(YamlSettings):
    std_config_file = "config/app.yaml"
    host: str
    port: int = 8080


settings = Settings()

By default, Pydantic Settings resolves values in this order: constructor values, Standard config files, process environment, dotenv, and file secrets. Callers can change the order through Pydantic's settings_customise_sources hook.

Agent guidance

std guide
std skill show
std skill install

std guide summarizes the library for coding agents. std skill show prints the packaged idiomatic-Python skill. std skill install writes it to .agents/skills/standard-python/SKILL.md and refuses to overwrite an existing file unless you pass --force.

The source repository contains the development checks, end-to-end tests, and full documentation site. The published distribution is intended to contain only the working library, its CLI, and the required package metadata, README, and license.