Matt S Trout > DBIx-Class-0.03 > DBIx::Class

Download:
DBIx-Class-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  11
Open  16
Stalled  11
View/Report Bugs
Module Version: 0.03   Source   Latest Release: DBIx-Class-0.082700_13

NAME ^

DBIx::Class - Because the brain is a terrible thing to waste.

SYNOPSIS ^

DESCRIPTION ^

This is a sql to oop mapper, inspired by the Class::DBI 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

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.

AUTHOR ^

Matt S. Trout <mst@shadowcatsystems.co.uk>

CONTRIBUTORS ^

Andy Grundman <andy@hybridized.org>

Brian Cassidy <bricas@cpan.org>

Dan Kubb <dan.kubb-cpan@onautopilot.com>

Dan Sully <daniel@cpan.org>

davekam

Marcus Ramberg <mramberg@cpan.org>

LICENSE ^

You may distribute this code under the same terms as Perl itself.

syntax highlighting: