use Carp::Clan qw/^DBIx::Class/;
use Scalar::Util 'weaken';
use Sub::Name 'subname';
+use DBIx::Class::Schema::Loader::Utils 'array_eq';
+use Try::Tiny;
+use Hash::Merge 'merge';
use namespace::clean;
# Always remember to do all digits for the version even if they're 0
# i.e. first release of 0.XX *must* be 0.XX000. This avoids fBSD ports
# brain damage and presumably various other packaging systems too
-our $VERSION = '0.07010';
+our $VERSION = '0.07042';
__PACKAGE__->mk_group_accessors('inherited', qw/
_loader_args
/);
__PACKAGE__->_loader_args({});
+=encoding UTF-8
+
=head1 NAME
DBIx::Class::Schema::Loader - Create a DBIx::Class::Schema based on a database
=head1 SYNOPSIS
- ### use this module to generate a set of class files
-
- # in a script
- use DBIx::Class::Schema::Loader qw/ make_schema_at /;
- make_schema_at(
- 'My::Schema',
- { debug => 1,
- dump_directory => './lib',
- },
- [ 'dbi:Pg:dbname="foo"', 'myuser', 'mypassword',
- { loader_class => 'MyLoader' } # optionally
- ],
- );
-
- # from the command line or a shell script with dbicdump (distributed
- # with this module). Do `perldoc dbicdump` for usage.
- dbicdump -o dump_directory=./lib \
- -o components='["InflateColumn::DateTime"]' \
- -o debug=1 \
- My::Schema \
- 'dbi:Pg:dbname=foo' \
- myuser \
- mypassword
-
- ### or generate and load classes at runtime
- # note: this technique is not recommended
- # for use in production code
+ ### use this module to generate a set of class files
- package My::Schema;
- use base qw/DBIx::Class::Schema::Loader/;
+ # in a script
+ use DBIx::Class::Schema::Loader qw/ make_schema_at /;
+ make_schema_at(
+ 'My::Schema',
+ { debug => 1,
+ dump_directory => './lib',
+ },
+ [ 'dbi:Pg:dbname="foo"', 'myuser', 'mypassword',
+ { loader_class => 'MyLoader' } # optionally
+ ],
+ );
- __PACKAGE__->loader_options(
- constraint => '^foo.*',
- # debug => 1,
- );
+ # from the command line or a shell script with dbicdump (distributed
+ # with this module). Do `perldoc dbicdump` for usage.
+ dbicdump -o dump_directory=./lib \
+ -o components='["InflateColumn::DateTime"]' \
+ -o debug=1 \
+ My::Schema \
+ 'dbi:Pg:dbname=foo' \
+ myuser \
+ mypassword
+
+ ### or generate and load classes at runtime
+ # note: this technique is not recommended
+ # for use in production code
+
+ package My::Schema;
+ use base qw/DBIx::Class::Schema::Loader/;
+
+ __PACKAGE__->loader_options(
+ constraint => '^foo.*',
+ # debug => 1,
+ );
- #### in application code elsewhere:
+ #### in application code elsewhere:
- use My::Schema;
+ use My::Schema;
- my $schema1 = My::Schema->connect( $dsn, $user, $password, $attrs);
- # -or-
- my $schema1 = "My::Schema"; $schema1->connection(as above);
+ my $schema1 = My::Schema->connect( $dsn, $user, $password, $attrs);
+ # -or-
+ my $schema1 = "My::Schema"; $schema1->connection(as above);
-=head1 DESCRIPTION
+=head1 DESCRIPTION
DBIx::Class::Schema::Loader automates the definition of a
L<DBIx::Class::Schema> by scanning database table definitions and setting up
my $args = $self->_loader_args;
- # set up the schema/schema_class arguments
- $args->{schema} = $self;
+ # temporarily copy $self's storage to class
+ my $class_storage = $class->storage;
+ if (ref $self) {
+ $class->storage($self->storage);
+ $class->storage->set_schema($class);
+ }
+
+ $args->{schema} = $class;
$args->{schema_class} = $class;
- weaken($args->{schema}) if ref $self;
$args->{dump_directory} ||= $self->dump_to_dir;
$args->{naming} = $self->naming if $self->naming;
$args->{use_namespaces} = $self->use_namespaces if defined $self->use_namespaces;
};
my $impl = $loader_class || "DBIx::Class::Schema::Loader" . $self->storage_type;
- eval { $self->ensure_class_loaded($impl) };
- croak qq/Could not load loader_class "$impl": "$@"/ if $@;
+ try {
+ $self->ensure_class_loaded($impl)
+ }
+ catch {
+ croak qq/Could not load loader_class "$impl": "$_"/;
+ };
- $self->loader($impl->new(%$args));
- $self->loader->load;
- $self->_loader_invoked(1);
+ $class->loader($impl->new(%$args));
+ $class->loader->load;
+ $class->_loader_invoked(1);
- $self;
+ # copy to $self
+ if (ref $self) {
+ $self->loader($class->loader);
+ $self->_loader_invoked(1);
+
+ $self->_merge_state_from($class);
+ }
+
+ # restore $class's storage
+ $class->storage($class_storage);
+
+ return $self;
+}
+
+# FIXME This needs to be moved into DBIC at some point, otherwise we are
+# maintaining things to do with DBIC guts, which we have no business of
+# maintaining. But at the moment it would be just dead code in DBIC, so we'll
+# maintain it here.
+sub _merge_state_from {
+ my ($self, $from) = @_;
+
+ my $orig_class_mappings = $self->class_mappings;
+ my $orig_source_registrations = $self->source_registrations;
+
+ $self->_copy_state_from($from);
+
+ $self->class_mappings(merge($orig_class_mappings, $self->class_mappings))
+ if $orig_class_mappings;
+
+ $self->source_registrations(merge($orig_source_registrations, $self->source_registrations))
+ if $orig_source_registrations;
+}
+
+sub _copy_state_from {
+ my $self = shift;
+ my ($from) = @_;
+
+ # older DBIC's do not have this method
+ if (try { DBIx::Class->VERSION('0.08197'); 1 }) {
+ return $self->next::method(@_);
+ }
+ else {
+ # this is a copy from DBIC git master pre 0.08197
+ $self->class_mappings({ %{$from->class_mappings} });
+ $self->source_registrations({ %{$from->source_registrations} });
+
+ foreach my $moniker ($from->sources) {
+ my $source = $from->source($moniker);
+ my $new = $source->new($source);
+ # we use extra here as we want to leave the class_mappings as they are
+ # but overwrite the source_registrations entry with the new source
+ $self->register_extra_source($moniker => $new);
+ }
+
+ if ($from->storage) {
+ $self->storage($from->storage);
+ $self->storage->set_schema($self);
+ }
+ }
}
=head2 connection
my $temp_loader = DBIx::Class::Schema::Loader::Base->new(
%{ $self->_loader_args },
schema => $self,
+ naming => 'current',
+ use_namespaces => 1,
);
+ my $modify_isa = 0;
+ my @components;
+
if ($temp_loader->schema_base_class || $temp_loader->schema_components) {
- my @components = @{ $temp_loader->schema_components }
+ @components = @{ $temp_loader->schema_components }
if $temp_loader->schema_components;
push @components, ('+'.$temp_loader->schema_base_class)
if $temp_loader->schema_base_class;
+ my $class_isa = do {
+ no strict 'refs';
+ \@{"${class}::ISA"};
+ };
+
+ my @component_classes = map {
+ /^\+/ ? substr($_, 1, length($_) - 1) : "DBIx::Class::$_"
+ } @components;
+
+ $modify_isa++ if not array_eq([ @$class_isa[0..(@components-1)] ], \@component_classes)
+ }
+
+ if ($modify_isa) {
$class->load_components(@components);
# This hack is necessary because we changed @ISA of $self through
@{$target . '::ISA'} = qw/DBIx::Class::Schema::Loader/;
}
- eval { $target->_loader_invoked(0) };
+ $target->_loader_invoked(0);
$target->loader_options($opts);
- $target->connection(@$connect_info);
+
+ my $temp_schema = $target->connect(@$connect_info);
+
+ $target->storage($temp_schema->storage);
+ $target->storage->set_schema($target);
+
+ return $target;
}
=head2 rescan
jhannah: Jay Hannah <jay@jays.net>
-rbuels: Robert Buels <rmb32@cornell.edu>
+jnap: John Napiorkowski <jjn1056@yahoo.com>
+
+rbuels: Robert Buels <rbuels@gmail.com>
timbunce: Tim Bunce <timb@cpan.org>
schwern: Michael G. Schwern <mschwern@cpan.org>
+SineSwiper: Brendan Byrd <byrd.b@insightcom.com>
+
hobbs: Andrew Rodland <arodland@cpan.org>
domm: Thomas Klausner <domm@plix.at>
Matias E. Fernandez <mfernandez@pisco.ch>
-Al Newkirk <awncorp@cpan.org>
+alnewkirk: Al Newkirk <awncorp@cpan.org>
+
+angelixd: Paul C. Mantz <pcmantz@cpan.org>
+
+andrewalker: André Walker <andre@andrewalker.net>
+
+mattp: Matt Phillips <mattp@cpan.org>
+
+Dag-Erling Smørgrav <des@des.no>
+
+moritz: Moritz Lenz <moritz@faui2k3.org>
+
+oalders: Olaf Alders <olaf@wundersolutions.com>
... and lots of other folks. If we forgot you, please write the current
maintainer or RT.
=head1 SEE ALSO
-L<DBIx::Class>, L<DBIx::Class::Manual::ExampleSchema>
+L<DBIx::Class>, L<DBIx::Class::Manual::Intro>, L<DBIx::Class::Tutorial>,
+L<DBIx::Class::Schema::Loader::Base>
=cut