NAME

Kossy::Validator - form validator

SYNOPSIS

use Kossy::Validator;

my $req = Plack::Request->new($env);

my $result = Kossy::Validator->check($req, [
      'q' => [['NOT_NULL','query must be defined']],
      'level' => {
          default => 'M', # or sub { 'M' }
          rule => [
              [['CHOICE',qw/L M Q H/],'invalid level char'],
          ],
      },
      '@area' => {
          rule => [
              ['UINT','area must be uint'],
              [['CHOICE', (0..40)],'invalid area'],
          ],
      },
]);

$result->has_error:Flag
$result->messages:ArrayRef[`Str]

my $val = $result->valid('q');
my @val = $result->valid('area');

my $hash = $result->valid:Hash::MultiValue;

DESCRIPTION

minimalistic form validator used in Kossy

VALIDATORS

NOT_NULL

CHOICE

['CHOICE',qw/dog cat/]

INT

int

UINT

unsigned int

NATURAL

natural number

REAL, DOUBLE, FLOAT

floating number

@SELECTED_NUM

['@SELECTED_NUM',min,max]

@SELECTED_UNIQ

all selected values are unique

CODEref VALIDATOR

my $result = Kossy::Validator->check($req,[
    'q' => [
        [sub{
            my ($req,$val) = @_;
        },'invalid']
    ],
]);

my $result = Kossy::Validator->check($req,[
    'q' => [
        [[sub{
            my ($req,$val,@args) = @_;
        },0,1],'invalid']
    ],
]);

ADDING VALIDATORS

add to %Kossy::Validator::VALIDATOR

local $Kossy::Validator::VALIDATOR{MYRULE} = sub {
    my ($req, $val, @args) = @_;
    return 1;
};

local $Kossy::Validator::VALIDATOR{'@MYRULE2'} = sub {
    my ($req, $vals, $num) = @_;
    return if @$vals != $num;
    return if uniq(@$vals) == $num;
};

Kossy::Validator->check($req,[
    key1 => [['MYRULE','my rule']],
    '@key2' => {
       rule => [
           [['@MYRULE2',3], 'select 3 items'],
           [['CHOICE',qw/1 2 3 4 5/], 'invalid']
       ],
    }
]);

if rule name start with '@', all values are passed as ArrayRef instead of last value.

SEE ALSO

Kossy

LICENSE

Copyright (C) Masahiro Nagano.

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

AUTHOR

Masahiro Nagano <kazeburo@gmail.com>