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.