NAME
WWW::TypePad::CmdLine - Helper library for writing WWW::TypePad apps
SYNOPSIS
use WWW::TypePad::CmdLine;
# Returns a WWW::TypePad instance, initialized with the necessary
# consumer key/secret and access token/secret.
my $tp = WWW::TypePad::CmdLine->initialize( requires_auth => 1 );
# Then, you can do something like this:
my $user = $tp->users->get( '@self' );DESCRIPTION
WWW::TypePad::CmdLine is a helper library for writing command-line applications that use WWW::TypePad. It handles the one-time OAuth authentication flow, config file setup, and storage of access tokens.
Tokens and configuration are stored between runs of your application in a config file. By default, that config file will be located at:
File::Spec->catfile( File::HomeDir->my_data, '.www-typepad-info' )File::HomeDir->my_data is an OS-aware data directory. On OS X, for example, it's ~/Library/Application Support.
WWW::TypePad::CmdLine automatically adds a --config command-line option for your application, so that it's easy to support different locations for configuration files.
On the first execution of a script using WWW::TypePad::CmdLine, you'll need to set the TP_CONSUMER_KEY and TP_CONSUMER_SECRET environment variables to the consumer key and secret for your TypePad application, respectively. You can also set TP_HOST to a host other than api.typepad.com. Once the configuration file is saved after the first call to initialize, future runs of your script won't require these environment variables.
USAGE
WWW::TypePad::CmdLine->initialize( %param )
Initializes and returns a new WWW::TypePad object, initialized with all of the necessary information to start using it for authenticated requests (see requires_auth).
The configuration and tokens are stored between runs of your application in a config file (see above). If the config file doesn't exist, and your application requires authentication (see requires_auth), initialize will send the user through the OAuth authentication flow.
When control returns to your application from calling initialize, you'll have a WWW::TypePad object initialized with everything you need to make authenticated (or non-authenticated) requests.
%param can contain:
requires_auth
Controls whether or not your application requires an authenticated user in order to function. This controls whether, in the absence of a configuration file, initialize will send the user through the OAuth authentication flow.
AUTHOR
Benjamin Trott <ben@sixapart.com>
LICENSE
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.