yeetr, build tiny CLIs. Easy to code. Based on Python type hints.
yeetr
A tiny, typed, signature-driven CLI runner. Supports Python 3.13 and 3.14.
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
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 yeetr-2026.8.21.tar.gz.
File metadata
- Download URL: yeetr-2026.8.21.tar.gz
- Upload date:
- Size: 19.6 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64be256d3a10780ce8755681f89de54ab52d2d0e64aa7b84fd4f7f64b92e1649
|
|
| MD5 |
750c05b126244ebd9cf21240830d82e0
|
|
| BLAKE2b-256 |
3b1c5b82b941384b2b1d61ef498696b27cd0bd38c3ecd6d5d0c0e011c2ed072d
|
File details
Details for the file yeetr-2026.8.21-py3-none-any.whl.
File metadata
- Download URL: yeetr-2026.8.21-py3-none-any.whl
- Upload date:
- Size: 18.4 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d146a2b01ab69868e1e4172b84168bdba34ac533b2d219399df16ecac54129ea
|
|
| MD5 |
9d78e10e49f6251e389662a5b6450d56
|
|
| BLAKE2b-256 |
30ed823b4fc9238d23e82f3cb3afff37a3d702ce213d31d7fa7a154e94f7608c
|
