Debian Codegraph @

Changes

raw
1 NAME
2 Badger::Changes - Summary of changes in the Badger toolkit
3
4 CHANGES
5 This document contains a brief overview of what has changed between
6 successive version of the Badger toolkit.
7
8 Badger is now considered to be mature, stable, reliable, and unlikely to
9 change significantly in future versions.
10
11 Version 0.16 - 5th June 2023
12 Fix numerous spelling mistakes in POD
13
14 <https://github.com/abw/Badger/pull/18>
15
16 Version 0.15 - 24th August 2022
17 Added "filename_format" option to Badger::Log::File.
18
19 Version 0.14 - 16th August 2022
20 Added support for Cpanel::JSON::XS to Badger::Codec::JSON.
21
22 Added strftime option to Badger::Log.
23
24 Version 0.13 - 18th October 2018
25 Silenced various "used only once" warnings.
26
27 Win32 fixes for Badger::Filesystem::Virtual.
28
29 Version 0.12 - 12th December 2016
30 Added some tests for YAML modules in 3 test scripts that were failing.
31
32 Version 0.11 - 11th December 2016
33 Fix for missing file in distribution.
34
35 Version 0.10 - 11th December 2016
36 Added Badger::Comparable, Badger::Date, Badger::Duration,
37 Badger::Filter, Badger::Progress, Badger::Workplace, Badger::Workspace
38 and Badger::Config::Filesystem.
39
40 Refactored parts of Badger::Config.
41
42 Changed Badger::Base message() method to allow message formats to be
43 defined in "$self-"{ messages }> when $self is a blessed hash object.
44
45 Added no_config() method to Badger::Hub.
46
47 Fixed a bug in the auto_can feature of Badger::Class::Methods which
48 prevented it from working with subclasses.
49
50 Fixed a bug in Badger::Debug dump_ref() to make it directly call other
51 "dump_XXX()" functions instead of relying on inheritance of those
52 methods through $self.
53
54 Added plurality(), inflect(), list_each(), hash_each(), extend(),
55 merge(), split_to_list(), join_uri() and resolve_uri(), to
56 Badger::Utils.
57
58 Added additional delegate hooks to Badger::Utils to load utility
59 functions in Badger::Filesystem, Badger::Timestamp, Badger::Duration,
60 Badger::Logic and Badger::URL.
61
62 Squashed a non-numerical warning in Badger::Timestamp.
63
64 Added the UTF8, JSON and YAML constants to Badger::Constants.
65
66 Fixed Badger::Codec::YAML to work better with YAML::XS and
67 Badger::Codec::JSON to work better with JSON::XS.
68
69 Fixed a typo/bug in the "type_args()" in Badger::Factory method which
70 was returning the wrong argument list.
71
72 Fixed a parser bug in Badger::Logic.
73
74 Fixes to silence warnings in perl 5.22.
75
76 Version 0.09 - 8th February 2012
77 Added Badger::Codec::Timestamp. Changed Badger::Timestamp to numify
78 values to remove leading zeroes (e.g. 2012/04/20 now yields a month of 4
79 instead of 04).
80
81 Fixed some obscure bugs in the module loading code in Badger::Class and
82 related modules that could potentially cause unpredictable results on
83 case insensitive file systems (e.g. Apple's HFS with default settings).
84
85 Added the restat() method to Badger::Filesystem::Path.
86
87 Added documentation for various methods that was missing. Temporary
88 disabled the Pod::Coverage tests on AUTOMATED_TESTING systems. We know
89 there's still stuff to do.
90
91 Added SLASH to Badger::Constants
92
93 Version 0.08 - 13th January 2012
94 Restored the $VERSION variable to Badger.pm rather than using the
95 "version" import hook in Badger::Class which confused PAUSE.
96
97 Changed Badger::Test::Manager to detect undefined results.
98
99 Merged Michael Grubb's bug fix for Badger::Base:
100 <https://github.com/abw/Badger/pull/1>
101
102 Fixed some minor documentation issues.
103
104 Version 0.07 - 2nd January 2012
105 Added Badger::Storage, Badger::Storage::Memory. and
106 Badger::Storage::Filesystem.
107
108 Added Badger::Codec::TT.
109
110 Added the permissions() method to Badger::Filesystem::Path. Added
111 temp_directory() and temp_file() methods to Badger::Filesystem. Also
112 changed the Path(), File() and Dir() functions to short-circuit and
113 return if passed a single object that is already of the expected type.
114
115 Added some extra comparison methods to Badger::Timestamp (not_equal(),
116 (not_before() and not_after()) and overloaded these and other methods
117 onto the "==", "!=", "<", ">", "<=" and ">=" operators.
118
119 Added the export_before() and export_after() methods to
120 Badger::Exporter.
121
122 Added the if_env import hook and "-a|Badger::Test/all()" option to
123 Badger::Test to make it easier to define tests that don't get run unless
124 a particular environment variable is set (e.g. for Pod coverage/kwalitee
125 tests that you only want to run if either of the "RELEASE_TESTING" or
126 "AUTOMATED_TESTING" environment variables is set).
127
128 Added the random_name(), camel_case() and permute_fragments() functions
129 to Badger::Utils. Also add some extra debugging code to params() and
130 self_params() to catch any attempt to pass an odd number of arguments.
131
132 Changed the Badger::Factory module to use permute_fragments() on the
133 module path when specified as a single string. Also added the default()
134 and names() methods along with their corresponding package variable
135 magic.
136
137 Added the debug_callers(), debugf() and debug_at() methods to
138 Badger::Debug.
139
140 Added the alias() method to Badger::Class.
141
142 Added the auto_can() method to Badger::Class::Methods.
143
144 Changed the Badger::Class::Config module to store the configuration
145 scheme in $CONFIG_SCHEMA instead of $CONFIG.
146
147 Added the Badger::Codec::HTML module which defines the "html" codec.
148
149 Changed the throw() method in Badger::Base to pass the exception type to
150 exception().
151
152 Changed the try() method in Badger::Base to preserve the list/scalar
153 calling context and to handle false but defined values.
154
155 Cleaned up and generalised the Badger::Hub module. The Badger-specific
156 data has now been moved into Badger::Hub::Badger. The "configure()"
157 method is now called construct().
158
159 Version 0.06
160 Added copy_file() and move_file() to Badger::Filesystem and copy() and
161 move() methods to Badger::Filesystem::File.
162
163 Added chmod_path() to Badger::Filesystem and chmod() to
164 Badger::Filesystem::Path.
165
166 Added Bin() to Badger::Filesystem.
167
168 Added the encoding() method to Badger::Filesystem::File for specifying
169 the encoding of a file, along with the utf8(), bytes(), crlf() and raw()
170 methods for enabling different encoding layers.
171
172 Added the codec() method to Badger::Filesystem::File for specifying a
173 serialisation codec to use in conjunction with the new data() method.
174
175 Added Badger::Timestamp. This is returned by the new created(),
176 accessed() and modified() methods in Badger::Filesystem::Path.
177
178 Added Badger::Logic.
179
180 Added Badger::Log and Badger::Log::File.
181
182 Added numlike() to Badger::Utils as an alias for "looks_like_number".
183 It's the numerical counterpart to textlike() and is significantly easier
184 to type.
185
186 Added debug_msg() to Badger::Base. Also added the "Badger::Base::Trial"
187 class definition for use with the try() method.
188
189 Added lib import hook to Badger.
190
191 Added bclass as an alias for class in Badger::Class.
192
193 Changed Badger::Class::Config to maintain the order of configuration
194 parameters where possible (i.e. when expressed as a list ref rather than
195 a hash ref). Also added "target:var" fallback which looks in the target
196 object or hash ref for the variable. This allows options to default to
197 the values set by preceeding options.
198
199 Changed Badger::Codec::JSON to use JSON::XS if available.
200
201 Mr T is now using Badger 0.06 in production code and is happy to report
202 that everything seems to be working rather well. Anyone for a game of
203 tennis?
204
205 Version 0.05 - 23rd December 2008
206 Refactored Badger::Factory.
207
208 Added support to Badger::Exporter for the "=" pseudo-sigil which can be
209 used to create constants on the fly.
210
211 package Badger::Example;
212 use Badger::Class
213 exports => {
214 tags => {
215 math => {
216 e => '=2.718',
217 pi => '=3.142',
218 phi => '=1.618',
219 },
220 }
221 };
222
223 package main;
224 use Badger::Example ':math';
225
226 print e; # 2.718
227 print pi; # 3.142
228 print phi; # 1.618
229
230 Mr T is starting to feel rather confident about building a production
231 system based on Badger v0.05.
232
233 Version 0.04 - 2nd December 2008
234 Added the throw_msg() method to Badger::Base.
235
236 Added init_method hook to Badger::Class and initialiaser() to
237 Badger::Class::Methods.
238
239 Changed Badger::Exception match_type() method to accept a list or hash
240 reference, or a string of whitespace delimited exception types.
241
242 Changed Badger::Factory to pass $name as an argument to various methods.
243 Also passes arguments to load() (required for Template::TT2::Plugins)
244 Also modified item() to accept a non-textlike type argument which
245 bypasses the module lookup.
246
247 Moved a whole bunch of stuff out of Badger::Class into
248 "Badger::Class::*" modules.
249
250 Added Badger::Class::Config for simple configuration.
251
252 Added hash() method to Badger::Methods and hash_methods hook to
253 Badger::Class.
254
255 Added trace() hook and related paraphernalia to Badger::Exception. Added
256 the "-t" / "--trace" command line options to Badger::Test to enable it
257 when running tests. Also added "-h" / "--help" options.
258
259 Added Codec() exportable subroutine to Badger::Codecs.
260
261 Added Badger::Codec::URL. It's similar to Badger::Codec::URI, but
262 slightly different. See the TT uri/url filters for the reason.
263
264 Changed the prototype() method in Badger::Prototype to accept a single
265 "undef" value to clear any current prototype. Also added the
266 has_prototype() method.
267
268 Mr T is looking on the bright side about the possibility of building a
269 production system based on Badger v0.04, but still advises caution.
270
271 Version 0.03 - 7th October 2008
272 Added delegate loaders to Badger. This provides some semantic sugar for
273 loading a bunch of different "Badger::*" modules in one go.
274
275 use Badger
276 Filesystem => 'FS $Bin',
277 Codecs => 'storable base64',
278 Debug => {
279 modules => 'My::Module',
280 };
281
282 Added different() to Badger::Test::Manager.
283
284 Added textlike() to Badger::Utils
285
286 Added the overload as_text and is_true import hooks and related method
287 to Badger::Class. These delegate to the "overload" module.
288
289 Added the print method to Badger::Filesystem::File.
290
291 Added support for dynamic root directories to
292 Badger::Filesystem::Virtual.
293
294 Added the defaults and aliases hooks to Badger::Class, implemented by
295 Badger::Class::Defaults and Badger::Class::Aliases, respectively. There
296 are still experimental.
297
298 Fixed up some stat handling in Badger::Filesystem to help with
299 subclassing in Badger::Filesystem::Virtual
300
301 Mr T pities the fool that attempts to builds a production system based
302 on Badger version 0.03 without first evaluating it carefully and reading
303 the documentation.
304
305 Version 0.02 - 6th September 2008
306 Badger::Class got the vars method and hook for declaring and defining
307 variables.
308
309 Badger::Utils gained the ability to load and export functions from
310 Scalar::Util, List::Util, List::MoreUtils, Hash::Util and Digest::MD5.
311
312 Various documentation updates.
313
314 Mr T admires the tenacity of anyone attempting to build a production
315 system based on Badger v0.02 and hopes they have a thorough test suite.
316
317 Version 0.01 - 27th August 2008
318 This was the first release version.
319
320 Mr T pities the fool who builds a production system based on Badger
321 v0.01.
322
323 AUTHOR
324 Andy Wardley <[email protected]>
325
326 COPYRIGHT
327 Copyright (C) 2008-2013 Andy Wardley. All Rights Reserved.
328
329 This module is free software; you can redistribute it and/or modify it
330 under the same terms as Perl itself.
331