/ 
Data-Schema-0.12
/ Data::Schema::Config

NAME

Data::Schema::Config - Data::Schema configuration

VERSION

version 0.12

SYNOPSIS

# getting configuration
if ($validator->config->allow_extra_hash_keys) { ... }

# setting configuration
$validator->config->max_errors(100);

DESCRIPTION

Configuration variables for Data::Schema.

ATTRIBUTES

max_errors => INT

Maximum number of errors before validation stops. Default is 10.

schema_search_path => ARRAYREF

A list of places to look for schemas. If you use DSP::LoadSchema::YAMLFile, this will be a list of directories to search for YAML files. If you use DSP::LoadSchema::Hash, this will be the hashes to search for schemas. This is used if you use schema types (types based on schema).

See <Data::Schema::Type::Schema> for more details.

gettext_function => CODEREF

If set to a coderef, then this will be used to get custom error message when errmsg attribute suffix is used. For example, if schema is:

[str => {regex=>'/^\w+$/', 'regex.errmsg'=>'alphanums_only'}]

then your function will be called with 'alphanums_only' as the argument.

Default is none.

defer_loading => BOOL

Default true. If set to true, try to load require/use as later as possible (e.g. loading type handler classes, etc) to improve startup performance.

allow_extra_hash_keys => BOOL

Default false. When hash has 'keys' type attribute, it automatically limits allowed keys to only those specified in 'keys'. But if you set this config to true, extra keys will still be allowed.

Example:

# under allow_extra_hash_keys = 0 (the default)
ds_validate({c=>1}, [hash => {keys=>{a=>"int", b=>"int"}}]); # failed, key c not allowed

# under allow_extra_hash_keys = 1
ds_validate({c=>1}, [hash => {keys=>{a=>"int", b=>"int"}}]); # ok
# but
ds_validate({c=>1}, [hash => {keys=>{a=>"int", b=>"int"},
                              allowed_keys=>[qw/a b/]}]); # still not allowed due to allowed_keys

compile => BOOL

Default false. If true, then before validating, the schema will be automatically compiled to Perl code first (unless it is already compiled). This can result in faster validation.

Schema is recompiled if its content is different or if the configuration changes (because some configuration like allow_extra_hash_keys can alter the behaviour of validator)..

Compiled schema remembers config values like max_errors, etc at compile-time.

You can also get the Perl code using emit_perl and compile the code using compile.

The emitted Perl code can work without DS.

The Perl code are compiled in the Data::Schema::__compiled namespace.

Performance gain is expected to be in the order of one magnitude (10x) or more if the schema is complex.

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2009 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.