A flock of typed, zero-dependency Python design patterns. Each pattern is a single self-contained pato (a duck you adopt), fully typed, standard library only, and small enough to read in one sitting.
Install
pip install patos
Or copy a single duck. Open its docs page, copy the source from the Source section, and paste it into your own project. No dependency, no version pin, no tool, just one module you own.
The optional PostgreSQL toolkit installs SQLAlchemy, pgvector, and inflection only when a project asks for them.
pip install "patos[sql]"
from patos import sql
Patterns
Creational
| pato | description | docs |
|---|---|---|
Singleton |
one instance per class, __init__ runs once |
docs |
FlyweightMeta |
a metaclass that interns instances by constructor args, build-once and immutable | docs |
Dispatch & selection
| pato | description | docs |
|---|---|---|
Registry |
self-registering class hierarchies via __init_subclass__, with try-each dispatch, select(predicate) and first_available() |
docs |
Strategy |
a named family of interchangeable implementations, with first_available() |
docs |
value_dispatch |
dispatch on a value the way singledispatch dispatches on a type |
docs |
type_dispatch |
dispatch on the first argument's type, the open-type-ladder dual of value_dispatch |
docs |
Structural & lifecycle
| pato | description | docs |
|---|---|---|
Decorator |
a transparent wrapper that forwards everything to the wrapped object but what it overrides | docs |
Pipeline |
a reversible stack of stages, applied forward and unwound in reverse around a core op | docs |
Lifecycle |
a typed state machine that permits only the transitions its table declares | docs |
DerivedCache |
a load-once cache of a derived value keyed by exactly what it depends on | docs |
Command-line
| pato | description | docs |
|---|---|---|
StrFlag |
an enum Flag whose members carry a literal string, OR-combinable and iterable |
docs |
Optional extensions
| namespace | description | docs |
|---|---|---|
sql |
typed SQLModel columns, native PostgreSQL enums, pgvector cosine distance, JSONB reads, and set based SQL helpers | docs |
Example
from patos import Singleton
class Settings(Singleton):
def __init__(self) -> None:
self.debug = False
a = Settings()
a.debug = True
b = Settings() # same object, __init__ did not run again
assert a is b and b.debug
Documentation
Full documentation lives at phvv.me/patos.
Development
- Install:
pip install -e ".[dev]" - Lint:
ruff check . && ruff format --check . - Typecheck:
pyrefly check - Test:
pytest - Docs:
pip install -e ".[docs]" && mkdocs build - Build:
python -m build
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file patos-0.0.9.tar.gz.
File metadata
- Download URL: patos-0.0.9.tar.gz
- Upload date:
- Size: 507.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
28e851e63963c95a3d596be5fb66f6eb495ccfd3d7aec6ba644742c420c970bc
|
|
| MD5 |
0b42a3f4bf1c543118e1f7d45f8b1a1d
|
|
| BLAKE2b-256 |
d3d043ec25469b259ff9bf495fdce657a3b027f6d5c51acacdbdcc229f4f15c6
|
Provenance
The following attestation bundles were made for patos-0.0.9.tar.gz:
Publisher:
publish.yml on phvv-me/patos
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
patos-0.0.9.tar.gz -
Subject digest:
28e851e63963c95a3d596be5fb66f6eb495ccfd3d7aec6ba644742c420c970bc - Sigstore transparency entry: 2180252659
- Sigstore integration time:
-
Permalink:
phvv-me/patos@06320de0d278bc4014ac8a66e78660a7257029e8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/phvv-me
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@06320de0d278bc4014ac8a66e78660a7257029e8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file patos-0.0.9-py3-none-any.whl.
File metadata
- Download URL: patos-0.0.9-py3-none-any.whl
- Upload date:
- Size: 33.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
86367b1a4b1262fce8322d5b252c169a61bb233dfe9497e36a182d4c4bfa8479
|
|
| MD5 |
714472a2b2de184b3d8edc3bf6688c60
|
|
| BLAKE2b-256 |
087f2d87a158e5f20bc235b15841323a47d0642c464af589e54186c3356e518d
|
Provenance
The following attestation bundles were made for patos-0.0.9-py3-none-any.whl:
Publisher:
publish.yml on phvv-me/patos
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
patos-0.0.9-py3-none-any.whl -
Subject digest:
86367b1a4b1262fce8322d5b252c169a61bb233dfe9497e36a182d4c4bfa8479 - Sigstore transparency entry: 2180252742
- Sigstore integration time:
-
Permalink:
phvv-me/patos@06320de0d278bc4014ac8a66e78660a7257029e8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/phvv-me
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@06320de0d278bc4014ac8a66e78660a7257029e8 -
Trigger Event:
push
-
Statement type:
