Unified help display, at the cost of having lost the info about what you fucked up...

[catagits/Catalyst-Runtime.git] / lib / Catalyst / Script / Create.pm

package Catalyst::Script::Create;
use Moose;
use Catalyst::Helper;
use MooseX::Types::Moose qw/Bool/;
use namespace::autoclean;

with 'Catalyst::ScriptRole';

has force => (
    traits => [qw(Getopt)],
    cmd_aliases => 'nonew',
    isa => Bool,
    is => 'ro',
    documentation => 'Force new scripts',
);

has debug => (
    traits => [qw(Getopt)],
    cmd_aliases => 'd',
    isa => Bool,
    is => 'ro',
    documentation => 'Force debug mode',
);

has mechanize => (
    traits => [qw(Getopt)],
    cmd_aliases => 'mech',
    isa => Bool,
    is => 'ro',
    documentation => 'use WWW::Mechanize',
);

sub run {
    my ($self) = @_;

    $self->_exit_with_usage if !$ARGV[0];

    my $helper = Catalyst::Helper->new( { '.newfiles' => !$self->force, mech => $self->mech } );

    $self->_display_help unless $helper->mk_component( $self->app, @ARGV );

}

__PACKAGE__->meta->make_immutable;

=head1 NAME

Catalyst::Script::Create - Create a new Catalyst Component

=head1 SYNOPSIS

 myapp_create.pl [options] model|view|controller name [helper] [options]

 Options:
   -force        don't create a .new file where a file to be created exists
   -mechanize    use Test::WWW::Mechanize::Catalyst for tests if available
   -help         display this help and exits

 Examples:
   myapp_create.pl controller My::Controller
   myapp_create.pl controller My::Controller BindLex
   myapp_create.pl -mechanize controller My::Controller
   myapp_create.pl view My::View
   myapp_create.pl view MyView TT
   myapp_create.pl view TT TT
   myapp_create.pl model My::Model
   myapp_create.pl model SomeDB DBIC::Schema MyApp::Schema create=dynamic\
   dbi:SQLite:/tmp/my.db
   myapp_create.pl model AnotherDB DBIC::Schema MyApp::Schema create=static\
   dbi:Pg:dbname=foo root 4321

 See also:
   perldoc Catalyst::Manual
   perldoc Catalyst::Manual::Intro

=head1 DESCRIPTION

Create a new Catalyst Component.

Existing component files are not overwritten.  If any of the component files
to be created already exist the file will be written with a '.new' suffix.
This behavior can be suppressed with the C<-force> option.

=head1 AUTHORS

Catalyst Contributors, see Catalyst.pm

=head1 COPYRIGHT

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

=cut