Boku
What is this?
Boku (僕, servant from Japanese) is a simple, sequential YAML task runner written in Python. While other, most likely much better tools exist that achieve this and much more, the intention was to create a lightweight tool that can help me with recurring tasks without writing much code to achieve this.
Why?
The idea was (and remains) to create a simple tool that I can personally use to automate simple tasks (with some added benefits like dependencies) without having to write code (either bash or python) to achieve this. It's NOT meant to be a replacement to other, much better and more sophisticated tools, but rather a simple solution to a simple problem with little to no learning curve, hence a simple YAML based syntax.
Installation
You can easily install/run boku via tools like pipx or uv:
- Via
pipx:pipx install https://git.sr.ht/~hxii/boku/archive/0.2.3.tar.gz. - Via
uv:uv tool install https://git.sr.ht/~hxii/boku/archive/0.2.3.tar.gz.
!!! Note I will figure out a brew formula for this at some point.
!!! Note There is probably a way to install the latest version when deploying on SourceHut, but I haven't gotten around to figuring that out yet.
Configuration
!!! IMPORTANT Configuration is yet to be implemented. Sorry!
See configuration documentation here.
Documentation
Skills
Step-by-step guides for common patterns and features - check the skills/ directory:
- Quick Start - First taskfile in 5 minutes
- Iteration - Loop over lists
- Dependencies - Control execution order
- Variables - Cross-references
- Conditionals - Skip and integrate
- Why Boku - When to use vs other tools
Metadata
Release files for boku2 0.2.4
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 |
|---|---|---|---|---|
| boku2-0.2.4.tar.gz | 60.0 kB | Without provenance | Details for boku2-0.2.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| boku2-0.2.4-py3-none-any.whl | Python 3 | none | any | Details for boku2-0.2.4-py3-none-any.whl |
Total release size: 80.5 kB
Release files / boku2-0.2.4.tar.gz
| Download URL | boku2-0.2.4.tar.gz |
|---|---|
| Size | 60.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7873aa55a74b9293b58faf3dd04d8fbdde1521169e4e27589008328d0e300af1
|
|
BLAKE2b-256 checksum How to use checksums |
83af6c9da62db91c095b41d052cdfa8cc6b799e053f5eabb4c5c0ad5a940baea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / boku2-0.2.4-py3-none-any.whl
| Download URL | boku2-0.2.4-py3-none-any.whl |
|---|---|
| Size | 20.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df6103ce896d360d8daa29bf64599ca229aedff76f15be890e70bd6dbc34462a
|
|
BLAKE2b-256 checksum How to use checksums |
148db6c26a59b3bbcc3e759479b59ce8388af6c0952aa6e153bc6a6240ef5410
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for boku2 0.2.4
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.