Bazaar Tweet
=============

This is a plugin for Bazaar VCS that posts messages to Twitter/Identi.ca
when you commit or push new revisions. You can authenticate with
tweet-auth, set the branch id with tweet-branchid and just use commit
or push commands to tweet.

Installation:

This plugin depends on python-twitter (>= 0.8) and python-oauth2
 The following commands install this plugin:
 
   $ ./setup.py build
   $ sudo ./setup.py install

Configuration:

1. Authenticate with your account
 Run:
 
   $ bzr tweet-auth [SERVICE]
 
 You can choose "twitter" or "identica" as a service.
 This command returns the address of the authentication page.
 Please open it and copy the pin code to the terminal.
 
 This application has the following permissions:
  1. Read Tweets from your timeline
  2. See who you follow, and follow new people
  3. Update your profile
  4. Post Tweets for you
 
 1 to 3 permissions are not needed in this application, but there is no
 method to disable them.

 If you authenticated with both services, this plugin will
 tweet to each services.

2. Setup tweet branch id
 This plugin tweets like the following message:
 
   bzr commit: BRANCHID has the new revid: 10: example commit [bzr-tweet]
 
 You can set BRANCHID using the following command:
 
   $ bzr tweet-branchid [BRANCHID]
 
 You must set it, otherwise this plugin doesn't work.

3. Tweet on Push option
 This plugin tweets new revisions on commit command on default. You can
 change this behavior to tweet commit messages on push command. To change
 this option, add the following line to branch.conf
 
    tweet_on_push = yes

