yeetr, build tiny CLIs. Easy to code. Based on Python type hints.
yeetr
A tiny, typed, signature-driven CLI runner. Supports Python 3.13, 3.14, and 3.15.
No decorators. No command classes. No ceremony. Just yeet the function.
Write a plain function, run it from the command line — yeetr turns the
signature into args and options for you:
# app.py
def main(thing: int, *, n: float = 0.1) -> None:
print(thing, n)
yeet app.py 5 -n 0.2
No if __name__ == "__main__" block, no yeetr.run(...) call, no
decorators. Parameters before the bare * become positional args,
parameters after it become --options.
Install
uv add yeetr
Highlights
- Zero boilerplate —
yeet app.pyfinds and runsmain— or any public function you name — and scaffolds the file if it doesn't exist yet. - Executable shebangs —
#!yeetmakes a script runnable on its own;#!yeet FUNCpicks the function to run. - Fully typed —
str,int,float,bool,Path,datetime,date,time,UUID,Decimal,Literal,Enum,T | None,list[T], tuples, and structureddataclass/NamedTupleargs, all Pyright-strict clean. - Async-native —
async def mainjust works, with automatic uvloop if it's installed. - Rich output — formatted logging and help/error tables out of the box.
Docs
The full guide — parameter metadata, env var fallback, path validators, runtime behavior, a yeetr vs. typer comparison, and the API reference — lives at rogerthomas.github.io/yeetr.
Contributing
See CONTRIBUTING.md for how to set up a dev environment, run the test suite, and submit changes.
License
Metadata
Release files for yeetr 2026.10.28
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| yeetr-2026.10.28.tar.gz | 19.8 kB | Without provenance | Details for yeetr-2026.10.28.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| yeetr-2026.10.28-py3-none-any.whl | Python 3 | none | any | Details for yeetr-2026.10.28-py3-none-any.whl |
Total release size: 38.3 kB
Release files / yeetr-2026.10.28.tar.gz
| Download URL | yeetr-2026.10.28.tar.gz |
|---|---|
| Size | 19.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb45d918128073e97f80b3af2593645d6ca0b7fe3f2465a3c38cc45b8a2c742a
|
|
BLAKE2b-256 checksum How to use checksums |
2656dfb7d9d8ba6e43b96826ea3ce2b692d5a974f923fdd02aefc2d5ecea98a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / yeetr-2026.10.28-py3-none-any.whl
| Download URL | yeetr-2026.10.28-py3-none-any.whl |
|---|---|
| Size | 18.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2194bd608591ea939d73576f95589454e44f32787f6a91b1641490e025758184
|
|
BLAKE2b-256 checksum How to use checksums |
60cb193ee79822b0e434ec3c11245c86c3216e96f1afe6d70ad1006f651e0f80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for yeetr 2026.10.28
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.