NAME
HTTP::Headers::Patch::DontUseStorable - (DEPRECATED) Do not use Storable
VERSION
This document describes version 0.062 of
HTTP::Headers::Patch::DontUseStorable (from Perl distribution
HTTP-Headers-Patch-DontUseStorable), released on 2021-08-26.
SYNOPSIS
use HTTP::Headers::Patch::DontUseStorable;
DESCRIPTION
UPDATE 2020-02-03: As of Storable 3.08, freeze/thaw/dclone support
Regexp objects. I'm deprecating this module.
HTTP::Headers (6.11 as of this writing) tries to load Storable (2.56 as
of this writing) and use its dclone() method. Since Storable still does
not support serializing Regexp objects, HTTP::Headers/HTTP::Message
croaks when fed data with Regexp objects.
This patch avoids using Storable and clone using the alternative method.
FAQ
Is this a bug with HTTP::Headers? Why don't you submit a bug to HTTP-Message?
I tend not to think this is a bug with HTTP::Headers; after all,
Storable's dclone() is a pretty standard way to clone data in Perl. This
patch is more of a workaround for current Storable's deficiencies.
Shouldn't you add STORABLE_{freeze,thaw} methods to Regexp instead?
This no longer works with newer Perls (5.12 and later).
Why would an HTTP::Headers object contain a Regexp object in the first place? Shouldn't it only contain strings (and arrays/hashes of strings)?
True. This might be a bug with the client code (e.g. in my module which
uses this patch, Finance::Bank::ID::Mandiri). I haven't investigated
further though and this is the stop-gap solution.
HOMEPAGE
Please visit the project's homepage at
<https://metacpan.org/release/HTTP-Headers-Patch-DontUseStorable>.
SOURCE
Source repository is at
<https://github.com/perlancar/perl-HTTP-Headers-Patch-DontUseStorable>.
SEE ALSO
AUTHOR
perlancar <perlancar@cpan.org>
CONTRIBUTOR
Steven Haryanto (on PC) <stevenharyanto@gmail.com>
CONTRIBUTING
To contribute, you can send patches by email/via RT, or send pull
requests on GitHub.
Most of the time, you don't need to build the distribution yourself. You
can simply modify the code, then test via:
% prove -l
If you want to build the distribution (e.g. to try to install it locally
on your system), you can install Dist::Zilla,
Dist::Zilla::PluginBundle::Author::PERLANCAR, and sometimes one or two
other Dist::Zilla plugin and/or Pod::Weaver::Plugin. Any additional
steps required beyond that are considered a bug and can be reported to
me.
COPYRIGHT AND LICENSE
This software is copyright (c) 2021, 2020, 2017, 2015, 2012 by perlancar
<perlancar@cpan.org>.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
BUGS
Please report any bugs or feature requests on the bugtracker website
<https://rt.cpan.org/Public/Dist/Display.html?Name=HTTP-Headers-Patch-Do
ntUseStorable>
When submitting a bug or request, please include a test-file or a patch
to an existing test-file that illustrates the bug or desired feature.