http-status-constants's Introduction

NAME

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

VERSION

v0.3.0

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 { ... },
);

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

INSTALLATION

See How to install CPAN modules.

Required Modules

This distribution requires Perl v5.10.1.

This distribution requires the following modules:

This distribution recommends the following modules:

Package::Stash::XS

RECENT CHANGES

Incompatabilities

Increased minimum version to Perl v5.10.1.

Other Changes

Updated copyright year.
Use Perl::Critic tests are part of build process.
Clean up prereqs in build.
Added author and release tests.
Use Dist::Zilla TravisYML plugin.

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.

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

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

http-status-constants's People

Contributors

Watchers

Recommend Projects

robrwo / http-status-constants Goto Github PK