view release on metacpan or  search on metacpan

lib/Date/Holidays/Abstract.pm  view on Meta::CPAN

=back

Returns a reference to a hash, where the keys are date represented as
four digits. The two first representing month (01-12) and the last two
representing day (01-31).

The value for the key in question is the local name for the holiday
indicated by the day. The resultset will of course vary depending on
the given country's national holiday.

Additional arguments are at the courtesy of the author of the using
module/class.

--

L<Date::Holidays> uses the requirements defined by this module and this
module can therefore be used with success in conjunction with this.

This is an alternative to a SUPER class. I have given a lot of thought to
programming a SUPER class, but since creating a super class for a bunch
of modules implementing handling of national holidays, an abstract
class seemed a better choice.

A proposed SUPER class for Date::Holidays::* is however implemented see:
L<Date::Holidays::Super> implement B<is_holiday> and B<holidays> and expect
these to be overloaded.

Overloading would be necessary since nothing intelligent can be said
about holidays without specifying a nationality (a part from holidays
being nice but too few), and the implemented methods would be empty
bodies returning empty result sets.

So I am more for an abstract class and as stated I consider this class
an experiment and I have implemented L<Date::Holidays::Super> as an
alternative.

Suggestions for changes and extensions are more than welcome.

=head1 SUBROUTINES/METHODS

This class does not implement any methods, it is an abstract class.

=head1 DIAGNOSTICS

This class does not implement any exceptions or error, it is an abstract class.

=head1 CONFIGURATION AND ENVIRONMENT

This class does not implement or require any special environment or
configuration apart from what is mentioned in DEPENDENCIES

=head1 DEPENDENCIES

This class is subclassed from L<Class::Virtually::Abstract>, but holds
no direct dependencies apart from that class/module.

=head1 INCOMPATIBILITIES

No known to the author

=head1 BUGS AND LIMITATIONS

No, to the author, known bugs. lease see GitHub for a more precise status.

=over

=item * L<https://github.com/jonasbn/perl-date-holidays-abstract/issues>

=back

Only known limitations are:

=over

=item Requirement for Perl 5.6 for use

=item Requirement for Perl 5.14 for development

=back

=head1 SEE ALSO

=over

=item * L<Date::Holidays>

=item * L<Date::Holidays::Super>

=item * L<Date::Holidays::DE>

=item * L<Date::Holidays::DK>

=item * L<Date::Holidays::FR>

=item * L<Date::Holidays::UK>

=item * L<Date::Holiday::PT>

=item * L<Date::Japanese::Holiday>

=item * L<Class::Virtual>

=item * L<Class::Virtually::Abstract>

=back

=head1 BUGS

Please report issues via GitHub at:

=over

=item  * L<https://github.com/jonasbn/perl-date-holidays-abstract/issues>

=back

And follow the bug reporting guidelines available at:

=over

=item * L<https://github.com/jonasbn/perl-date-holidays-abstract/blob/master/CONTRIBUTING.md>