File Coverage

blib/lib/TiddlyWeb/Resting/Getopt.pm

Criterion	Covered	Total	%
statement	15	22	68.1
branch			n/a
condition			n/a
subroutine	5	7	71.4
pod	2	2	100.0
total	22	31	70.9

package TiddlyWeb::Resting::Getopt;
use strict;
use warnings;
use base 'Exporter';
use TiddlyWeb::Resting::DefaultRester;
use Getopt::Long qw/:config/;
our @EXPORT_OK = qw/get_rester rester_usage/;

=head1 NAME

TiddlyWeb::Resting::Getopt - Handle command line rester args

=head1 SYNOPSIS

  use TiddlyWeb::Resting::Getopt qw/get_rester/;
  my $rester = get_rester();

=cut

our $VERSION = '0.01';

=head1 FUNCTIONS

=head2 get_rester

Create a new rester from command line args.

=cut

sub get_rester {
    my %opts = @_;
    Getopt::Long::Configure('pass_through');
    GetOptions(
        \%opts,
        'server|s=s',
        'workspace|w=s',
        'username|u=s',
        'password|p=s',
        'user_cookie=s',
        'rester-config|c=s',
    );
    Getopt::Long::Configure('no_pass_through');
    return TiddlyWeb::Resting::DefaultRester->new(%opts);
}

=head2 rester_usage

Return usage text for the arguments accepted by this module.

=cut

sub rester_usage {
    my $rc_file = $TiddlyWeb::Resting::DefaultRester::CONFIG_FILE;
    return <
REST API Options:
 --server      TiddyWeb server
 --username    User to login as
 --password    User password
 --user_cookie tiddlyweb_user cookie to use (supercedes username & password)
 --workspace   Workspace to use
 --rester-config   Config file containing 'key = value'

Rester Config:
Put the above options into $rc_file like this:

  username = some_user\@foobar.com
  password = your_pass
  workspace = your_workspace
  server   = https://www.socialtext.net
EOT
}

=head1 AUTHOR

Luke Closs, C<<  >>

=head1 LICENSE

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

=cut

1;