bitbucket2github / README

.. -*- restructuredtext -*-

BitBucket2GitHub
=============================

What is it?
-----------------------------------------
BitBucket and GitHub are two popular services for developers to host and share their code online. Nowadays it is a common practice to mirror a project's source code in both services so that users can easily watch and fork the project from their favorite service.

But manually syncing BitBucket and GitHub is tedious and error prone. I developed this little package to automate the syncing both ways.

How to use it?
-----------------------------------------
* Call "bitbucket2github" to mirror all public repos in BitBucket account to GitHub. It will prompt you for BitBucket username, GitHub username and GitHub API key.
* Call "github2bitbucket" to mirror all public repos in GitHub account to BitBucket. It will prompt you for GitHub username, BitBucket username and BitBucket password.


Latest Version
-----------------------------------------
The latest version of this project can be found at : http://bitbucket.org/sramana/bitbucket2github


Installation
-----------------------------------------
Option 1  ::

    sudo pip install bitbucket2github

Option 2 : If you downloaded the source code  ::

    tar xzvf bitbucket2github-1.0.tar.gz
    cd bitbucket2github-1.0
    sudo python setup.py install


License
-----------------------------------------
This project is licensed under New BSD license.


Contribution and Feedback
-----------------------------------------
Contributions and Feedback are most welcome. Please email the author with your comments.


Author Information
-----------------------------------------
Ramana <sramana9@gmail.com>

* http://bitbucket.org/sramana
* http://github.com/sramana
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.