/ 
HTTP-Status-Const-v0.2.2
River stage zero No dependents
/ HTTP::Status::Const

NAME

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

VERSION

v0.2.2

SYNOPSIS

use HTTP::Status::Const;

...

$response->status( $HTTP_NOT_FOUND );

...

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

DESCRIPTION

This module is basically a wrapper around 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.

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).

See the Pod::Readme documentation for more details on the POD syntax that this module recognizes.

See pod2readme for command-line usage.

INSTALLATION

See How to install CPAN modules.

Required Modules

This distribution requires Perl v5.10.0.

This distribution requires the following modules:

This distribution recommends the following modules:

RECENT CHANGES

  • Added support for exporting HTTP::Status's utility functions [Fixes GitHub #1].

  • Switched to use Dist::Zilla for managing the distribution.

  • Fixed typos in POD.

  • Added note about why you don't need this module. Really, you don't need it.

See the Changes file for a longer revision history.

EXPORTS

By default, only the HTTP constants are exported.

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

SEE ALSO

HTTP::Status

AUTHOR

Robert Rothenberg, <rrwo at cpan.org>

Acknowledgements

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

LICENSE AND COPYRIGHT

Copyright 2014 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:

http://www.perlfoundation.org/artistic_license_2_0