=head1 NAME

HTTP::Status::Const - interpolable HTTP status constants

=head1 VERSION

v0.3.0

=head1 SYNOPSIS

  use HTTP::Status::Const;

  ...

  $response->status( $HTTP_NOT_FOUND );

  ...

  my %handlers = (
    $HTTP_OK      => sub { ... },
    $HTTP_CREATED => sub { ... },
    ...
  );

=head1 DESCRIPTION

This module is basically a wrapper around L<HTTP::Status> that allows
you to use the constants as read-only scalar variables instead of
function names.

This means the constants can be used in contexts where you need
interpolated variables, such as hash keys or in strings.

=head2 Do I really need this?

No. You can get interpolated constants already, with some ugly syntax:

  my %handlers = (
    HTTP_OK() => sub { ... },
  );

or

  "Status code ${ \HTTP_OK }"

So all this module gives you is some stylistic convenience, at the
expense of additional dependencies (although ones that may be used
by other modules).

=head1 INSTALLATION

See
L<How to install CPAN modules|http://www.cpan.org/modules/INSTALL.html>.

=head2 Required Modules

This distribution requires Perl v5.10.1.

This distribution requires the following modules:

=over 4

=item * L<Const::Exporter>

=item * L<HTTP::Status>

=item * L<Package::Stash>

=back

This distribution recommends the following modules:

=over 4

=item * L<Package::Stash::XS>

=back

=head1 RECENT CHANGES

=head2 Incompatabilities

=over 4

=item * 

Increased minimum version to Perl v5.10.1.

=back

=head2 Other Changes

=over 4

=item * 

Updated copyright year.

=item * 

Use Perl::Critic tests are part of build process.

=item * 

Clean up prereqs in build.

=item * 

Added author and release tests.

=item * 

Use Dist::Zilla TravisYML plugin.

=back

See the F<Changes> file for a longer revision history.

=head1 EXPORTS

By default, only the HTTP constants are exported.

For convenience, the tags from L<HTTP::Status> are supported so that
the C<:is> and C<status_message> functions are exported.

=head1 SEE ALSO

L<HTTP::Status>

=head1 AUTHOR

Robert Rothenberg, C<< <rrwo at cpan.org> >>

=head2 Acknowledgements

Several people who pointed out that this module is unnecessary.
(Yes, it's written to scratch an itch.)

=head1 LICENSE AND COPYRIGHT

Copyright 2014-2015 Robert Rothenberg.

This program is free software; you can redistribute it and/or modify it
under the terms of the the Artistic License (2.0). You may obtain a
copy of the full license at:

L<http://www.perlfoundation.org/artistic_license_2_0>