Bucket

A Command Line Interface for BitBucket. For now, only git is supported. Mercurial support is planned.

Add this line to your application's Gemfile:

gem 'bucket-cli'

And then execute:

$ bundle

Or install it yourself as:

$ gem install bucket-cli

After the installation, you can run

$ bucket setup

to start the configuration.

You need to add your BitBucket username and password (for now it's saved in plaintext in ~/.bucket with a permission bit of 0600, in the future this will change for oauth authorization).

You can initialize a new repository (as in doing git init), and automagically creating the repository on BitBucket and adding the remote to origin.

$ bucket init DIRECTORY

This will create a new (private) repository in DIRECTORY (can be . for current directory), and create a repository named after the destination folder (or as specified in the options) in your BitBucket account.

--name        NAME  A name for the repository in BitBucket
--description DESC  A description for the repository in BitBucket
--public            Mark the repository as public (private by default)

You can clone a repository directly from BitBucket with

$ bucket clone [USER]/REPOSITORY

where REPOSITORY is the repository name.

If [USER] is not supplied, it's assumed you want a repository from your own account. For example, if you want to clone the bucket-cli repository from your own account you can just use

$ bucket clone bucket-cli

but if it's from another account you need to specify it

$ bucket clone xaro/bucket-cli

You can list the repositories associated with your account by using

$ bucket repos

• Improve error reporting (and exceptions catching)
• Add more commands
• Shallow redirect commands to git / mercurial
• Replace bitbucket api gem (it has too many dependencies and is not complete)

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request