NAME
DBIx::Class::Helper::Row::Types - Use Types to define rows
VERSION
version v0.4.0
SYNOPSIS
In result class:
use Types::SQL -types;
use Types::Standard -types;
__PACKAGE__->load_components('Helper::Row::Types');
__PACKAGE__->add_columns(
id => Serial,
name => {
isa => Maybe[ Varchar[64] ],
},
);
DESCRIPTION
This helper allows you to specify column information by passing a Type::Tiny object.
Note that this does not enforce that the data is of that type, unless you specify the strict
option (See "set_column"). The main purpose of this is to allow you to use types as a shorthand for specifying the column type.
You can use types from Types::SQL or supported types from Types::Standard.
METHODS
add_column
add_columns
These methods are modified to allow you to specify the column info using the isa
attribute and a Type::Tiny type.
Note that in no way does this enforce that type.
set_column
If the strict
attribute is true for the column, then the type constraint will be enforced when the column is explicitly set.
If the coerce
attribute is true, then the type's coercion will be applied before checking the constraint.
Note that type constraints will not be enforced if you use the insert
or resultset create
methods.
This is entirely separate from database-level constraints.
Enabling strict
for an inflated column is strongly discouraged.
SUPPORT FOR OLDER PERL VERSIONS
Since v0.4.0, the this module requires Perl v5.14 or later.
Future releases may only support Perl versions released in the last ten years.
If you need this module on Perl v5.10, please use one of the v0.3.x versions of this module. Significant bug or security fixes may be backported to those versions.
KNOWN ISSUES
Strict type constraints are only applied when explicitly setting a column value.
SEE ALSO
Types::SQL::Util provides a list of "standard" types that are supported.
SOURCE
The development version is on github at https://github.com/robrwo/DBIx-Class-Helper-Row-Types and may be cloned from git://github.com/robrwo/DBIx-Class-Helper-Row-Types.git
BUGS
Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/DBIx-Class-Helper-Row-Types/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
AUTHOR
Robert Rothenberg <rrwo@cpan.org>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2017-2023 by Robert Rothenberg.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)