Name

QBit::Validator - It is used for validation of input parameters.

GitHub

https://github.com/QBitFramework/QBit-Validator

Install

• cpanm QBit::Validator

• apt-get install libqbit-validator-perl (http://perlhub.ru/)

Package methods

new

create object QBit::Validator and check data using template

Arguments:

• data - checking data

• template - template for check

• pre_run - function is executed before checking

• app - model using in check

• throw - throw (boolean type, throw exception if an error has occurred)

Example:

  my $data = {
      hello => 'hi, qbit-validator'
  };

  my $qv = QBit::Validator->new(
      data => $data,
      template => {
          type => 'hash',
          fields => {
              hello => {
                  max_len => 5,
              },
          },
      },
  );

template

get or set template

Example:

  my $template = $qv->template;

  $qv->template($template);

has_errors

return boolean result (TRUE if an error has occurred or FALSE)

Example:

  if ($qv->has_errors) {
      ...
  }

data

return data

Example:

  $self->db->table->edit($qv->data) unless $qv->has_errors;

get_wrong_fields

return list name of fields with error

Example:

  if ($qv->has_errors) {
      my @fields = $qv->get_wrong_fields;

      ldump(\@fields); # ['hello']
      # [''] - error in root
  }

get_fields_with_error

return list fields with error

Example:

  if ($qv->has_errors) {
      my @fields = $qv->get_fields_with_error;

      ldump(\@fields);

      # [
      #     {
      #         msgs => ['Error'],
      #         path => ['hello']
      #     }
      # ]
      #
      # path => [''] - error in root
  }

get_error

return error by path

Example:

  if ($qv->has_errors) {
      my $error = $qv->get_error('hello'); # or ['hello']

      print $error; # 'Error'
  }

get_all_errors

return all errors join "\n"

Example:

  if ($qv->has_errors) {
      my $errors = $qv->get_all_errors();

      print $errors; # 'Error'
  }

throw_exception

throw Exception::Validator with error message from get_all_errors

Example:

  $qv->throw_exception if $qv->has_errors;

Default types

scalar (string/number)

• optional

• eq

• regexp

• min

• max

• len_min

• len

• len_max

• in

For more information see tests

array (ref array)

• optional

• size_min

• size

• size_max

• all

• contents

For more information see tests

hash (ref hash)

• optional

• deps

• fields

• extra

• one_of

• any_of

For more information see tests

cpanm Exception::Validator

perl -MCPAN -e shell
install Exception::Validator