NAME
   Passwd::Keyring::Gnome - Password storage implementation based on GNOME
   Keyring.

VERSION
   Version 0.3001

SYNOPSIS
   Gnome Keyring based implementation of Keyring. Provide secure storage
   for passwords and similar sensitive data.

       use Passwd::Keyring::Gnome;

       my $keyring = Passwd::Keyring::Gnome->new(
            app=>"blahblah scraper",
            group=>"Johnny web scrapers",
       );

       my $username = "John";  # or get from .ini, or from .argv...

       my $password = $keyring->get_password($username, "blahblah.com");
       unless( $password ) {
           $password = <somehow interactively prompt for password>;

           # securely save password for future use
           $keyring->set_password($username, "blahblah.com");
       }

       login_somewhere_using($username, $password);
       if( password_was_wrong ) {
           $keyring->clear_password($username, "blahblah.com");
       }

   Note: see Passwd::Keyring::Auto::KeyringAPI for detailed comments on
   keyring method semantics (this document is installed with
   `Passwd::Keyring::Auto' package).

SUBROUTINES/METHODS
 new(app=>'app name', group=>'passwords folder')
   Initializes the processing. Croaks if gnome keyring does not seem to be
   available.

   Handled named parameters:

   - app - symbolic application name (not used at the moment, but can be
   used in future as comment and in prompts, so set sensibly)

   - group - name for the password group (will be visible in seahorse so
   can be used by end user to manage passwords, different group means
   different password set, a few apps may share the same group if they need
   to use the same passwords set)

 set_password(username, password, realm)
   Sets (stores) password identified by given realm for given user

 get_password($user_name, $realm)
   Reads previously stored password for given user in given app. If such
   password can not be found, returns undef.

 clear_password($user_name, $realm)
   Removes given password (if present)

   Returns how many passwords actually were removed

 is_persistent
   Returns info, whether this keyring actually saves passwords
   persistently.

   (true in this case)

AUTHOR
   Marcin Kasperski

BUGS
   Please report any bugs or feature requests to issue tracker at
   https://bitbucket.org/Mekk/perl-keyring-gnome.

SUPPORT
   You can find documentation for this module with the perldoc command.

       perldoc Passwd::Keyring::Gnome

   You can also look for information at:

   http://search.cpan.org/~mekk/Passwd-Keyring-Gnome/

   Source code is tracked at:

   https://bitbucket.org/Mekk/perl-keyring-gnome

LICENSE AND COPYRIGHT
   Copyright 2012 Marcin Kasperski.

   This program is free software; you can redistribute it and/or modify it
   under the terms of either: the GNU General Public License as published
   by the Free Software Foundation; or the Artistic License.

   See http://dev.perl.org/licenses/ for more information.