bibu
A Bitbucket command line client written in bash.
bibu
is distributed as Python package. It's best downloaded from the Python Packaging Index PyPI by
pip install --user bibu
Alternatively you can install the relevant bash files: the main executable bibu
into ~/.local/bin
and the bash library bibu.bash
into ~/.local/lib
.
In either case take care to add ~/.local/bin
to your $PATH
.
Obtain OAuth consumer key and secret from your Bitbucket profile settings:
team pipeline:variable webhook pullrequest:write snippet:write wiki repository:admin project issue:write account
)$BITBUCKET_REST_API_AUTH
(separated by colon)bibu
depends on curl
and jq
.
It's tested against bash
4.4.19, curl
7.64.0, jq
1.6 in an Alpine Linux Docker image.
Consult bibu --help
bibu operates on the repository of the current working directory, and derives
information from 'git-remote'.
Available commands:
issue Manage Bitbucket issues
pipeline Manage Bitbucket pipelines
pr Manage Bitbucket pullrequests
api Get resource via REST API
General options:
--help Display help message
Start a pipeline called all-tests
on current HEAD
bibu pipeline run -n all-tests
View most recent pipeline runs
bibu pipeline list
Create a pull-request. You will be prompted for title and description (using $EDITOR
).
bibu pr create
Get the patch of the pull-request #42
bibu api pullrequests/42/patch
Get comments on issue #7
bibu api issues/7/comments | jq '.values[] | .content.raw'
Future features... Feel free to contribute!
Fetch the Docker image
docker pull pylipp/bibu:latest
Install development dependencies into Python venv
pip install -U .[dev]
Tests are written with bats. Execute test suite
./run test
or a dedicated test
./run test tests/cli.bats
Editable pip-install is not compatible with using the data_files
option in setup.py
. Hence apply the work-around
./run install
vX.Y.Z
../run release