binabra 0.1.0

Portable bin-directory anchor for shell scripts — use sibling tools from anywhere

binabra

Portable bin directory anchor for shell scripts. Install once, reuse the same header anywhere.

• PyPI: binabra
• CLI: abra (the spell name stays short)
• Next in family: kadabra (related tool, coming later)

Install

pip install binabra

Ensure pip's script dir is on PATH (macOS example):

export PATH="$HOME/Library/Python/3.9/bin:$PATH"

Use anywhere

At the top of any shell script:

source "$(abra sh)"
exec "$BIN/my-sibling-tool" "$@"

BIN becomes the directory containing your script.

Bootstrap a project

abra init          # creates ./bin/abra
abra colocate bin  # copy abra into existing bin/

Co-located scripts:

source "$(dirname "${BASH_SOURCE[0]}")/abra"
exec "$BIN/other-script" "$@"

CLI

Command	Purpose
abra sh	Path to anchor.sh for sourcing
abra embed	Print source "$(abra sh)"
abra dir	Discover bin (ABRA_BIN, project bin/, ~/.local/bin)
abra exec tool args	Run sibling from discovered bin
abra init [dir]	Create bin/abra in a project
abra colocate [dest]	Copy abra into a bin folder

Publish to PyPI

1. Create an API token

https://pypi.org/manage/account/token/

• Scope: Entire account (first time) or Project: binabra (after first upload)
• Copy the token (pypi-...)

2. Build

cd ~/Projects/binabra
python3 -m pip install --user build twine
python3 -m build

3. Upload

export TWINE_USERNAME=__token__
export TWINE_PASSWORD=pypi-YOUR-TOKEN-HERE
twine upload dist/*

Or enter credentials when prompted:

twine upload dist/*
# username: __token__
# password: pypi-...

4. Verify

pip install binabra
abra --version
abra embed

PyPI project page: https://pypi.org/project/binabra/

Python API

from binabra import anchor_dir, sibling, discover_bin

anchor_dir(__file__)
sibling("run.sh", __file__)
discover_bin()