| 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 |
|