NAME

DBIx::DataFactory::Type - the class for defining the rule of inserting data.

SYNOPSIS

package DBIx::DataFactory::Type::Test;

use strict;
use warnings;
use Carp;

sub type_name {
    return 'Test';
}

sub make_value {
    my ($class, %args) = @_;
    return 'test';
}

1;

DESCRIPTION

you can define the rule of inserting data as class. you must define the method named type_name and make_value.

type_name is used to identify the class of type when create_factory_method is called. in following example, factory method insert data, defined by DBIx::DataFactory::Type::Test(see synopsis) make_value method, into 'test' column automatically.

$factory_maker->create_factory_method(
    method   => 'create_factory_data',
    table    => 'test_factory',
    auto_inserted_columns => {
        test => {
            type => 'Test',
        },
    },
);

make_value is used to define data for inserting. hash specified in auto_inserted_columns except type is passed to make_value.

$factory_maker->create_factory_method(
    method   => 'create_factory_data',
    table    => 'test_factory',
    auto_inserted_columns => {
        test => {
            type   => 'Test',
            size   => 10,
            regexp => '[a-z]{10}',
        },
    },
);

when the above case, make_value will be called in create_factory_data method as following.

DBIx::DataFactory::Type::Test->make_value(
    size   => 10,
    regexp => '[a-z]{10}',
);

DEFINED TYPE

the following type is already defined in this module.

DBIx::DataFactory::Type::Int

random int maker. you can pass size parameter.

$factory_maker->create_factory_method(
    method   => 'create_factory_data',
    table    => 'test_factory',
    auto_inserted_columns => {
        int => {
            type => 'Int',
            size => 8,
        },
    },
);

DBIx::DataFactory::Type::Num

random number maker. you can pass size parameter. size means integer part size.

$factory_maker->create_factory_method(
    method   => 'create_factory_data',
    table    => 'test_factory',
    auto_inserted_columns => {
        num => {
            type => 'Num',
            size => 8,
        },
    },
);

DBIx::DataFactory::Type::Str

random string maker. you can pass size or regexp parameter.

if size parameter is passed, this maker produce strings like [a-zA-Z0-9]{$size}.

if regexp parameter is passed, this maker produce strings according to passed regular regexp.

$factory_maker->create_factory_method(
    method   => 'create_factory_data',
    table    => 'test_factory',
    auto_inserted_columns => {
        str => {
            type   => 'Str',
            regexp => '[a-z]{20}',
        },
    },
);

DBIx::DataFactory::Type::Str

returning one of specified set in a random manner.

$factory_maker->create_factory_method(
    method   => 'create_factory_data',
    table    => 'test_factory',
    auto_inserted_columns => {
        set => {
            type => 'Set',
            set  => ['test1', 'test2'],
        },
    },
);