#!/usr/bin/env perl

# ABSTRACT: Interact with a remote a Pinto repository
# PODNAME: pinto-remote

use strict;
use warnings;

#-----------------------------------------------------------------------------

our $VERSION = '0.038'; # VERSION

#-----------------------------------------------------------------------------

use App::Pinto::Remote;
exit App::Pinto::Remote->run();

#-----------------------------------------------------------------------------



=pod

=for :stopwords Jeffrey Ryan Thalhammer Imaginative Software Systems

=head1 NAME

pinto-remote - Interact with a remote a Pinto repository

=head1 VERSION

version 0.038

=head1 SYNOPSIS

  pinto-remote --root=URL [GLOBAL OPTIONS] COMMAND [OPTIONS] [ARGS]

  pinto-remote help COMMAND

  pinto-remote manual COMMAND

=head1 DESCRIPTION

L<pinto-remote> is a command line utility for using a remote Pinto
repository.  See L<pinto-admin> for information on creating a Pinto
repository, and L<pinto-server> for information on providing remote
access to the repository.

Once a Pinto repository has been established and the C<pinto-server>
is running, you can use C<pinto-remote> to add distributions, remove
packages, or inspect the contents of the repository.

=head1 GLOBAL OPTIONS

The following options are available for all commands.

=over 4

=item --root=URL

Specifies the root URL of your remote repository (i.e. this is where
L<pinto-server> is listening).  You may omit the C<http://> part if
you like.  And if you do not specify a port in your URL, then it
defaults to default port used by L<pinto-server> (which is currently
3000).  Alternatively, you can set the C<PINTO_REPOSITORY_ROOT>
environment variable to the root URL of your remote repository.  If no
root is specified, it defaults to C<http://localhost:3000>

=item --username=USER

Specifies the username to use for server authentication.  If not
provided, and a --password is used, defaults to the current user
login.

=item --password=PASSWORD

=item --password=-

Specifies the password to use for server authentication. If not
provided, no authentication is attempted. If C<PASSWORD> is the
special character '-' then you'll be prompted to provide the actual
password.

=item −quiet | -q

Report only fatal errors.  This option silently overrides the
C<--verbose> options.

=item --verbose | -v

Display more diagnostic messages.  This switch can be repeated
multiple times for greater effect.

=back

=head1 COMMANDS

C<pinto-remote> supports several commands that perform various
operations on your remote repository, or report information about your
remote repository.  To get a listing of all the available commands:

  $> pinto-remote commands

Each command has its own options and arguments.  To get a brief summary:

  $> pinto-remote help <command>

To see the complete manual for a command:

  $> pinto-remote manual <command>

=head1 SEE ALSO

L<pinto-admin> to create and manage a Pinto repository.

L<pinto-server> to allow remote access to your Pinto repository.

L<Pinto::Manual> for broad information about using the Pinto tools.

=head1 AUTHOR

Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Imaginative Software Systems.

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

=cut


__END__

