The team b cli
The team b cli
This is a cli platform to help a developer manage multiple repositories and other common automation tasks.
tb can be installed in your local Python 3.7 environment or it can be downloaded as a single binary for your operating system.
pip install tb-cli
Operating system-specific binary install
- Visit https://bitbucket.org/mrdon/tb/downloads/ and download the release for your operating system.
- Untar the file and you will find a single 'tb' binary.
- Place it somewhere in your path
- Upon first execution of a repo command like 'tb repo', it will ask you some questions about your environment
This project includes a number of helpers in the
Makefile to streamline common development tasks.
To install it in development mode, run
This will not only install tb in a local virtualenv, but also build the 'tb' binary in dist/
The following demonstrates setting up and working with a development environment:
# create a virtualenv for development make virtualenv source env/bin/activate # run tb cli application tb --help # run pytest / coverage make test
Releasing to Bitbucket
The tb release process uses Bitbucket pipelines to release the version and release the linux binary (OSX has to be released manually).
To run a release:
- Find the commit you want to release. For the latest commit, you'd visit: https://bitbucket.org/mrdon/tb/commits/master
- Find the "Run pipeline" link on the right side and click "Run". This will update the CHANGES.MD file with the release info, tag the repository, build the binary, upload the binary to Bitbucket, then finally change the version to the next dev version.
- Build and upload the OSX release
- You must create a Bitbucket app token that has the ability to write to your repositories. Remember this, along with your Bitbucket user name, as it will be needed in the last step
- Get access to an OSX machine and run the next steps on that machine.
- Clone the tb repository and checkout the tag that was created previously
- Run the osx release command:
Pull requests, issues and comments welcome. For pull requests:
- Add tests for new features and bug fixes
- Follow the existing style
- Separate unrelated changes into multiple pull requests
See the existing issues for things to start contributing.
For bigger changes, make sure you start a discussion first by creating an issue and explaining the intended change.
Copyright (c) 2019 Don Brown, Atlassian and others. Apache 2.0 licensed, see LICENSE.txt file.