X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass.pm;h=db6eda095904bd4ca6636f790cab169696d816f7;hb=503536d5b216b4d85ed3f5420f3db93d4c033d86;hp=43ce5389bb96f5421a9adfbf9ace9625c8d673bf;hpb=ea2e61bf5bb7187dc5e56513cd66c272d71d5074;p=dbsrgits%2FDBIx-Class-Historic.git diff --git a/lib/DBIx/Class.pm b/lib/DBIx/Class.pm index 43ce538..db6eda0 100644 --- a/lib/DBIx/Class.pm +++ b/lib/DBIx/Class.pm @@ -1,5 +1,94 @@ package DBIx::Class; -use base qw/DBIx::Class::CDBICompat DBIx::Class::Core/; +use strict; +use warnings; + +use vars qw($VERSION); +use base qw/DBIx::Class::Componentised/; + +$VERSION = '0.03'; + 1; + +=head1 NAME + +DBIx::Class - Because the brain is a terrible thing to waste. + +=head1 SYNOPSIS + +=head1 DESCRIPTION + +This is a sql to oop mapper, inspired by the L framework, +and meant to support compability with it, while restructuring the +insides, and making it possible to support some new features like +self-joins, distinct, group bys and more. + +It's currently considered EXPERIMENTAL - bring this near a production +database at your own risk! The API is *not* fixed yet, although most of +the primitives should be good for the future and any API changes will be +posted to the mailing list before they're committed. + +The community can be found via - + + Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/ + + SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/ + + Wiki: http://dbix-class.shadowcatsystems.co.uk/ + + IRC: irc.perl.org#dbix-class + +=head1 QUICKSTART + +If you're using Class::DBI, replacing + + use base qw/Class::DBI/; + +with + + use base qw/DBIx::Class/; + __PACKAGE__->load_components(qw/CDBICompat Core DB/); + +will probably get you started. + +If you're using AUTO_INCREMENT for your primary columns, you'll also want +yo load the approriate PK::Auto subclass - e.g. + + __PACKAGE__->load_components(qw/CDBICompat PK::Auto::SQLite Core DB/); + +(with is what ::Test::SQLite does to present the Class::DBI::Test::SQLite +interface) + +If you fancy playing around with DBIx::Class from scratch, then read the docs +for DBIx::Class::Table, ::Row, ::Schema, ::DB and ::Relationship, + + use base qw/DBIx::Class/; + __PACKAGE__->load_components(qw/Core DB/); + +and have a look at t/lib/DBICTest.pm for a brief example. + +=head1 AUTHOR + +Matt S. Trout + +=head1 CONTRIBUTORS + +Andy Grundman + +Brian Cassidy + +Dan Kubb + +Dan Sully + +davekam + +Marcus Ramberg + +=head1 LICENSE + +You may distribute this code under the same terms as Perl itself. + +=cut +