NAME

Catalyst::Helper::AuthDBIC (EXPERIMENTAL)

SUMMARY

This is an experimental module to bootstrap the authentication portion of a Catalyst application. It creates a Catalyst model, DBIx::Class::Schema classes, basic templates adjusts the required plugins for you, and configures authentication. There are no options, and it doesn't do much inthe way of error checking for you, so you are recommended to back up your application before using this module.

USAGE

Run the auth_bootstrap.pl in your application's root dir.

The helper also creates a script in the script dir. To add a user (with an optional role) do:

 myapp_auth_admin.pl -user username -passwd password [-role role] [-email me@example.com]

sub app_name()

Get the name of the application from Makefile.PL

sub make_model()

Creates the sqlite auth db in ./db and makes the dbic schema and catalyst model with Catalyst::Helper::Model::DBIC::Schema

sub mk_auth_controller()

uses Catalyst::Helper to make a ::Controller::Auth

sub add_plugins()

    uses ppi to add the auth plugins in the use Catalyst qw// statement

sub add_config()

Add the auth configuration in MyApp.pm

sub write_templates()

make the login, logout and unauth templates

sub update_makefile()

Adds the auth and session dependencies to Makefile.PL

sub add_user_helper()

A little script to add a user to the database.

BUGS

This is experimental, fairly rough code. It's a proof of concept for helper modules for Catalyst that need to alter the application configuration, Makefile.PL and other parts of the application. Bug reports, and patches are encouraged. Report bugs or provide patches to http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-Helper-AuthDBIC.

AUTHOR

Kieren Diment <zarquon@cpan.org>

COPYRIGHT AND LICENCE

Copyright (c) 2008 Kieren Diment

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

See http://www.perl.com/perl/misc/Artistic.html

cpanm Catalyst::Helper::AuthDBIC

perl -MCPAN -e shell
install Catalyst::Helper::AuthDBIC