view release on metacpan or  search on metacpan

lib/Business/DK/Postalcode.pm  view on Meta::CPAN

    }

=head1 PRIVATE SUBROUTINES AND METHODS

=head2 _retrieve_cities

Takes a reference to an array based on the DATA section and return a reference
to an array containing only city names.

=head3 _retrieve_postalcode

Takes a reference to an array based on the DATA section and return a reference
to an array containing only postal codes.

=head3 _build_tree

Internal method to assist L</create_regex> in generating the regular expression.

Takes a L<https://metacpan.org/pod/Tree::Simple> object and a reference to an array of data elements.

=head1 DIAGNOSTICS

There are not special diagnostics apart from the ones related to the different
subroutines.

=head1 CONFIGURATION AND ENVIRONMENT

This distribution requires no special configuration or environment.

=head1 DEPENDENCIES

=over

=item * L<https://metacpan.org/pod/Carp> (core)

=item * L<https://metacpan.org/pod/Exporter> (core)

=item * L<https://metacpan.org/pod/Tree::Simple>

=item * L<https://metacpan.org/pod/Params::Validate>

=back

=head2 TEST

Please note that the above list does not reflect requirements for:

=over

=item * Additional components in this distribution, see F<lib/>. Additional
components list own requirements

=item * Test and build system, please see: F<Build.PL> for details

=item * Requirements for scripts in the F<bin/> directory

=item * Requirements for examples in the F<examples/> directory

=back

=head1 BUGS AND LIMITATIONS

There are no known bugs at this time.

The data source used in this distribution by no means is authorative when it
comes to cities located in Denmark, it might have all cities listed, but
unfortunately also other post distribution data.

=head1 BUG REPORTING

Please report issues via CPAN RT:

=over

=item * Web (RT): L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Business-DK-Postalcode>

=item * Web (Github): L<https://github.com/jonasbn/bdkpst/issues>

=item * Email (RT): L<bug-Business-DK-Postalcode@rt.cpan.org>

=back

=head1 INCOMPATIBILITIES

There are no known incompatibilities at this time.

=head1 TEST AND QUALITY

=head2 Perl::Critic

This version of the code is complying with L<https://metacpan.org/pod/Perl::Critic> a severity: 1

The following policies have been disabled.

=over

=item * L<https://metacpan.org/pod/Perl::Critic::Policy::Variables::ProhibitPackageVars>

Disabled locally using 'no critic' pragma.

The module  uses a package variable as a cache, this might not prove usefull in
the long term, so when this is adressed and this might address this policy.

=item * L<https://metacpan.org/pod/Perl::Critic::Policy::Subroutines::RequireArgUnpacking>

Disabled locally using 'no critic' pragma.

This policy is violated when using L<https://metacpan.org/pod/Params::Validate> at some point this will
be investigated further, this might be an issue due to referral to @_.

=item * L<https://metacpan.org/pod/Perl::Critic::Policy::RegularExpressions::RequireLineBoundaryMatching>

Disabled locally using 'no critic' pragma.

This is disabled for some two basic regular expressions.

=item * L<https://metacpan.org/pod/Perl::Critic::Policy::RegularExpressions::RequireExtendedFormatting>

Disabled locally using 'no critic' pragma.

This is disabled for some two basic regular expressions.