DBICx::...Subclass(3)

💖 DBICx::...Subclass(3) — bestie edition 💖

okay so this is the DBICx::...Subclass(3) page from User Contributed Perl Documentation, and it’s literally here to let you build a test database class that’s yours. No cap. 🦋

🎀 NAME 🎀

DBICx::TestDatabase::Subclass - a DBICx::TestDatabase you can add your own methods to. That’s the whole assignment, bestie. 💅

✨ 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. It’s giving “I want it my way” and honestly? Iconic. 🫶

💅 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. Easy. Slay. 💖

💜 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.

---

that’s the whole page, bestie — source/version perl v5.42.0, dated 2017-10-12, manual name DBICx::...Subclass(3). 🌈✨