Debian Codegraph @

CHANGELOG

raw
1 CHANGELOG
2
3 v2.10 (2022/??/??)
4 ==================
5 --Added subPre/Postamble convenience functions to Paranoid::Debug,
6 along with argument summarization
7 --Changed pdebug output to make it easier to match entrance/exit
8 points in subroutine messages
9 --Added file import/export functionality to Paranoid::Data::AVLTree
10 --Added basic internal profiling support to Paranoid::Data::AVLTree
11 --Modified default PATH for pSecureEnv to include sbin directories
12 --Added quad/long conversion functions to Paranoid::Data, along with
13 a boolean function to detect native quad support
14 --Various documentation fixes/enhancements
15
16 v2.09 (2021/12/28)
17 ==================
18 --Added new export options for Paranoid::IO
19 --Added new flock stack mechanism to support transactional I/O patterns
20 --Improved open flag filtering on reopens
21 --pflock now performs and popen in order to make sure an flock is
22 properly applied to reopened file handles in children
23 --Improved pdebug logging for items geting passed arbitrary content
24 (logging bytes in content, rather that spilling complete content into the
25 logs)
26 --Added non-flocking variants of I/O functions
27 --Added I/O tests w/pflock stack enabled to ensure consistent behaviour
28 --Added Paranoid::IO::FileMultiplexer class, which allows for multiple
29 data stream I/O within a single file, but using normal discrete file
30 I/O semantics
31 --Fixed Paranoid::Filesystem test to account for NetBSD's noatime
32 implementation (utime calls for atime fail entirely)
33
34 v2.08 (2020/12/31)
35 ==================
36 --Updated licensing information to reflect Paranoid trademark impact
37 --Added IMPORT LISTS section to all modules with exportable functions
38 Paranoid::Args:
39 --Added template list for exports
40 Paranoid::Data::AVLTree:
41 --Added a tree & node class implementing AVL-balanced tree structures
42 Paranoid:Debug:
43 --Added constants list for exports
44 --Documentation updates
45 Paranoid::Log:
46 --Minor internal refactoring
47 Paranoid::Process:
48 --Added pcommFork to facilitate forking with bi-directional process
49 communication
50
51 v2.07 (2019/02/01)
52 ==================
53 Paranoid::Args:
54 --Consolidate error messages, removing reports for both short/long argument
55 versions, etc
56 --Correlate AccompaniedBy/ExclusiveOf errors to both long/short versions
57 --Automatically set Multiple/CanBundle and Template for any templates
58 w/CountShort
59 --Automatically set CanBundle for any options w/a short option and a
60 template of '' or '$'. The latter is done if there is also a long
61 name for the option
62 --Add templates for debug, verbose, help, and version for convenience
63 Paranoid::Debug:
64 --Modified pdebug to provide support for plog-passing of messages
65 --PDPREFIX subroutines are now passed the appropriate caller name during
66 invocation
67 --Added PDEBUG1 - PDEBUG8 for developer convenience
68 Paranoid::Filesystem:
69 --Fix pmkdir to treat permissions as explicit, not relative to umask
70 --Modified ptranslatePerms to allow it to be passed octal numbers (or string
71 representations of octal numbers) and have it return those values
72 unmodified. This makes it agnostic to translated or untranslated input.
73 Paranoid::Glob:
74 --Prune redundant / in paths
75 Paranoid::Input:
76 --Documented NEWLINE_REGEX
77 Paranoid::IO:
78 --File locking had some corner cases in which flocks weren't applied.
79 Removed that logic entirely, locks are now applied, regardless.
80 Paranoid::Log:
81 --Added Stdout mechanism that passes log messages to STDOUT
82 --Added Stderr mechanism that passes log messages to STDERR
83 --Added PDebug mechanism that passes log messages to pdebug, and allows
84 for pdebug to be used as a message preprocessor for sprintf functionality
85 --Added plverbosity as a convenience function to support Stdout/Stderr
86 messages for non-interactive applications
87 Paranoid::Process:
88 --fixed pfork to make sure the children counters were reset for the child,
89 so max children limits apply on a per-process basis. Doing it globally
90 was unreliable, especially since children only knew what the parent's
91 count was prior to forking.
92
93 v2.06 (2018/08/06)
94 ==================
95 --Typos in documentation (Debian Perl Group)
96 --Fixed bug in pflock in Paranoid::Process that failed to apply the
97 flock as requested
98 --Improved pflock testing as used by Paranoid::Log::File
99 --Updated Paranoid::IO::Line POD to clarify the third option to many
100 functions which control line chomping.
101 --Improved Paranoid::Process to constrain SIGCHLD handling to only those
102 children forked specifically with/pfork(). This keeps evals and
103 miscellaneous system calls from skewing the counter.
104 --Fixed pchown tests for platforms that use negative numbers for uid/gid
105
106 v2.05 (2017/03/23)
107 ==================
108 --pkmdir would fail when given paths that included . or .. subdirs,
109 fixed
110 --improved error message from pkmdir to make it obvious what specific
111 portion of the path failed
112 --fixed a bug in popen where reopening a filehandle that was stored
113 under its absolute name deleted the internal cache record
114 --fixed sigchld signal preemption so it doesn't miss children exit
115 codes
116
117 v2.04 (2016/09/19)
118 ==================
119 --Added signal dispatcher functionality to Paranoid::Process
120
121 v2.03 (2016/08/09)
122 ==================
123 --Bad plan for non-IPv6-enabled systems
124
125 v2.02 (2016/08/09)
126 ==================
127 --Typos in documentation (Debial Perl Group)
128 --Regex improvement for IPv6 addresses ([email protected])
129
130 v2.01 (2016/06/23)
131 ==================
132 --Fixed error in prm where files weren't actually deleted if there was a
133 previous error in $! that set ENOENT
134 --Fixed error in Paranoid::Filesystem where umask was improperly applied
135 --Fixed error in popen where mode & perms weren't detainted completely
136 --Adjusted log file test to account for some timing issues on some platforms
137 --Expanded documentation for Paranoid::Input (documenting known regexes)
138
139 v2.00 (2015/10/12)
140 ==================
141 --Dropped support for Perl 5.6
142 --Eliminated most instances of croak/die in favor of expecting developers
143 to check the return value
144 --Complete rewrite of I/O layers and functions
145 --Added Paranoid::IO
146 --Added Paranoid::IO::Line
147 --Moved slurp, sip, etc., to Paranoid::IO::Line
148 --Rewrote slurp, sip, etc., to provide non-locking versions of functions
149 --Rewrote slurp, sip, etc., to leverage tuneable performance options from
150 Paranoid::IO
151 --Rewrote and moved Paranoid::Lockfile to Paranoid::IO::Lockfile
152 --Rewrote Paranoid::Log, Paranoid::Log::Buffer, and Paranoid::Log::File
153 --Renamed perror to pderror in Paranoid::Debug to avoid name conflict
154 with POSIX
155 --Added printf functionality to pdebug
156 --Added platform-agnostic pchomp to Paranoid::Input
157 --Added passed regex functionality to detaint
158 --Updated detaint to make target var (third argument) optional
159 --Updated detaint to work on arrays and hashes as well
160 --Improved/expanded module unit tests
161 --Eliminated use of prototypes except where absolutely needed
162 (which eliminates the need to pass by reference for many functions)
163 --Eliminated pglob from Paranoid::Filesystem. Globs should be handled
164 exclusively through Paranoid::Glob.
165 --Modified all Paranoid::Filesystem functions to reorder arguments in
166 actual order of importance, making optional arguments truly optional
167 --Made all Paranoid::Filesystem functions consistent in declaring
168 a filesystem target: you can pass either a string or a glob, but if
169 specifying disparate targets as a list you must pass it as a
170 Paranoid::Glob.
171 --Removed Paranoid::BerkeleyDB, Paranoid::Log::Syslog, and
172 Paranoid::Log::Email. Those are now in their own CPAN distributions.
173 --Added/improved various regexes in Paranoid::Input
174 --Improved Paranoid::Network's extractIPs to also extract network
175 addresses
176 --Added deepCmp to the Paranoid::Data module.
177
178 v0.36 (2012/09/24)
179 ==================
180 --Documentation updates
181 --Added IPv4/6 sorting functions, supporting string, packed, and
182 integer formats
183 --Fixed MAXIPV6CIDR constant to 128
184 --Fixed bare words warnings in Perl 5.6 for IPv6 modules
185
186 v0.34 (2012/05/29)
187 ==================
188 --Added Paranoid::Network::IPv4 & Paranoid::Network::IPv6 to provide
189 general protocol-specific functions
190 --Added ipv4NetConvert function to convert IPv4 IPs to native integer
191 format, and network ranges to base, broadcast, and netmasks in
192 native integer format
193 --Added ipv6NetConvert function to convert IPv6 IPs to 32bit integer
194 arrays, and network ranges to base, broadcast, and netmasks in
195 32bit integer arrays
196 --Added ipv4NetIntersect function to test whether two IPv4 IP/network
197 address ranges intersect
198 --Added ipv6NetIntersect function to test whether two IPv6 IP/network
199 address ranges intersect
200 --Reworked Paranoid::Network to make use of IPv4/IPv6 modules for
201 use in ipInNetwork
202 --Added netIntersect to Paranoid::Network, which is an IPv4/IPv6-
203 agnostic wrapper for the related functions in the IPv4/IPv6 modules
204 --Typo fixed in Paranoid::Network::Socket documentation
205
206 v0.33 (2011/12/29)
207 ==================
208 --Detection of imported symbols in the local namespace wasn't working
209 correctly. Fixed.
210
211 v0.32 (2011/12/19)
212 ==================
213 --Added new wrapper module for simpler, more portable IPv6 support and
214 checking (Paranoid::Network::Socket)
215 --Modified Paranoid::Network to use Paranoid::Network::Socket, and removed
216 Socket, Socket6, and Paranoid::Module dependencies
217 --Improved Paranoid::Module to reduce the number of detaints, requires,
218 and evals for high frequency calls
219 --Improved debug output of Paranoid::Module
220
221 v0.31 (2011/12/06)
222 ==================
223 --Use of cached file handles in Paranoid::Lockfile is now fork-safe
224 --Use of open databases in Paranoid::BerkeleyDB is now fork-safe
225 --Added lock/unlock methods to Paranoid::BerkeleyDB objects for
226 multiple operations that need to be atomic
227 --Socket6 is no longer needed or looked for if on Perl 5.14 or newer
228
229 v0.30 (2011/08/17)
230 ==================
231 --Added file permissions support to BerkekelyDB module
232 --Moved flocking of lockfile to the BerkelelyDB internals
233 --plock, etc., now returns exit value of flock routine in Lockfile
234 --Fixed optional prereqs in generated META.yml file
235 --Added CREDITS file (with recognition for Slaven Rezic ([email protected]))
236
237 v0.29 (2011/04/15)
238 ==================
239 --Perl-5.6 compatibility fix: Socket in 5.6 doesn't export AF/PF_INET6,
240 so using Socket6's exclusively
241 --Perl-5.8 compatibility fix: Perl's parser chokes on the use of 'bare
242 word' imports (i.e., AF_INET), so calling them as subs.
243 --Optimizing regexes with code-based interpolations of constants
244 --Misc code adjustments
245
246 v0.28 (2011/04/12)
247 ==================
248 --Updated ipInNetwork in Paranoid::Network to support IPv6 networks &
249 addresses
250 --Added new function extractIPs to Paranoid::Network which can extract IPv4/
251 IPv6 addresses from arbitrary text
252 --Minor tweaks to some regexes in Paranoid::Input
253
254 v0.27 (2010/06/03)
255 ==================
256 --Added the ability to restrict level of indentation for pdebug messages in
257 Paranoid::Debug
258 --Fixed pchmod so that relative permissions applied to a symlink doesn't use
259 the symlink's permissions to apply, but rather the target
260 --Rewrote Paranoid::Log's internals
261 --Added '!' as a supported scope for logging facilities
262 --Added more severity level aliases
263
264 v0.26 (2010/05/08)
265 ==================
266 --Changed daemonize's behavior: reopening STD* on /dev/null and chdir'ing
267 to /. Hindsight's 20/20, eh?
268 --Made backup/restore of SIGCHLD in pcapture dependent upon an actual
269 sighandler being installed
270
271 v0.25 (2010/05/05)
272 ==================
273 --Fixed tail's behavior to be consistent with documentation
274 --Fixed tail/sip to preserve file position and buffers when
275 reopening the file in children
276 --Fixed tail functionality to handle deleted, truncated, moved, or replaced
277 files
278 --Expanded tail/sip documentation
279 --Added daemonize function to Paranoid::Process
280
281 v0.24 (2010/04/15)
282 ==================
283
284 --Added Paranoid::Glob
285 --Major cleanup to satisfy PerlCritic and PerlTidy
286 --Fixed pmkdir to allow permissions that include sticky bits, etc.
287 --Updated filesystem functions to use Paranoid::Glob instead of pglob
288 --pglob is now just a wrapper around Paranoid::Glob as well
289 --Removed excessive external locking in Paranoid::BerkeleyDB -- hopefully
290 internal CDB locking mechanism is robust enough
291 --Made user input validation on Paranoid::Filesystem non-fatal (handing in
292 undefs as filenames, etc.)
293 --Removed MAXLINKS in Paranoid::Filesystem
294
295
296 v0.23 (2009/03/17)
297 ===================
298 --Fixed tests that weren't fully supported on all platforms
299 --Commented out pchown tests which were failing to due to a bug
300 in Perl. A patch has been submitted to bleadperl to address it.
301 --Added manual detaint of TERM environment variable in psecureEnv
302 --Updated documentation to include Paranoid::Data
303 --Made getKeys in Paranoid::BerkeleyDB use finer grained locking
304 --Added Paranoid::Data
305 --Added sip, tail, and closeFile functions
306 --Fixed bug in preadDir that added undef records while filtering out
307 symlinks (bug introduced in v0.21)
308
309 v0.21 (2009/03/04)
310 ===================
311 --Massive reformat with Perl::Tidy
312 --Massive rewrite to accommodate Perl::Critic
313 --Converted all tests to use Test::More
314 --Converted licensing to be same as Perl
315 --Documentation updates
316 --Updated to only support Perl 5.6 or better
317 --Fixed bug in pcapture to return appropriate return values
318 --Fixed bug in pchmodR/pchownR to return correct RV (false)
319 with non-existant targets
320 --Added Paranoid::Args
321
322 v0.20 (2008/04/28)
323 ===================
324 --Misc. POD updates
325
326 Paranoid::Filesystem:
327 --Fixed bug in the recursion wrapper where there were errors in certain
328 modes when called on a hierarchy that included an empty subdirectory
329 --Fixed bug in pchmod where subtracting perms (i.e., o-w) wouldn't result
330 in the correct permissions
331 --Added automatic argument detainting for most functions
332 --Replaced the horrible manual kludge of pglob with an intelligent wrapper for
333 the shell glob
334 --ptouch now supports full shell globbing, even for non-existent files.
335 --ptouchR can now create files, but won't automatically create subdirectories
336
337 Paranoid::Input:
338 --Added automatic filename detainting for slurp
339 --Updated filename/fileglob regexes (expanded allowed characters)
340
341 Paranoid::Log & Paranoid::Module:
342 --Added automatic detainting of module names
343
344 Paranoid::Log::File:
345 --Added automatic detainting of log filenames
346
347 v0.19 (2008/04/28)
348 ===================
349 --Made the croak statements more internally consistent
350 --Made releasing the lockfiles and db entries in BerkeleyDB more explicit
351 --Updated filename regex in Input
352 --Added study to stringMatch
353 --Added pcapture function to Process
354
355 v0.18 (2008/02/29)
356 ===================
357 --Fixed mail headers for Email module when there are multiple recipients
358 --Fixed tests to account for FreeBSD's comments in /etc/passwd, /etc/group
359
360 v0.17 (2008/02/28)
361 ===================
362 --Made more tests conditional to account for more types of
363 system configurations
364 --Made error checking more explicit for e-mail logging, and storing
365 those errors in Paranoid::ERROR
366
367 v0.16 (2008/02/27)
368 ===================
369 --Fixed conditional tests
370 --Added new function to Paranoid::Debug (psetDebug)
371
372 v0.15 (2008/02/26)
373 ===================
374 --Initial public release