Authen-Prepare version 0.01

DESCRIPTION

    Authen::Prepare sets up authentication credentials for a specific
    hostname, username, and password using a combination of stored
    information and user prompts. These credentials can be used in other
    scripts or modules that require authentication information. Using this
    module allows these other scripts to be flexible in their usage of
    authentication information without recoding user prompts or storing
    passwords in the code.

    The simplest use of this module is to create the initial object it with
    no arguments; the credentials will be built from a set of user prompts.

    A more full-featured use of this module is to specify all authentication
    information ahead of time using a password file and command-line
    arguments or environment variables. The initial object can then be
    created with three named arguments (hostname, username, and passfile)
    and the credentials for the specified hostname and username will be
    extracted from the password file. This allows the calling script to be
    used in an automated environment.

    Any combination of the named arguments can be provided; the user will be
    prompted for any missing information.

  Password File
    The password file must not have any group or world permissions in order
    to be usable by this module. Each line of the password file should
    contain the hostname, username, and password separated by a colon.

    Wildcards are supported in the hostname field only. This allows a
    default host to be specified.

    Comments may be added by prefixing a line with the '#' character.
    (Inline comments are not supported at this time.)

    NOTE: The password file is read from top to bottom so only the first
    match will be returned.

      Example:

      # this is a comment
      hostname1:username1:password1
      hostname2:username2:password2
      host*:username:password
      # default hostname
      *:username:password

INSTALLATION

To install this module, run the following commands:

    perl Makefile.PL
    make
    make test
    make install


Alternatively, to install with Module::Build, you can use the following
commands:

    perl Build.PL
    ./Build
    ./Build test
    ./Build install



DEPENDENCIES

    IO::Prompt
    Readonly
    Text::Glob


COPYRIGHT AND LICENCE

Copyright (C) 2007, David Narayan

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

$Id$