File perl-MooseX-App.spec of Package perl-MooseX-App

Overview Repositories Revisions Requests Users Attributes Meta

File perl-MooseX-App.spec of Package perl-MooseX-App (Revision 2f80d9341e1d258d6f859e65bb7293bc)

Currently displaying revision 2f80d9341e1d258d6f859e65bb7293bc , Show latest

#
# spec file for package perl-MooseX-App
#
# Copyright (c) 2016 SUSE LINUX GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#

Name:           perl-MooseX-App
Version:        1.34
Release:        0
%define cpan_name MooseX-App
Summary:        Write user-friendly command line apps with even less suffering
License:        Artistic-1.0 or GPL-1.0+
Group:          Development/Libraries/Perl
Url:            http://search.cpan.org/dist/MooseX-App/
Source0:        http://www.cpan.org/authors/id/M/MA/MAROS/%{cpan_name}-%{version}.tar.gz
Source1:        cpanspec.yml
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Config::Any)
BuildRequires:  perl(Module::Pluggable)
BuildRequires:  perl(Moose) >= 2.00
BuildRequires:  perl(MooseX::Types::Path::Class)
BuildRequires:  perl(Path::Class)
BuildRequires:  perl(Pod::Elemental)
BuildRequires:  perl(Test::Most)
BuildRequires:  perl(Test::NoWarnings)
BuildRequires:  perl(namespace::autoclean)
Requires:       perl(Config::Any)
Requires:       perl(Module::Pluggable)
Requires:       perl(Moose) >= 2.00
Requires:       perl(MooseX::Types::Path::Class)
Requires:       perl(Path::Class)
Requires:       perl(Pod::Elemental)
Requires:       perl(namespace::autoclean)
Recommends:     perl(File::HomeDir)
Recommends:     perl(IO::Interactive)
Recommends:     perl(Term::ReadKey)
Recommends:     perl(Text::WagnerFischer)
%{perl_requires}

%description
MooseX-App is a highly customisable helper to write user-friendly command
line applications without having to worry about most of the annoying things
usually involved. Just take any existing Moose class, add a single line
('use MooseX-App qw(PluginA PluginB ...);') and create one class for each
command in an underlying namespace. Options and positional parameters can
be defined as simple Moose accessors.

MooseX-App will then

* * Find, load and initialise the command classes (see MooseX::App::Simple
  for single command applications)

* * Create automated help and documentation from modules POD as well as
  attributes metadata and type constraints

* * Read, encode and validate the command line options and positional 
  parameters entered by the user from @ARGV and %ENV (and possibly prompt
  the user for additional parameters see MooseX::App::Plugin::Term)

* * Provide helpful error messages if user input cannot be validated 
  (either missing or wrong attributes or Moose type constraints not
  satisfied)

Commandline options are defined using the 'option' keyword which accepts
the same attributes as Moose' 'has' keyword.

option 'some_option' => (
      is            => 'rw',
      isa           => 'Str',
  );

This is equivalent to

has 'some_option' => (
      is            => 'rw',
      isa           => 'Str',
      traits        => ['AppOption'],   # Load extra metaclass
      cmd_type      => 'option',        # Set attribute type
  );

Single letter options are treated as flags and may be combined with
eachother.

Positional parameters are defined with the 'parameter' keyword

parameter 'some_option' => (
      is            => 'rw',
      isa           => 'Str',
  );

This is equivalent to

has 'some_option' => (
      is            => 'rw',
      isa           => 'Str',
      traits        => ['AppOption'],
      cmd_type      => 'parameter',
  );

All keywords are imported by Moosex::App (in the app base class) and
MooseX::App::Command (in the command class) or MooseX::App::Simple (single
class application).

Furthermore, all options and parameters can also be supplied via %ENV

option 'some_option' => (
      is            => 'rw',
      isa           => 'Str',
      cmd_env       => 'SOME_OPTION',
  );

Moose type constraints help MooseX::App to construct meaningful error
messages and parse @ARGV in a meaningful way. These type constraints are
supported

* * ArrayRef: Specify multiple values ('--list value1 --list value2',
  also see app_permute)

* * HashRef: Specify multiple key value pairs (--option key=value, 
  also see app_permute)

* * Enum: Display all possibilites

* * Bool: Flags that do not require values

* * Int, Num: Used for proper error messages

Read the Tutorial for getting started with a simple MooseX::App command
line application.

%prep
%setup -q -n %{cpan_name}-%{version}
find . -type f ! -name \*.pl -print0 | xargs -0 chmod 644

%build
%{__perl} Makefile.PL INSTALLDIRS=vendor
%{__make} %{?_smp_mflags}

%check
%{__make} test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes LICENCE README TODO

%changelog

Places

File perl-MooseX-App.spec of Package perl-MooseX-App (Revision 2f80d9341e1d258d6f859e65bb7293bc)

Places