From: Thomas Kratz Date: Thu, 8 Jun 2006 19:31:31 +0000 (+0000) Subject: - Changed version number to 0.01000 X-Git-Tag: v0.01001~5 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=ebb2fe4f2972890b1eea3c5fdbfaa51653848e33;p=dbsrgits%2FDBIx-Class-UUIDColumns.git - Changed version number to 0.01000 - A few documentation fixes --- diff --git a/lib/DBIx/Class/UUIDColumns.pm b/lib/DBIx/Class/UUIDColumns.pm index 7eca6bb..75efb8e 100644 --- a/lib/DBIx/Class/UUIDColumns.pm +++ b/lib/DBIx/Class/UUIDColumns.pm @@ -14,9 +14,8 @@ __PACKAGE__->uuid_class( __PACKAGE__->_find_uuid_module ); # i.e. first release of 0.XX *must* be 0.XX000. This avoids fBSD ports # brain damage and presumably various other packaging systems too -$VERSION = '0.06002'; +$VERSION = '0.01000'; -# be compatible with Class::DBI::UUID sub uuid_columns { my $self = shift; for (@_) { @@ -86,14 +85,17 @@ DBIx::Class::UUIDColumns - Implicit uuid columns =head1 SYNOPSIS - package Artist; - __PACKAGE__->load_components(qw/UUIDColumns Core DB/); - __PACKAGE__->uuid_columns( 'artist_id' ); +In your L table class: + + __PACKAGE__->load_components(qw/UUIDColumns ... Core/); + __PACKAGE__->uuid_columns('artist_id'); + +B The component needs to be loaded I Core. =head1 DESCRIPTION -This L component resembles the behaviour of -L, to make some columns implicitly created as uuid. +This L component resembles the behaviour of L, +to make some columns implicitly created as uuid. When loaded, C will search for a suitable uuid generation module from the following list of supported modules: @@ -109,35 +111,33 @@ If no supporting module can be found, an exception will be thrown. *APR::UUID will not be loaded under OpenBSD due to an as yet unidentified XS issue. -If you would like to use a specific module, you can set C: +If you would like to use a specific module, you can set L: __PACKAGE__->uuid_class('::Data::UUID'); __PACKAGE__->uuid_class('MyUUIDGenerator'); -Note that the component needs to be loaded before Core. - =head1 METHODS -=head2 uuid_columns(@columns) +=head2 uuid_columns Takes a list of columns to be filled with uuids during insert. - __PACKAGE__->uuid_columns('id'); + __PACKAGE__->uuid_columns('artist_id'); -=head2 uuid_class($classname) +=head2 uuid_class Takes the name of a UUIDMaker subclass to be used for uuid value generation. This can be a fully qualified class name, or a shortcut name starting with :: -that matches one of the available DBIx::Class::UUIDColumns::UUIDMaker subclasses: +that matches one of the available L subclasses: __PACKAGE__->uuid_class('CustomUUIDGenerator'); # loads CustomeUUIDGenerator - __PACKAGE->uuid_class('::Data::UUID'); + __PACKAGE__->uuid_class('::Data::UUID'); # loads DBIx::Class::UUIDMaker::Data::UUID; Note that C chacks to see that the specified class isa -DBIx::Class::UUIDColumns::UUIDMaker subbclass and throws and exception if it isn't. +L subbclass and throws and exception if it isn't. =head2 uuid_maker diff --git a/lib/DBIx/Class/UUIDColumns/UUIDMaker.pm b/lib/DBIx/Class/UUIDColumns/UUIDMaker.pm index a9ca80a..6cbc18d 100644 --- a/lib/DBIx/Class/UUIDColumns/UUIDMaker.pm +++ b/lib/DBIx/Class/UUIDColumns/UUIDMaker.pm @@ -21,7 +21,7 @@ DBIx::Class::UUIDColumns::UUIDMaker - UUID wrapper module =head1 SYNOPSIS package CustomUUIDMaker; - use base qw/DBIx::Class::/; + use base qw/DBIx::Class::UUIDColumns::UUIDMaker/; sub as_string { my $uuid; @@ -42,7 +42,7 @@ Returns the new uuid as a string. =head1 SEE ALSO -L, +L, L, L, L,