NAME
Test2::Tools::QuickDB - Quickly spin up temporary Database servers for tests.
DESCRIPTION
This is a test library build around DBIx::QuickDB.
SYNOPSIS
use Test2::V0 -target => DBIx::QuickDB::Driver::PostgreSQL;
use Test2::Tools::QuickDB;
skipall_unless_can_db(driver => 'PostgreSQL');
my $db = get_db({driver => 'PostgreSQL', load_sql => 't/schema/postgresql.sql'});
...EXPORTS
- $driver = skipall_unless_can_db('MyDriver')
- $driver = skipall_unless_can_db(['MyDriver', 'OurDriver'])
- $driver = skipall_unless_can_db(%spec)
-
This will look for a usable driver. If no usable driver is found, this will issue a skip_all to skip the current test or subtest. If at least one suable driver is found then the first one found will be returned.
If you pass in 1 argument it should either be a driver to try, or an arrayref of drivers to try.
If you passing multiple argument then you should follow the specifications in "SPEC HASH" in DBIx::QuickDB.
Feel free to ignore the return value.
- $db = get_db
- $db = get_db($name)
- $db = get_db(\%spec)
- $db = get_db($name, \%spec)
- $db = get_db $name => \%spec
-
Get a database.
With no arguments it will give you an instance of the first working driver it finds.
You can provide a name for the db, the same instance can then be retrieved anywhere GLOBALLY using the same name.
You can provide a spec hashref which can contain any arguments documented in "SPEC HASH" in DBIx::QuickDB.
- $db = get_db_or_skipall $name => \%spec
- $db = get_db_or_skipall($name, \%spec)
- $db = get_db_or_skipall($name)
- $db = get_db_or_skipall(\%spec)
-
This combines
get_db()andskipall_unless_can_db(). The arguments supported are identical toget_db().
SOURCE
The source code repository for DBIx-QuickDB can be found at https://github.com/exodist/DBIx-QuickDB/.
MAINTAINERS
AUTHORS
COPYRIGHT
Copyright 2020 Chad Granum <exodist7@gmail.com>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://dev.perl.org/licenses/