Authoritarian - Twitter OAuth Manager

DESCRIPTION

Authoritarian is a command line interface for managing Twitter authorizations to your application. God forbid Twitter give us a simple way to manually add test accounts to our application.

Authoritarian follows the rules of Semantic Versioning.

INSTALL

To install Authoritarian, simply install the gem:

$ [sudo] gem install authoritarian

TWITTER

APPLICATIONS

To authorize using Twitter's API, start by registering your application in authoritarian:

$ authoritarian add application
Name: My Cool App
Consumer Key: HJvxyS06ykAA5AxYruY2p
Consumer Secret: 4wftaMYXpylkveupjQ4YDDZlarS35UJHR1ZHHSfjto

You can find your Consumer Key and Consumer Secret for your application by going to the Twitter Developer Applications site and clicking on the application you'd like to add. The key and secret are listed under OAuth 1.0a Settings.

You can view your registered applications:

$ authoritarian show applications
$ authoritarian show applications --all

The --all option shows the consumer key and secret for each application.

Finally, you can remove your application by running:

$ authoritarian show applications

You'll be presented with prompts to select the application you wish to remove.

USERS

Once you've registered a Twitter application with Authoritarian, you can authorize individual Twitter users to your application from the command line.

To authorize a user, simply type:

$ authoritarian add user

And to show a list of all users, type:

$ authoritarian show users
$ authoritarian show users --all

The --all option will append the OAuth token and OAuth token secret for each user registered to Authoritarian.

To remove a user from Authoritarian (but not deauthorize), type:

$ authoritarian remove user

CONTRIBUTE

Contributions to Authoritarian are welcome! There is no mailing list currently but you can add a feature you're interested in building to the GitHub Issues page to discuss it.

If you do submit a pull request, please make sure you add test coverage and send your request from a git topic branch.

You can find the repository here:

http://github.com/benbjohnson/authoritarian