NAME

instantcrud.pl - Bootstrap a Catalyst application example

SYNOPSIS

instantcrud.pl ApplicationName [options]

 Options:
   -dsn            dsn
   -user           database user
   -password       database password
   -help           display this help and exits
   -model_name     model name (default: DBICSchemamodel) 
   -schema_name    schema name (default: DBSchema) 

 ApplicationName must be a valid Perl module name and can include "::".
 This version cannot update previously generated code base - it can only
 generate a new one.

 All options are optional, if no dsn is provided an example SQLite database will be 
 created and used.

 Examples:
    instantcrud.pl My::App -dsn='dbi:Pg:dbname=CE' -user=zby -password='pass'

DESCRIPTION

The catalyst.pl script bootstraps a Catalyst application example, creating a directory structure populated with skeleton files.

The application name must be a valid Perl module name. The name of the directory created is formed from the application name supplied, with double colons replaced with hyphens (so, for example, the directory for My::App is My-App).

Using the example application name My::App, the application directory will contain the following items:

README

a skeleton README file, which you are encouraged to expand on

Build.PL

a Module::Build build script

Changes

a changes file with an initial entry for the creation of the application

Makefile.PL

an old-style MakeMaker script. Catalyst uses the Module::Build system so this script actually generates a Makeifle that invokes the Build script.

lib

contains the application module (My/App.pm) and subdirectories for model, view, and controller components (My/App/M, My/App/V, and My/App/C).

root

root directory for your web document content. This is left empty.

script

a directory containing helper scripts:

my_app_create.pl: helper script to generate new component modules
my_app_server.pl: runs the generated application within a Catalyst test server, which can be used for testing without resorting to a full-blown web server configuration.
my_app_cgi.pl: runs the generated application as a CGI script
my_app_fastcgi.pl: runs the generated application as a FastCGI script
my_app_test.pl: runs an action of the generated application from the comand line.

t