bitbucket-batch is a command-line tool for making bulk access updates to Bitbucket repositories. It is useful in a corporate team situation where a single company account exists for managing private repositories with each team member having their own account with write access to these repositories. When a new member joins or leaves the team, the process of manually adding or removing write access to all of the company's repositories can be tedious. bitbucket-batch allows you to make access updates to all of the company's repositories in a single command.
Assuming you have setuptools installed, the easiest method is to install directly from pypi by running the following command:
$ easy_install -U bitbucket-batch
Otherwise you can download bitbucket-batch and install it directly from source:
$ python setup.py install
Once installed, the command bitbucket-batch should be available which can be run in the following format:
$ bitbucket-batch repo_owner operation role user
Each of the required arguments are:
- repo_owner: The Bitbucket username for the owner of the repositories the bulk update will be made to.
- operation: The operation to apply which is either add or remove.
- role: The role to use for the operation which is either reader, writer or admin.
- user: The Bitbucket username that the operation will be made for.
For example, to add the user stephenmcd as a writer to all repositories owned by the user citrus, the command would be:
$ bitbucket-batch citrus add writer stephenmcd