tundish
tundish is a local inbox for agents. Programs publish JSON items into named
queues in one SQLite file. A subscription filters the items and renders them
as text for a subscriber. A hook runs tundish pull and injects the printed
text into the agent's session.
Install
The command is tundish, whichever package you install.
Archives of precompiled binaries for macOS and Linux cover x86-64 and arm64. The Linux binaries are static executables. Each archive holds the binary, its man pages, the README and the license. There is no Windows build.
| Package manager | Package | Command |
|---|---|---|
| Homebrew | cjohnhanson/tap/tundish | brew install cjohnhanson/tap/tundish |
| Cargo | tundish | cargo install tundish |
| uv | tundish | uv tool install tundish |
| pip | tundish | pip install tundish |
| npm | tundish | npm install -g tundish |
| Nix | flake | nix profile install github:cjohnhanson/tundish |
Building from source
tundish is written in Rust. It needs Rust 1.88 or newer and a C compiler
for the bundled SQLite library. The repository pins a toolchain in
rust-toolchain.toml.
git clone https://github.com/cjohnhanson/tundish
cd tundish
cargo build --release
./target/release/tundish --version
The binary is target/release/tundish. Put it on PATH to run the
commands below.
Usage
tundish publish slack --key slack:C123 '{"text":"Review PR 42"}'
tundish subscribe inbox --as reviewer --queue slack --consume on-ack
tundish pull inbox --as reviewer
In a new database, the publish prints 1 and the subscribe prints:
created inbox
bound reviewer to inbox
rules: {"queue":"slack","select":"since_last_read","consume":"on_ack","share":"all","lease":600,"max_attempts":3,"start":"all"}
The pull prints:
tundish: subscription=inbox subscriber=reviewer delivered=1 more=0 unacked=0 parked=0 errors=0 dropped=0 lease=0
[slack#1] slack:C123 {"text":"Review PR 42"}
To take responsibility for the item, run
tundish ack 1 --as reviewer --subscription inbox.
Keep reviewer as a stable subscriber name across sessions.
How it works
A subscription stores a queue name, filter, template, and delivery rules.
A position records delivery progress. By default, every subscriber
receives each matching item once. With share one and
on-ack, a pull leases the item to one subscriber until an ack or lease
expiry. Acks and leases belong to that subscription. Publishing and
pulling open the local SQLite file and exit when done; tundish runs no
daemon.
Python
The tundish Python package also installs the command. It supports
CPython 3.10 and later:
import tundish
item_id = tundish.publish("slack", {"text": "hi"}, key="slack:C123")
Documentation
- Getting started: publish, pull, ack, and receive an item through a hook
- How to deliver tundish items through a gaff handler: handler setup and delivery intervals
- How to publish into tundish from a program: Python and Slack Socket Mode
- CLI reference: commands, rules, config, and exit codes
- What is tundish?: queues, subscriptions, delivery, and retention
Run tundish docs to read the same documentation from the binary.
License
MIT.
Metadata
Release files for tundish 0.1.2
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 |
|---|---|---|---|---|
| tundish-0.1.2.tar.gz | 70.8 kB | Without provenance | Details for tundish-0.1.2.tar.gz |
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| tundish-0.1.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ x86-64 | Details for tundish-0.1.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
| tundish-0.1.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ ARM64 | Details for tundish-0.1.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
| tundish-0.1.2-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details for tundish-0.1.2-cp310-abi3-macosx_11_0_arm64.whl |
| tundish-0.1.2-cp310-abi3-macosx_10_12_x86_64.whl | CPython 3.10 | abi3 | macOS 10.12+ x86-64 | Details for tundish-0.1.2-cp310-abi3-macosx_10_12_x86_64.whl |
Total release size: 13.5 MB
Release files / tundish-0.1.2.tar.gz
| Download URL | tundish-0.1.2.tar.gz |
|---|---|
| Size | 70.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
432c34862d6c5abd5374f16ba9c6ce0431e38f9c82f6c4e4618c91e9b433c881
|
|
BLAKE2b-256 checksum How to use checksums |
5cdab867486b7326045ce69c6f3bba9b2482c6b9520c4a2d27062f079d3efc7c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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 / tundish-0.1.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | tundish-0.1.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 3.5 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
d28141485e82ea336b7b9a6c75927e6685309cd84ac4e72d391de37c8768d42a
|
|
BLAKE2b-256 checksum How to use checksums |
16d9c53fd89e5415772878f7f1379a4ea435bd56652ff64cf604bd967cffcc7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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 / tundish-0.1.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | tundish-0.1.2-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
0213a50b1fc464da652ae99ad91383f3671a18f1cdf898e51b798f390e2556fb
|
|
BLAKE2b-256 checksum How to use checksums |
8775138ff8536e8b8e5c98880d248b510fdd682ddcb6a230f525061e46229c25
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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 / tundish-0.1.2-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | tundish-0.1.2-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
540d95bf728d13035720ecc2c15418524f9b0c1099b10bf22a05d3f5382f1969
|
|
BLAKE2b-256 checksum How to use checksums |
0cb482e8df4fb4126a90a77a51974fceb4f4e1bf3102cc427a185ad0dfeb611d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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 / tundish-0.1.2-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | tundish-0.1.2-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.5 MB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
8c1fec69bd13ca7d91470026deb2a0e48826b24587b02c7579d49d170bcdbc56
|
|
BLAKE2b-256 checksum How to use checksums |
9df113a34695ec60d4f7de778facf5b7eecf1bf0996a1f2e096bb38efb37e162
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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 tundish 0.1.2
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.