NAME Config::Identity - Load (and optionally decrypt via GnuPG) user/pass identity information VERSION version 0.0012 SYNOPSIS PAUSE: use Config::Identity::PAUSE; # 1. Find either $HOME/.pause-identity or $HOME/.pause # 2. Decrypt the found file (if necessary), read, and parse it # 3. Throw an exception unless %identity has 'user' and 'password' defined my %identity = Config::Identity::PAUSE->load; print "user: $identity{user} password: $identity{password}\n"; GitHub API: use Config::Identity::GitHub; # 1. Find either $HOME/.github-identity or $HOME/.github # 2. Decrypt the found file (if necessary) read, and parse it # 3. Throw an exception unless %identity has 'login' and 'token' defined my %identity = Config::Identity::PAUSE->load; print "login: $identity{login} token: $identity{token}\n"; DESCRIPTION Config::Identity is a tool for loadiing (and optionally decrypting via GnuPG) user/pass identity information For GitHub API access, an identity is a "login"/"token" pair For PAUSE access, an identity is a "user"/"password" pair See the SYNOPSIS for usage Encrypt your identity information with GnuPG If you've never used GnuPG before, first initialize it: # Follow the prompts to create a new key for yourself gpg --gen-key To encrypt your GitHub identity with GnuPG using the above key: # Follow the prompts, using the above key as the "recipient" # Use ^D once you've finished typing out your authentication information gpg -ea > $HOME/.github Suggested PAUSE identity format user <user> password <password> Suggested GitHub identity format login <login> token <token> USAGE See the SYNOPSIS AUTHOR Robert Krimen <robertkrimen@gmail.com> COPYRIGHT AND LICENSE This software is copyright (c) 2010 by Robert Krimen. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.