The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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

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

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:

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.

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

http://www.perlfoundation.org/artistic_license_2_0