NAME

Net::PMP::CLI - command line application for Net::PMP::Client

SYNOPSIS

use Net::PMP::CLI;
my $app = Net::PMP::CLI->new_with_options();
$app->run();

DESCRIPTION

This class is used by the pmpc command-line tool. It uses MooseX::SimpleConfig and MooseX::Getopt to allow for simple configuration file and option parsing.

METHODS

With the exceptions of run and init_client all method names are commands.

run

Main method. Calls commands passed via @ARGV.

commands

Returns usage text for available commands.

search( query )

Executes search for query and prints results to stdout.

delete_by_search( query )

Execute search for query and deletes the results.

create

Create or update a resource via Net::PMP::Client. Requires the --profile and --title options.

create_credentials

Create a credential set. Requires --user and --pass options, and optionally --scope --expires --label.

delete

Deletes a resource. Requires the --guid option.

delete_by_tag([tag])

Deletes all resources that match a search for tag.

users

List all users.

groups

List all groups.

get([path])

Issues a get_doc() for the URI represented by path. If path is not explicitly passed, looks at the --path option.

Dumps the resource for path to stdout.

put([filename])

Reads filename and PUTs it to the server. If missing, the file() attribute will be checked instead.

filename should represent a ready-to-save CollectionDoc in JSON format. A simple string substitution will be performed, replacing ${HOSTNAME} with the base PMP host for the configured environment.

add( parent_doc, child_doc )

Save child_doc as child of parent_doc.

init_client

Instantiates and caches a Net::PMP::Client instance.

AUTHOR

Peter Karman, <karman at cpan.org>

BUGS

Please report any bugs or feature requests to bug-net-pmp at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-PMP. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

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

perldoc Net::PMP::Client

You can also look for information at:

ACKNOWLEDGEMENTS

American Public Media and the Public Media Platform sponsored the development of this module.

LICENSE AND COPYRIGHT

Copyright 2013 American Public Media Group

See the LICENSE file that accompanies this module.