NAME

Dancer::Plugin::DataFormValidator - Easy access to Data::FormValidator from within Dancer applications

VERSION

version 0.002

SYNOPSIS

  use Dancer;
  use Dancer::Plugin::DataFormValidator;

  post '/foo' => sub {
    if (my $results = dfv ('foo')) {
      # Do some stuff
    } else {
      # Report some failure
    }
  }

DESCRIPTION

Provides an easy way to validate user input based on an input profile (specified as per Data::FormValidator) using a dfv() keyword within your Dancer application.

Configuration

In the simplest case you can use Dancer::Plugin::DataFormValidator without any configuration at all, passing validation profiles each time you call dfv().

To reduce visual clutter when dealing with complex validation profiles, you may optionally specify a profile in the dancer configuration that will be loaded on first use, and which contains multiple validation profiles you can then refer to by name:

 plugins:
   DataFormValidator:
     profile: 'profiles'

dfv()

The dfv() routine can be called several different ways. In all cases it must include either a validation profile name (which must be present in the file loaded via the profile configuration parameter), or a hashref containing the validation profile to be used (see Data::FormValidator for details on what that profile may contain).

If nothing else is included, the parameters Dancer found for the handler will be used. Otherwise, you may hand it a hashref of whatever data you wish it to check.

It will return a Data::FormValidator::Results object you can use however you please.

Explicit validation profile, explicit params

    post '/jazz' => sub {
        if (my $results = dfv ({required => [qw{Name}]}, {Name => 'HorseFeathers'})) {
            do_something ($results->valid)
        } else {
            messages = $results->msgs;
        }
    };

Named validation profile, implicit params

    post '/contact/form' => sub {
        if (my $results = dfv ('contact')) {
            do_something ($results->valid)
        } else {
            messages = $results->msgs;
        }
    };

CONTRIBUTING

This module is developed on Github at:

http://github.com/mdorman/Dancer-Plugin-DataFormValidator

Feel free to fork the repo and submit pull requests.

ACKNOWLEDGEMENTS

Derived, in intent if not actual code, from Dancer::Plugin::FormValidator by Natal Ngétal, <hobbestigrou@erakis.im>

SEE ALSO

Dancer Data::FormValidator

AUTHOR

Michael Alan Dorman <mdorman@ironicdesign.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Ironic Design, Inc..

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

cpanm Dancer::Plugin::DataFormValidator

perl -MCPAN -e shell
install Dancer::Plugin::DataFormValidator