Revision history for Web-VWF
0.003.0 Tue Nov 17 12:05:14 PM EST 2026
[ Enhancements ]
- The pages a site serves are declared in <display>, one <page> element for
each, with a <name> and a <description> (shown in the 300 response). A
<directory> in <display> or in a <page> says where the page modules are, instead
of @INC; with no <page>, the modules found in the <display> directory are the
pages. The old <pages> setting, and its string of names, is still read.
- The data modules a site loads are declared in <databases>, one <database>
element for each, with a <name>, a <description> and a <directory> likewise.
A name with no :: in it is a Web::VWF::Data:: module, so <name>states</name> is
Web::VWF::Data::states. The old <data_modules> string is still read. (It is
not called <data> because Database::Abstraction takes constructor arguments
from top-level configuration keys, and data is one of them.)
- File-based caches (Berkeley DB, File) now go in $CACHEDIR, or failing that
$CACHE_DIR, when either is set, ahead of $root_dir and the configuration; the
directory is created if it does not exist. Previously root_dir=example put
CGI+3a+3aLingua, __db.* and the rest inside example/.
- The example site has a states page (?page=states), reading
example/data/states.csv (the 50 U.S. states) through Web::VWF::Data::states,
Web::VWF::Display::states and states.tmpl, which are in example/lib; and
example/data/index.csv, the people the contact form can reach.
- Documented every site setting: a new CONFIGURATION section in the Web::VWF
POD and the README, with the defaults. Added the SYNOPSIS and run() to the
POD, POD for every module, Web::VWF::Utils::env_cache_dir, an AUTHOR and a
LICENCE section for each, and a LICENSE file.
- t/pod-coverage.t (an author test) checks that every public subroutine is
documented, and t/version.t no longer skips a Changes entry that has no date
yet when checking its version (the date is required under RELEASE_TESTING),
and checks the example site's modules too.
[ Bug Fixes ]
- Require HTML::D3 0.30. CPAN Testers (Perl 5.44, aarch64 Linux) had 0.23 and
the meta_data page, t/function.t and t/meta-data-charts.t died with "Data must
be an array of arrays": 0.23 takes render_pie_chart_snippet($data, $opts)
positionally, and meta_data passes a hash. The prerequisite is now declared in
Makefile.PL, cpanfile and linux.yml, and meta_data checks it on load.
Fixes https://matrix.perl-magpie.org/results/ffb3469e-de40-11f1-a09d-aafb97416a10
- Handle captcha display failure
- The POD of Blacklist, Utils and Config still used the old VWF:: names, so
its SYNOPSIS did not load.
- Data::Throttler::Backend::VWF, which Web::VWF::Throttle defines in another
distribution's namespace, is no longer offered to PAUSE (no_index).
- Declared Test::Needs, which t/pod.t uses, and recommend Mail::DKIM and
Crypt::OpenSSL::RSA for the tests that sign a message.
- ASCII only in the source of Web::VWF; one line indented with spaces now uses tabs.
0.002.0 Wed Nov 11 08:54:17 PM EST 2026
[ Enhancements ]
- Added Web::VWF::Mail: sends mail through sendmail(1), signed with DKIM when
the site configures DKIMSelector and DKIMKey. Mail::DKIM is recommended,
not required; without it, or without a key, mail is sent unsigned.
Web::VWF::Display::index now sends through it.
- Mail rejects a sender that could be read as a sendmail option or a header.
- Declared the dependencies that were only loaded lazily and so were missing
from the build files: Data::Validate::URI, DateTime, LWP::Simple::WithCache,
Time::Duration::Parse, XML::LibXML and YAML.
- Debug logging of the configuration now redacts secrets, keys and tokens
(Web::VWF::Utils::redact_config).
- Every module now carries the distribution's $VERSION.
- Documented the API of new(), and of Web::VWF::Mail.
- Corrected the README and POD, which described a site layout that is not in
the distribution, and fixed 8-space indentation in two modules.
- Declared the licence as GPL2 in the metadata, and kept example/ and t/ out
of the CPAN index.
0.001.0 Tue Nov 10 09:00:49 PM EST 2026
First draft
Keyboard Shortcuts
Global
s
Focus search bar
?
Bring up this help dialog
GitHub
gp
Go to pull requests
gi
Go to GitHub issues (only if GitHub is preferred repository)