dbicx::testdatabase::subclass(3pm) [debian man page]

DBICx::TestDatabase::Subclass(3pm)			User Contributed Perl Documentation			DBICx::TestDatabase::Subclass(3pm)

NAME

       DBICx::TestDatabase::Subclass - a DBICx::TestDatabase you can add your own methods to

SYNOPSIS

       Your test database subclass:

	  package MyApp::TestDatabase
	  use base qw(DBICx::TestDatabase::Subclass MyApp::Schema);

	  sub foo {
	     my $self = shift;
	     return $self->resultset('Foo')->create({ foo => 'bar' });
	  }

       Later:

	  use MyApp::TestDatabase;
	  my $schema = MyApp::TestDatabase->connect;
	  my $foo_row = $schema->foo; # MyApp::TestDatabase::foo
	  my $bars = $schema->resultset('Bar'); # MyApp::Schema::resultset

DESCRIPTION

       Sometimes DBICx::TestDatabase doesn't give you enough control over the object returned.	This module lets you create a custom test database
       class.

METHODS

   connect
       This method creates the temporary database and returns the connection.  If your subclass needs to change the way connect works, do
       something like this:

	   sub connect {
	       my ($class) = @_;

	       say 'This happens before we create the test database.';
	       my $schema = $class->next::method;
	       say '$schema is the temporary test database';

	       return $schema;
	   }

SEE ALSO

       If you want a simple test database based on a DBIC schema, just use DBICx::TestDatabase.

AUTHOR

       Jonathan Rockway "<jrockway@cpan.org>"

LICENSE

       Copyright (c) 2007 Jonathan Rockway.

       This program is free software.  You may use, modify, and redistribute it under the same terms as Perl itself.

perl v5.10.1							    2007-10-07					DBICx::TestDatabase::Subclass(3pm)

DBICx::TestDatabase(3pm)				User Contributed Perl Documentation				  DBICx::TestDatabase(3pm)

NAME

       DBICx::TestDatabase - create a temporary database from a DBIx::Class::Schema

SYNOPSIS

       Given a DBIx::Class::Schema at "MyApp::Schema", create a test database like this:

	  use DBICx::TestDatabase;
	  my $schema = DBICx::TestDatabase->new('MyApp::Schema');

       Then you can use $schema normally:

	  $schema->resultset('Blah')->create({ blah => '123' });

       When your program exits, the temporary database will go away.

DESCRIPTION

       This module creates a temporary SQLite database, deploys your DBIC schema, and then connects to it.  This lets you easily test your DBIC
       schema.	Since you have a fresh database for every test, you don't have to worry about cleaning up after your tests, ordering of tests
       affecting failure, etc.

METHODS

   new($schema)
       Loads $schema and returns a connection to it.

   connect
       Alias for new.

ENVIRONMENT

       You can control the behavior of this module at runtime by setting environment variables.

   DBIC_KEEP_TEST
       If this variable is true, then the test database will not be deleted at "END" time.  Instead, a message containing the paths of the test
       databases will be printed.

       This is good if you want to look at the database your test generated, for debugging.

       (Note that the database will never exist on disk if you don't set this to a true value.)

AUTHOR

       Jonathan Rockway "<jrockway@cpan.org>"

LICENSE

       Copyright (c) 2007 Jonathan Rockway.

       This program is free software.  You may use, modify, and redistribute it under the same terms as Perl itself.

perl v5.10.1							    2010-12-15						  DBICx::TestDatabase(3pm)