/ 
Rose-DBx-Garden-Catalyst-0.02
River stage zero No dependents
/ Rose::DBx::Garden::Catalyst

NAME

Rose::DBx::Garden::Catalyst - plant Roses in your Catalyst garden

SYNOPSIS

# create a Catalyst app
> catalyst.pl MyApp
    
# create a Rose::DBx::Garden::Catalyst script
> cat mk_cat_garden.pl
use Rose::DBx::Garden::Catalyst;
use MyDB;  # isa Rose::DB

my $garden = Rose::DBx::Garden::Catalyst->new(
                catalyst_prefix => 'MyApp',
                garden_prefix   => 'MyRDBO',
                db              => MyDB->new,
                tt              => 1,  # make Template Toolkit files
                );
                
$garden->plant('MyApp/lib');

# run your script
> perl mk_cat_garden.pl

# start your Catalyst dev server
> cd MyApp
> perl script/myapp_server.pl

# enjoy the fruits at http://localhost:3000/rdgc

DESCRIPTION

Rose::DBx::Garden::Catalyst extends Rose::DBx::Garden to create Catalyst components that use the RDBO and RHTMLO classes that the Garden class produces.

By default this class creates stub Template Toolkit files for use with the RDBO and RHTMLO CRUD components. If you use a different templating system, just set the tt option to 0.

METHODS

Only new or overridden methods are documented here.

init_base_code

Override the base method to create methods useful to RDBO classes used in Catalyst.

init_catalyst_prefix

Defaults to 'MyApp'.

plant( path/to/my/catapp )

Override the base method to create Catalyst-related files in addition to the basic Garden files.

make_catalyst( class_names, path )

Does the actual file creation of Catalyst files. Called by plant().

AUTHOR

Peter Karman, <karman at cpan.org>

BUGS

Known issues:

re-running the script fails to pick up all classes

This is due to issues with @INC and how the RDBO Loader requires classes. There is no known workaround at the moment.

javascript required

The TT templates generated depend heavily on the YUI toolkit http://developer.yahoo.com/yui/. Graceful degredation is not implemented as yet.

Please report any bugs or feature requests to bug-rose-dbx-garden-catalyst at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Rose-DBx-Garden-Catalyst. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Rose::DBx::Garden::Catalyst

You can also look for information at:

ACKNOWLEDGEMENTS

The Minnesota Supercomputing Institute http://www.msi.umn.edu/ sponsored the development of this software.

COPYRIGHT & LICENSE

Copyright 2007 by the Regents of the University of Minnesota.

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