NAME
Dancer2::Plugin::UnicodeNormalize - Normalize incoming Unicode parameters
VERSION
Version 0.035
SYNOPSIS
use Dancer2::Plugin::UnicodeNormalize;
DESCRIPTION
Dancer2::Plugin::UnicodeNormalize normalizes all incoming parameters to a given normalization form. This is achieved with a before hook, which should run silently before processing each route. By default, we use Unicode Normalization Form C - this is usually what you want. Other forms can be selected, see: "CONFIGURATION".
** NOTE ** This has been updated to build against Dancer2 0.200000 but operations do not yet apply to newer parameter access methods, query_parameters, body_parameters and route_parameters. This will be fixed in the next release.
This plugin was inspired by Mojolicious::Plugin::UnicodeNormalize. For information on why Unicode Normalization is important, please see:
http://www.perl.com/pub/2012/05/perlunicookbook-unicode-normalization.html
http://www.modernperlbooks.com/mt/2013/11/mojolicious-unicode-normalization-plugin-released.html
CONFIGURATION
plugins:
UnicodeNormalize:
form: NFC
exclude:
- '^/(css|javascripts|images)'
The form
parameter is described in Unicode::Normalize. Default is NFC.
The exclude
parameter consists of a list of regular expressions to match routes we do not wish to process parameters for.
AUTHOR
John Barrett, <john@jbrt.org>
CONTRIBUTING
http://github.com/jbarrett/Dancer2-Plugin-UnicodeNormalize
All comments and contributions welcome.
BUGS AND SUPPORT
Please direct all requests to http://github.com/jbarrett/Dancer2-Plugin-UnicodeNormalize/issues or email <john@jbrt.org>.
COPYRIGHT
Copyright 2013 John Barrett.
LICENSE
This application is free software; you can redistribute it and/or modify it under the same terms as Perl itself.