Simple, sequential YAML task runner
Project description
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
Release history Release notifications | RSS feed
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 boku2-0.2.4.tar.gz.
File metadata
- Download URL: boku2-0.2.4.tar.gz
- Upload date:
- Size: 60.0 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7873aa55a74b9293b58faf3dd04d8fbdde1521169e4e27589008328d0e300af1
|
|
| MD5 |
62b2c3b7dffb2a4a852322d66cbf7c19
|
|
| BLAKE2b-256 |
83af6c9da62db91c095b41d052cdfa8cc6b799e053f5eabb4c5c0ad5a940baea
|
File details
Details for the file boku2-0.2.4-py3-none-any.whl.
File metadata
- Download URL: boku2-0.2.4-py3-none-any.whl
- Upload date:
- Size: 20.5 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df6103ce896d360d8daa29bf64599ca229aedff76f15be890e70bd6dbc34462a
|
|
| MD5 |
6c72b3e38bf9e11988840f203ed1a7b1
|
|
| BLAKE2b-256 |
148db6c26a59b3bbcc3e759479b59ce8388af6c0952aa6e153bc6a6240ef5410
|
