CHANGELOG
v2.09 (2021/12/28)
==================
--Added new export options for Paranoid::IO
--Added new flock stack mechanism to support transactional I/O patterns
--Improved open flag filtering on reopens
--pflock now performs and popen in order to make sure an flock is
properly applied to reopened file handles in children
--Improved pdebug logging for items geting passed arbitrary content
(logging bytes in content, rather that spilling complete content into the
logs)
--Added non-flocking variants of I/O functions
--Added I/O tests w/pflock stack enabled to ensure consistent behaviour
--Added Paranoid::IO::FileMultiplexer class, which allows for multiple
data stream I/O within a single file, but using normal discrete file
I/O semantics
--Fixed Paranoid::Filesystem test to account for NetBSD's noatime
implementation (utime calls for atime fail entirely)
v2.08 (2020/12/31)
==================
--Updated licensing information to reflect Paranoid trademark impact
--Added IMPORT LISTS section to all modules with exportable functions
Paranoid::Args:
--Added template list for exports
Paranoid::Data::AVLTree:
--Added a tree & node class implementing AVL-balanced tree structures
Paranoid:Debug:
--Added constants list for exports
--Documentation updates
Paranoid::Log:
--Minor internal refactoring
Paranoid::Process:
--Added pcommFork to facilitate forking with bi-directional process
communication
v2.07 (2019/02/01)
==================
Paranoid::Args:
--Consolidate error messages, removing reports for both short/long argument
versions, etc
--Correlate AccompaniedBy/ExclusiveOf errors to both long/short versions
--Automatically set Multiple/CanBundle and Template for any templates
w/CountShort
--Automatically set CanBundle for any options w/a short option and a
template of '' or '$'. The latter is done if there is also a long
name for the option
--Add templates for debug, verbose, help, and version for convenience
Paranoid::Debug:
--Modified pdebug to provide support for plog-passing of messages
--PDPREFIX subroutines are now passed the appropriate caller name during
invocation
--Added PDEBUG1 - PDEBUG8 for developer convenience
Paranoid::Filesystem:
--Fix pmkdir to treat permissions as explicit, not relative to umask
--Modified ptranslatePerms to allow it to be passed octal numbers (or string
representations of octal numbers) and have it return those values
unmodified. This makes it agnostic to translated or untranslated input.
Paranoid::Glob:
--Prune redundant / in paths
Paranoid::Input:
--Documented NEWLINE_REGEX
Paranoid::IO:
--File locking had some corner cases in which flocks weren't applied.
Removed that logic entirely, locks are now applied, regardless.
Paranoid::Log:
--Added Stdout mechanism that passes log messages to STDOUT
--Added Stderr mechanism that passes log messages to STDERR
--Added PDebug mechanism that passes log messages to pdebug, and allows
for pdebug to be used as a message preprocessor for sprintf functionality
--Added plverbosity as a convenience function to support Stdout/Stderr
messages for non-interactive applications
Paranoid::Process:
--fixed pfork to make sure the children counters were reset for the child,
so max children limits apply on a per-process basis. Doing it globally
was unreliable, especially since children only knew what the parent's
count was prior to forking.
v2.06 (2018/08/06)
==================
--Typos in documentation (Debian Perl Group)
--Fixed bug in pflock in Paranoid::Process that failed to apply the
flock as requested
--Improved pflock testing as used by Paranoid::Log::File
--Updated Paranoid::IO::Line POD to clarify the third option to many
functions which control line chomping.
--Improved Paranoid::Process to constrain SIGCHLD handling to only those
children forked specifically with/pfork(). This keeps evals and
miscellaneous system calls from skewing the counter.
--Fixed pchown tests for platforms that use negative numbers for uid/gid
v2.05 (2017/03/23)
==================
--pkmdir would fail when given paths that included . or .. subdirs,
fixed
--improved error message from pkmdir to make it obvious what specific
portion of the path failed
--fixed a bug in popen where reopening a filehandle that was stored
under its absolute name deleted the internal cache record
--fixed sigchld signal preemption so it doesn't miss children exit
codes
v2.04 (2016/09/19)
==================
--Added signal dispatcher functionality to Paranoid::Process
v2.03 (2016/08/09)
==================
--Bad plan for non-IPv6-enabled systems
v2.02 (2016/08/09)
==================
--Typos in documentation (Debial Perl Group)
--Regex improvement for IPv6 addresses (theodore@grcrun11.gr)
v2.01 (2016/06/23)
==================
--Fixed error in prm where files weren't actually deleted if there was a
previous error in $! that set ENOENT
--Fixed error in Paranoid::Filesystem where umask was improperly applied
--Fixed error in popen where mode & perms weren't detainted completely
--Adjusted log file test to account for some timing issues on some platforms
--Expanded documentation for Paranoid::Input (documenting known regexes)
v2.00 (2015/10/12)
==================
--Dropped support for Perl 5.6
--Eliminated most instances of croak/die in favor of expecting developers
to check the return value
--Complete rewrite of I/O layers and functions
--Added Paranoid::IO
--Added Paranoid::IO::Line
--Moved slurp, sip, etc., to Paranoid::IO::Line
--Rewrote slurp, sip, etc., to provide non-locking versions of functions
--Rewrote slurp, sip, etc., to leverage tuneable performance options from
Paranoid::IO
--Rewrote and moved Paranoid::Lockfile to Paranoid::IO::Lockfile
--Rewrote Paranoid::Log, Paranoid::Log::Buffer, and Paranoid::Log::File
--Renamed perror to pderror in Paranoid::Debug to avoid name conflict
with POSIX
--Added printf functionality to pdebug
--Added platform-agnostic pchomp to Paranoid::Input
--Added passed regex functionality to detaint
--Updated detaint to make target var (third argument) optional
--Updated detaint to work on arrays and hashes as well
--Improved/expanded module unit tests
--Eliminated use of prototypes except where absolutely needed
(which eliminates the need to pass by reference for many functions)
--Eliminated pglob from Paranoid::Filesystem. Globs should be handled
exclusively through Paranoid::Glob.
--Modified all Paranoid::Filesystem functions to reorder arguments in
actual order of importance, making optional arguments truly optional
--Made all Paranoid::Filesystem functions consistent in declaring
a filesystem target: you can pass either a string or a glob, but if
specifying disparate targets as a list you must pass it as a
Paranoid::Glob.
--Removed Paranoid::BerkeleyDB, Paranoid::Log::Syslog, and
Paranoid::Log::Email. Those are now in their own CPAN distributions.
--Added/improved various regexes in Paranoid::Input
--Improved Paranoid::Network's extractIPs to also extract network
addresses
--Added deepCmp to the Paranoid::Data module.
v0.36 (2012/09/24)
==================
--Documentation updates
--Added IPv4/6 sorting functions, supporting string, packed, and
integer formats
--Fixed MAXIPV6CIDR constant to 128
--Fixed bare words warnings in Perl 5.6 for IPv6 modules
v0.34 (2012/05/29)
==================
--Added Paranoid::Network::IPv4 & Paranoid::Network::IPv6 to provide
general protocol-specific functions
--Added ipv4NetConvert function to convert IPv4 IPs to native integer
format, and network ranges to base, broadcast, and netmasks in
native integer format
--Added ipv6NetConvert function to convert IPv6 IPs to 32bit integer
arrays, and network ranges to base, broadcast, and netmasks in
32bit integer arrays
--Added ipv4NetIntersect function to test whether two IPv4 IP/network
address ranges intersect
--Added ipv6NetIntersect function to test whether two IPv6 IP/network
address ranges intersect
--Reworked Paranoid::Network to make use of IPv4/IPv6 modules for
use in ipInNetwork
--Added netIntersect to Paranoid::Network, which is an IPv4/IPv6-
agnostic wrapper for the related functions in the IPv4/IPv6 modules
--Typo fixed in Paranoid::Network::Socket documentation
v0.33 (2011/12/29)
==================
--Detection of imported symbols in the local namespace wasn't working
correctly. Fixed.
v0.32 (2011/12/19)
==================
--Added new wrapper module for simpler, more portable IPv6 support and
checking (Paranoid::Network::Socket)
--Modified Paranoid::Network to use Paranoid::Network::Socket, and removed
Socket, Socket6, and Paranoid::Module dependencies
--Improved Paranoid::Module to reduce the number of detaints, requires,
and evals for high frequency calls
--Improved debug output of Paranoid::Module
v0.31 (2011/12/06)
==================
--Use of cached file handles in Paranoid::Lockfile is now fork-safe
--Use of open databases in Paranoid::BerkeleyDB is now fork-safe
--Added lock/unlock methods to Paranoid::BerkeleyDB objects for
multiple operations that need to be atomic
--Socket6 is no longer needed or looked for if on Perl 5.14 or newer
v0.30 (2011/08/17)
==================
--Added file permissions support to BerkekelyDB module
--Moved flocking of lockfile to the BerkelelyDB internals
--plock, etc., now returns exit value of flock routine in Lockfile
--Fixed optional prereqs in generated META.yml file
--Added CREDITS file (with recognition for Slaven Rezic (srezic@cpan.org))
v0.29 (2011/04/15)
==================
--Perl-5.6 compatibility fix: Socket in 5.6 doesn't export AF/PF_INET6,
so using Socket6's exclusively
--Perl-5.8 compatibility fix: Perl's parser chokes on the use of 'bare
word' imports (i.e., AF_INET), so calling them as subs.
--Optimizing regexes with code-based interpolations of constants
--Misc code adjustments
v0.28 (2011/04/12)
==================
--Updated ipInNetwork in Paranoid::Network to support IPv6 networks &
addresses
--Added new function extractIPs to Paranoid::Network which can extract IPv4/
IPv6 addresses from arbitrary text
--Minor tweaks to some regexes in Paranoid::Input
v0.27 (2010/06/03)
==================
--Added the ability to restrict level of indentation for pdebug messages in
Paranoid::Debug
--Fixed pchmod so that relative permissions applied to a symlink doesn't use
the symlink's permissions to apply, but rather the target
--Rewrote Paranoid::Log's internals
--Added '!' as a supported scope for logging facilities
--Added more severity level aliases
v0.26 (2010/05/08)
==================
--Changed daemonize's behavior: reopening STD* on /dev/null and chdir'ing
to /. Hindsight's 20/20, eh?
--Made backup/restore of SIGCHLD in pcapture dependent upon an actual
sighandler being installed
v0.25 (2010/05/05)
==================
--Fixed tail's behavior to be consistent with documentation
--Fixed tail/sip to preserve file position and buffers when
reopening the file in children
--Fixed tail functionality to handle deleted, truncated, moved, or replaced
files
--Expanded tail/sip documentation
--Added daemonize function to Paranoid::Process
v0.24 (2010/04/15)
==================
--Added Paranoid::Glob
--Major cleanup to satisfy PerlCritic and PerlTidy
--Fixed pmkdir to allow permissions that include sticky bits, etc.
--Updated filesystem functions to use Paranoid::Glob instead of pglob
--pglob is now just a wrapper around Paranoid::Glob as well
--Removed excessive external locking in Paranoid::BerkeleyDB -- hopefully
internal CDB locking mechanism is robust enough
--Made user input validation on Paranoid::Filesystem non-fatal (handing in
undefs as filenames, etc.)
--Removed MAXLINKS in Paranoid::Filesystem
v0.23 (2009/03/17)
===================
--Fixed tests that weren't fully supported on all platforms
--Commented out pchown tests which were failing to due to a bug
in Perl. A patch has been submitted to bleadperl to address it.
--Added manual detaint of TERM environment variable in psecureEnv
--Updated documentation to include Paranoid::Data
--Made getKeys in Paranoid::BerkeleyDB use finer grained locking
--Added Paranoid::Data
--Added sip, tail, and closeFile functions
--Fixed bug in preadDir that added undef records while filtering out
symlinks (bug introduced in v0.21)
v0.21 (2009/03/04)
===================
--Massive reformat with Perl::Tidy
--Massive rewrite to accommodate Perl::Critic
--Converted all tests to use Test::More
--Converted licensing to be same as Perl
--Documentation updates
--Updated to only support Perl 5.6 or better
--Fixed bug in pcapture to return appropriate return values
--Fixed bug in pchmodR/pchownR to return correct RV (false)
with non-existant targets
--Added Paranoid::Args
v0.20 (2008/04/28)
===================
--Misc. POD updates
Paranoid::Filesystem:
--Fixed bug in the recursion wrapper where there were errors in certain
modes when called on a hierarchy that included an empty subdirectory
--Fixed bug in pchmod where subtracting perms (i.e., o-w) wouldn't result
in the correct permissions
--Added automatic argument detainting for most functions
--Replaced the horrible manual kludge of pglob with an intelligent wrapper for
the shell glob
--ptouch now supports full shell globbing, even for non-existent files.
--ptouchR can now create files, but won't automatically create subdirectories
Paranoid::Input:
--Added automatic filename detainting for slurp
--Updated filename/fileglob regexes (expanded allowed characters)
Paranoid::Log & Paranoid::Module:
--Added automatic detainting of module names
Paranoid::Log::File:
--Added automatic detainting of log filenames
v0.19 (2008/04/28)
===================
--Made the croak statements more internally consistent
--Made releasing the lockfiles and db entries in BerkeleyDB more explicit
--Updated filename regex in Input
--Added study to stringMatch
--Added pcapture function to Process
v0.18 (2008/02/29)
===================
--Fixed mail headers for Email module when there are multiple recipients
--Fixed tests to account for FreeBSD's comments in /etc/passwd, /etc/group
v0.17 (2008/02/28)
===================
--Made more tests conditional to account for more types of
system configurations
--Made error checking more explicit for e-mail logging, and storing
those errors in Paranoid::ERROR
v0.16 (2008/02/27)
===================
--Fixed conditional tests
--Added new function to Paranoid::Debug (psetDebug)
v0.15 (2008/02/26)
===================
--Initial public release