3 All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
4 and this project adheres to [Semantic Versioning](http://semver.org).
6 ## Supported Release 5.2.0
8 This is a moderate release made in order to roll up various new features.
11 - `ensure-packages()` duplicate checking now works as it should.
14 - (MODULES-7024) - Support for 20-octet MAC addresses added.
15 - `extname()` function added - This function returns the extensionof whatever file it is passed.
16 - (MODULES-8273) - Unquoted classes can now be used with the `defined_with_params()` function.
17 - (MODULES-8137) - Support has been added for SLES 15.
18 - (MODULES-8404) - `Stdlib::Filesource` has been relaxed and now supports custom mount points.
19 - (MODULES-8322) - IPs values of `0.0.0.0/0` and `::/0` are now considered to be valid.
20 - New type `Stdlib::IP::Address::V6::CIDR` has been created.
22 ## Supported Release 5.1.0
24 This is a moderate release which adds support for Puppet 6.
27 - Handle nil in `delete_undef_values()` function
28 - Readme error regarding concatenation fixed.
29 - Fix to the `pick()` function documentation.
32 - Support added for Puppet 6
34 ## Supported Release 5.0.0
36 This is a major release which removes support for the Scientific 5 and Debian 7 OS, as well as a removal of the `Stdlib::(Ipv4|IPv6|Ip_address)` data types in favour of `Stdlib::IP::*`.
38 **In addition it contains a substantial piece of work centered around updating functions that have now been migrated into Puppet itself. Please note that this will be the last major release to support Puppet 2 and Puppet 3 and that they will soon be removed.**
41 - Docs URLs corrected.
42 - Docs clarified that `Stdlib::Unixpath` only matches absolute paths.
43 - `dirname()` now fails when passed an empty string.
44 - `basename()` documentation clarified.
45 - Corrected documentation of `count()` wrt matches and empty string.
46 - Corrected example in `getparam()` and added note about equivalent in puppet.
47 - Fixed URL to use 'latest' instead of '5.5' for `Hash.new` function.
50 - Support added for symbolic file nodes.
51 - `loadjson()` and `loadyml()` now compatible with HTTPS files.
52 - `loadjson()` and `loadyml()` now compatible with HTTP basic auth files.
53 - `any2array` now returns and empty array when given an empty string.
54 - Support has now been added for Ubuntu 18.04.
55 - `seeded_rand_string()` function has been added.
58 - PDK update `1.5.0` has been applied.
59 - `size()` function deprecated for Puppet 6 and above.
60 - `wrt` functions moved to Puppet as of Puppet 6.
61 - `sprintf_hash` has had notification put in place to show that as of Puppet 4.10.10 it's functionality is supported by the puppet core.
62 - Added note that `abs()` is in puppet since 6.0.0.
63 - Added information to `base64` function about Binary data type.
64 - Added note to `camelcase()` that function is now in puppet.
65 - Added note to `capitalize()` that function is now in puppet.
66 - Added note to `ceiling()` that function is now in puppet.
67 - Added note to `chomp()` that function is now in puppet.
68 - Added note to `chop()` that function is now in puppet.
69 - Added note how to do equivalence of `clamp()` function in puppet 6.
70 - Added note that `concat()` can be done with + since puppet 4.0.0.
71 - Added note to `convert_base()` how to do this with puppet core.
72 - Added equivalent puppet core way of doing `count()`.
73 - Added docs for equivalent puppet language for `delete_regexp()`.
74 - Added docs for equivalent language constructs for `delete_at()`.
75 - Added puppet 4 equivalent for `delete_undef()` function.
76 - Added equivalent puppet language for `delete_values()`.
77 - Updated `delete()` function with docs about equivalent language.
78 - Added docs that - between arrays is the same as `difference()`.
79 - Added note to `downcase()` that function is now in puppet.
80 - Added note to `empty()` that function is now in puppet.
81 - Added note to `flatten()` that function is now in puppet.
82 - Added note to `floor()` that function is now in puppet.
83 - Added note to `get_module_path()` that puppet has similar function.
84 - Amended documentation for `getvar()`.
85 - Add note to `grep()` that `filter()` in puppet does the same.
86 - Updated `has_key()` with equivalent puppet lang expresion.
87 - Updated the `hash()` function to show equivalent expression.
88 - Added note about more formatting options with `String()` in puppet.
89 - Added note to `join()` that it is in puppet since 5.4.0.
90 - Added note to `keys()` that it is in puppet since 5.4.0.
91 - Added note to `lstrip()`, `rstrip()`, `strip()` and `upcase()` that they are in puppet since 6.0.0.
92 - Updated `member()` with equivalent language expression example.
93 - Updated `merge()` with puppt language equivalent example.
94 - Updated `min()` and `max()` with note that they are in puppet.
95 - Updated `num2bool()` with information that Boolean can convert.
96 - Updated `prefix()` function with equivalent operation in pupppet.
97 - Updated `range()` with information that Integer can be used.
98 - Updated `reject()` with equivalent filter() call.
99 - Added note to `reverse()` that the `reverse_each()` Puppet function does the same as it.
100 - Added note to `round()` that it has moved to puppet in 6.0.0.
101 - Added note to `size()` that `length()` is in puppet since 5.4.0.
102 - Added note to `sort()` that is has moved to Puppet in 6.0.0.
103 - Updated `str2bool()` with a note that Boolean can handle conversion.
104 - Added note to `strftime()` that it moved to puppet in 4.8.0.
105 - Added note to `suffix()` that the same can be done with `map()`.
106 - Updated `time()` to mention Timespan and Timestamp data types.
107 - Added note to `values_at()` for equivalent slice operation in language.
108 - Added note to `values()` that it moved to puppet in 5.5.0.
109 - Corrected docs for `keys()` - in puppet since 5.5.0.
110 - Added note to `length()` that function moved to puppet.
111 - Updated README.md with deprecations for functions moved to puppet.
112 - Updated documentation of `values_at()`.
113 - Updated README with note from `time()` about data types for time.
114 - Updated README for `strintf_hash()` (supported by builtin sprintf).
115 - Updated README with deprecation of `hash()` function (use data type).
116 - Updated README `suffix` with equiv example for `map`.
117 - Updated README with `reject` equivalent call to `filter`.
118 - Updated README with `range` equiv use of type system + `each`.
119 - Updated README with `prefix` equiv func using `map`.
120 - Updated README for `num2bool` with info about Boolean type.
121 - Updated README `str2bool` with information about `Boolean` equivalent.
122 - Updated README `merge` with info about `+` operator equivalent.
123 - Updated README `member` with equivalent alternative in language.
124 - Updated README `join_keys_to_values` with link to String.new.
125 - Updated README `has_key` shows deprecation in favor of `in`.
126 - Updated README `grep` adds information about `filter`.
127 - Updated README and `getvar.rb` as getvar has moved to puppet.
128 - Updated README for `getparam` to be the same as in function.
129 - Updated README `get_module_path` with info about built in variant.
130 - Updated README `difference` to mention `-` operator equiv.
131 - Updated README `delete` with built-in alternatives.
132 - Updated README `delete_values` with builtin equiv.
133 - Updated README `delete_undef` & `delete_regexp` with builtin equiv.
134 - Updated README `delete_at` with equivalent built-in examples.
135 - Updated README `coun`t to show built-in equiv.
136 - Updated README `convert_base` with built-in equiv.
137 - Updated README `concat` with built-in equiv using + and <<.
138 - Updated README `base_64` with built-in equiv using Binary type.
139 - Skipped tests for `abs` if puppet version < 6.0.0.
140 - Skipped tests for `min` and `max` if puppet version < 6.0.0.
141 - Skipped tests for `floor` if puppet version < 6.0.0.
142 - Skipped tests for `ceiling` if puppet version < 6.0.0.
143 - Skipped tests for `round` if puppet version < 6.0.0.
144 - Skipped tests for `upcase` if puppet version < 6.0.0.
145 - Skipped tests for `downcase` if puppet version < 6.0.0.
146 - Skipped tests for `capitalize` if puppet version < 6.0.0.
147 - Skipped tests for `camelcase` if puppet version < 6.0.0.
148 - Skipped tests for strip functions if puppet version < 6.0.0.
149 - Skipped tests for `chop` and `chomp` if puppet version < 6.0.0.
150 - Skipped tests for `sort` if puppet version < 6.0.0.
151 - Removed extra space in `describe` for `abs` test.
152 - Updated README and `any2array` with built-in equiv Array.new.
153 - Updated README and `any2bool` with built-in equiv Boolean.new.
154 - Updated README and `bool2num` with built-in equiv Numeric.new.
155 - Updated README and `bool2str` with built-in equiv String.new.
156 - Corrected equivalent example for `count`.
157 - Updated README and made mention of `filter` in `delete` a link.
158 - Updated docs and tests for `strftime`.
159 - Updated all acceptance test using Puppet.version.
160 - Change 'puppet' to 'Puppet' in function doc strings.
161 - HTTP type checks are now case insensitive.
164 - Support has been removed for `Scientific 5` and `Debian 7` operating systems.
165 - `Stdlib::(Ipv4|IPv6|Ip_address)` have been removed.
167 ## Supported Release 4.25.1
170 This is a patch which includes a roll up of small fixes. In Puppet 5.5.0 `flatten()`, `length(),` `empty(),` `join(),` `keys(),` and `values()` are now built into Puppet. Please note that the Puppet implementation of the functions will take precedence over the functions in 'puppetlabs-stdlib'.
173 - Remove unneeded execute permission from test files.
174 - Puppet 5.5.0 function deprecation [MODULES-6894](https://tickets.puppetlabs.com/browse/MODULES-6894).
176 ## Supported Release 4.25.0
179 This is quite a feature heavy release, it makes this module PDK-compliant for easier maintenance and includes a roll up of maintenance changes.
182 - PDK conversion [MODULES-6332](https://tickets.puppetlabs.com/browse/MODULES-6332).
183 - Update `join_keys_to_values` with an undef statement.
184 - Type alias `Stdlib::Fqdn` matches paths on a fully qualified domain name.
185 - Type alias `Stdlib::Host` matches a valid host, this can be a valid 'ipv4', 'ipv6' or 'fqdn'.
186 - Type alias `Stdlib::Port` matches a valid TCP/UDP Port number.
187 - Type alias `Stdlib::Filesource` matches paths valid values for the source parameter of the puppet file type.
188 - Type alias `Stdlib::IP::Address` matches any IP address, including both IPv4 and IPv6 addresses,
189 - Type alias `Stdlib::IP::Address::V4` matches any string consisting of a valid IPv4 address, this is extended by 'CIDR' and 'nosubnet'.
190 - Type alias `Stdlib::IP::Address::V6` matches any string consisting of a valid IPv6 address, this is extended by 'Full', 'Alternate' and 'Compressed'.
191 - Type alias `Stdlib::IP::Address::V6::Nosubnet`matches any string consisting of a valid IPv6 address with no subnet, this is extended by 'Full', 'Alternate' and 'Compressed'.
192 - Type alias `Stdlib::Port` matches a valid TCP/UDP Port number this is then extended to 'Privileged' which are ports less than 1024 and 'Unprivileged' which are ports greater than 1024.
194 ## Supported Release 4.24.0
197 This release includes a roll up of minor changes and a new feature which provides the ability to skip undef values `to_json_pretty()`.
198 We have also reverted a change that was previously made and resulted in breaking compatibility with Ruby 1.8.7.
201 - Ability to skip undef values in `to_json_pretty()`.
202 - Fix type3x function in stdlib ([MODULES-6216](https://tickets.puppet.com/browse/MODULES-6216))
205 - Indentation for `sync.yml` was fixed.
206 - Updated type alias tests and dropped superfluous wrapper classes
207 - Revert to old ruby 1.X style of hash ([MODULES-6139](https://tickets.puppet.com/browse/MODULES-6139))
208 - `rubocop.yml` not managed by msync ([MODULES-6201](https://tickets.puppet.com/browse/MODULES-6201))
210 ## Supported Release 4.23.0
213 This release is in order to implement Rubocop changes throughout the module.
216 - Standard and translated readme's have been updated.
217 - Rubocop has been implemented in the module and a wide variety of changes have been made to the code.
218 - Modulesync changes have been merged into the code.
221 - Minor fix to the readme.
223 ## Supported Release 4.22.0
226 This is a clean release in preparation of putting the module through the rubocop process.
229 - Support has been added for Debian 9
230 - 'Stdlib::Mode type' has been added to the module.
231 - A type for 'ensure' has been added to the service resources.
232 - A new function 'sprintf_hash' has been added to allow the use of named references.
235 - Support has been removed for: RedHat 4, CentOS 4, OracleLinux 4, Scientific 4, SLES 10 SP4, Windows Server 2003, Windows Server 2003 R2 and Windows 8.
238 - The 'ruby_spec.rb' test file has been altered s that it properly checks results.
239 - Example syntax in 'file_line.rb' has been fixed.
241 ## Supported Release 4.21.0
244 This is a small feature release that includes a revamped, albeit backwards-compatible file_line type.
247 - `replace_all_matches_not_matching_line` parameter in file_line
248 - additional tests and documentation for file_line
251 - duplicate spec test for absolute_path
254 - Unixpath type to allow "/" as valid path
255 - file_line behavior that caused infinite appending of `line` to a file ([MODULES-5651](https://tickets.puppet.com/browse/MODULES-5651))
257 ## Supported Release 4.20.0
260 This release adds new functions and updated README translations.
263 - `to_json`, `to_json_pretty`, and `to_yaml` functions
264 - new Japanese README translations
267 - compatibility issue with older versions of Puppet and the `pw_hash` function ([MODULES-5546](https://tickets.puppet.com/browse/MODULES-5546))
270 - support for EOL platform Debian 6 (Squeeze)
272 ## Supported Release 4.19.0
275 This release adds new functions and better documentation/fixes for existing functions with a noteworthy fix for file_line.
278 - Add validate_domain_name function
279 - Add the round function
280 - Add type for MAC address
281 - Add support for sensitive data type to pw_hash ([MODULES-4908](https://tickets.puppet.com/browse/MODULES-4908))
282 - Add new function, fact() (FACT-932)
285 - Fixes for the file_line provider ([MODULES-5003](https://tickets.puppet.com/browse/MODULES-5003))
286 - Add documentation for email functions ([MODULES-5382](https://tickets.puppet.com/browse/MODULES-5382))
287 - unique function is deprecated for puppet version > 5. (FM-6239)
288 - Fix headers in CHANGELOG.md so that headers render correctly
289 - ensure_packages, converge ensure values 'present' and 'installed'
292 - Removes listed support for EOL Ubuntu versions
294 ## Supported Release 4.18.0
297 Small release that reverts the Puppet version requirement lower bound to again include Puppet 2.7+ and bumps the upper bound to now include Puppet 5.
300 - Reverts lower bound of Puppet requirement to 2.7.20
302 ## Supported Release 4.17.1
305 Small release to address a bug (PUP-7650). Also pushes the Puppet version compatibility to 4.7.0.
308 - (MODULES-5095) Workaround for PUP-7650
309 - (FM-6197) Formatting fixes for file_line resource
312 ## Supported Release 4.17.0
314 This release adds support for internationalization. It also contains Japanese translations for the README, summary and description of the metadata.json and major cleanups in the README. Additional folders have been introduced called locales and readmes where translation files can be found. A number of features and bug fixes are also included in this release. It also adds a new function `glob()` for expanding file lists. Also works around an issue that appeared in puppet 4.6.0 involving types being declared multiple times.
317 - Addition of POT file / folder structure for i18n.
318 - Addition of Internationalized READMEs.
322 - Occasional duplicate type definitions when using `defined_with_params()`
323 - `file_line` encoding issue on ruby 1.8 (unsupported)
324 - Huge readme refresh
326 ## Supported Release 4.16.0
329 This release sees a massive update to all unit tests to test UTF8 characters. There are also multiple cleanups in preparation for internationalization. Alongside this, improvements to ipv6 support, a new length function compatible with Puppet 4, and an update to path types. Also contains multiple bug fixes around functionality and tests.
332 - Addition of coverage in all unit tests for functions, data and resource types for UTF8 for i18n.
333 - All strings within the readme and functions that are split over two lines have been combined in preparation for i18n parser/decorator.
334 - Improvement on the ipv6 support for type - Improves regex to catch some valid (but lesser known) ipv6 strings, mostly those which are a mix of ipv6 strings and embedded ipv6 numbers.
335 - Adds a new parameter `encoding` to allow non UTF-8 files to specify a file encoding. This prevents receiving the error message "invalid byte sequence in UTF-8" when special characters that are not UTF-8 encoded appear in the input stream, such as the copyright symbol.
336 - Addition of the new length function. Returns the length of a given string, array or hash. To eventually replace the deprecated size() function as can handle the new type functionality introduced in Puppet 4.
337 - Permit double slash in absolute/Unix path types.
340 - Fix unsupported data type error with rspec-puppet master.
341 - Now allows test module metadata.json to be read by Puppet.
342 - Fix acceptance test failure "Hiera is not a class".
343 - Removal of unsupported platforms and future parser setting in acceptance tests.
344 - Regex for tuple checking has been loosened.
345 - Ensure_packages function - Now only tries to apply the resource if not defined.
346 - (MODULES-4528) Use versioncmp to check Puppet version for 4.10.x compat.
347 - Adds comments to warn for UTF8 incompatibility of the functions that may not be compatible with UTF8 with Ruby < 2.4.0.
349 ## Supported Release 4.15.0
352 This release introduces multiple new functions, a new fact and the addition of Ubuntu Xenial support. Also includes a bugfix and documentation update.
355 - Addition of puppet_server fact to return agents server.
356 - Addition of a pry function.
357 - Addition of tests for ensure_resources.
358 - Addition of FQDN UUID generation function.
359 - Addition of Ubuntu Xenial to OS Support.
362 - Ensure_packages now works with Ruby < 2.0.
363 - Updated the documentation of str2bool function.
365 ## Supported Release 4.14.0
368 Adds several new features and updates, especially around refining the deprecation and validate_legacy functions. Also includes a Gemfile update around an issue with parallel_tests dependancy for different versions of Ruby.
371 - Deprecation function now uses puppet stacktrace if available.
372 - join_key_to_values function now handles array values. If values are arrays, multiple keys are added for each element.
373 - Updated Gemfile to deal with parallel_tests Ruby dependancy (MODULES-3983).
374 - Updated/Fixed ipv4 regex validator (MODULES-3980).
375 - Deprecation clarification added to README.
379 - Use .dup to duplicate classes for modification (MODULES-3829).
380 - Fixes spec failures that were caused by a change in the tested error message in validate_legacy_spec.
381 - Broken link to validate_legacy docs fixed.
382 - Updates deprecation tests to include future parser.
384 ## Supported Release 4.13.1
387 This bugfix release addresses the `undefined method 'optional_repeated_param'` error messages seen by users of puppet 3.7.
389 It also improves the user experience around function deprecations by emitting one warning per function(-name) instead of only one deprecation overall. This allows users to identify all deprecated functions used in one agent run, with less back-and-forth.
393 * Emit deprecations warnings for each function, instead of once per process. (MODULES-3961)
394 * Use a universally available API for the v4 deprecation stubs of `is_*` and `validate_*`. (MODULES-3962)
395 * Make `getvar()` compatible to ruby 1.8.7. (MODULES-3969)
396 * Add v4 deprecation stubs for the `is_` counterparts of the deprecated functions to emit the deprecations warnings in all cases.
399 ## Supported Release 4.13.0
402 This version of stdlib deprecates a whole host of functions, and provides stepping stones to move to Puppet 4 type validations. Be sure to check out the new `deprecation()` and `validate_legacy()` functions to migrate off the deprecated v3-style data validations.
404 Many thanks to all community contributors: bob, Dmitry Ilyin, Dominic Cleal, Joris, Joseph Yaworski, Loic Antoine-Gombeaud, Maksym Melnychok, Michiel Brandenburg, Nate Potter, Romain Tartière, Stephen Benjamin, and Steve Moore, as well as anyone contributing in the code review process and by submitting issues.
406 Special thanks to [Voxpupuli's](https://voxpupuli.org/) Igor Galić for donating the puppet-tea types to kickstart this part of stdlib.
410 * `validate_absolute_path`, `validate_array`, `validate_bool`, `validate_hash`, `validate_integer`, `validate_ip_address`, `validate_ipv4_address`, `validate_ipv6_address`, `validate_numeric`, `validate_re`, `validate_slength`, `validate_string`, and their `is_` counter parts are now deprecated on Puppet 4. See the `validate_legacy()` description in the README for help on migrating away from those functions.
411 * The `dig` function is provided by core puppet since 4.5.0 with slightly different calling convention. The stdlib version can still be accessed as `dig44` for now.
415 * Add Puppet 4 data types for Unix, and Windows paths, and URLs.
416 * Add `deprecation` function to warn users of functionality that will be removed soon.
417 * Add `validate_legacy` function to help with migrating to Puppet 4 data types.
419 * Add `any2bool` function, a combination of of `string2bool` and `num2bool`.
420 * Add `delete_regex` function to delete array elements matching a regular expression.
421 * Add `puppet_environmentpath` fact to expose the `environmentpath` setting.
422 * Add `regexpescape` function to safely insert arbitrary strings into regular expressions.
423 * Add `shell_escape`, `shell_join`, and `shell_split` functions for safer working with shell scripts..
425 * The `delete` function now also accepts regular expressions as search term.
426 * The `loadyaml` function now accepts a default value, which is returned when there is an error loading the file.
429 * Fix `file_line.match_for_absence` implementation and description to actually work. (MODULES-3590)
430 * Fix `getparam` so that it can now also return `false`. (MODULES-3933)
431 * Fix the fixture setup for testing and adjust `load_module_metadata` and `loadjson` tests.
432 * Fix `defined_with_params` to handle `undef` correctly on all puppet versions. (PUP-6422, MODULES-3543)
433 * Fix `file_line.path` validation to use puppet's built in `absolute_path?` matcher.
435 #### Minor Improvements
436 * README changes: improved descriptions of `deep_merge`, `delete`, `ensure_packages`, `file_line.after`, `range`, and `validate_numeric`.
437 * The `getvar` function now returns nil in all situations where the variable is not found.
438 * Update the `dig44` function with better `undef`, `nil`, and `false` handling.
439 * Better wording on `str2bool` argument validation error message.
443 * The `validate_legacy` function relies on internal APIs from Puppet 4.4.0 (PE 2016.1) onwards, and doesn't work on earlier versions.
444 * Puppet 4.5.0 (PE 2016.2) has a number of improvements around data types - especially error handling - that make working with them much nicer.
446 ## Supported Release 4.12.0
449 This release provides several new functions, bugfixes, modulesync changes, and some documentation updates.
452 - Adds `clamp`. This function keeps values within a specified range.
453 - Adds `validate_x509_rsa_key_pair`. This function validates an x509 RSA certificate and key pair.
454 - Adds `dig`. This function performs a deep lookup in nested hashes or arrays.
455 - Extends the `base64` support to fit `rfc2045` and `rfc4648`.
456 - Adds `is_ipv6_address` and `is_ipv4_address`. These functions validate the specified ipv4 or ipv6 addresses.
457 - Adds `enclose_ipv6`. This function encloses IPv6 addresses in square brackets.
458 - Adds `ensure_resources`. This function takes a list of resources and creates them if they do not exist.
459 - Extends `suffix` to support applying a suffix to keys in a hash.
460 - Apply modulesync changes.
461 - Add validate_email_address function.
464 - Fixes `fqdn_rand_string` tests, since Puppet 4.4.0 and later have a higher `fqdn_rand` ceiling.
465 - (MODULES-3152) Adds a check to `package_provider` to prevent failures if Gem is not installed.
466 - Fixes to README.md.
467 - Fixes catch StandardError rather than the gratuitous Exception
468 - Fixes file_line attribute validation.
469 - Fixes concat with Hash arguments.
471 ## Supported Release 4.11.0
474 Provides a validate_absolute_paths and Debian 8 support. There is a fix to the is_package_provider fact and a test improvement.
477 - Adds new parser called is_absolute_path
481 - Allow package_provider fact to resolve on PE 3.x
484 - ensures that the test passes independently of changes to rubygems for ensure_resource
486 ## 2015-12-15 - Supported Release 4.10.0
489 Includes the addition of several new functions and considerable improvements to the existing functions, tests and documentation. Includes some bug fixes which includes compatibility, test and fact issues.
492 - Adds service_provider fact
493 - Adds is_a() function
494 - Adds package_provider fact
495 - Adds validate_ip_address function
496 - Adds seeded_rand function
499 - Fix backwards compatibility from an improvement to the parseyaml function
500 - Renaming of load_module_metadata test to include _spec.rb
501 - Fix root_home fact on AIX 5.x, now '-c' rather than '-C'
502 - Fixed Gemfile to work with ruby 1.8.7
505 - (MODULES-2462) Improvement of parseyaml function
506 - Improvement of str2bool function
507 - Improvement to readme
508 - Improvement of intersection function
509 - Improvement of validate_re function
510 - Improved speed on Facter resolution of service_provider
511 - empty function now handles numeric values
512 - Package_provider now prevents deprecation warning about the allow_virtual parameter
513 - load_module_metadata now succeeds on empty file
514 - Check added to ensure puppetversion value is not nil
515 - Improvement to bool2str to return a string of choice using boolean
516 - Improvement to naming convention in validate_ipv4_address function
518 ## Supported Release 4.9.1
521 Small release for support of newer PE versions. This increments the version of PE in the metadata.json file.
523 ## 2015-09-08 - Supported Release 4.9.0
526 This release adds new features including the new functions dos2unix, unix2dos, try_get_value, convert_base as well as other features and improvements.
529 - (MODULES-2370) allow `match` parameter to influence `ensure => absent` behavior
530 - (MODULES-2410) Add new functions dos2unix and unix2dos
531 - (MODULE-2456) Modify union to accept more than two arrays
532 - Adds a convert_base function, which can convert numbers between bases
533 - Add a new function "try_get_value"
539 - (MODULES-2478) Support root_home fact on AIX through "lsuser" command
540 - Acceptance test improvements
541 - Unit test improvements
542 - Readme improvements
544 ## 2015-08-10 - Supported Release 4.8.0
546 This release adds a function for reading metadata.json from any module, and expands file\_line's abilities.
549 - New parameter `replace` on `file_line`
550 - New function `load_module_metadata()` to load metadata.json and return the content as a hash.
551 - Added hash support to `size()`
554 - Fix various docs typos
555 - Fix `file_line` resource on puppet < 3.3
557 ## 2015-06-22 - Supported Release 4.7.0
560 Adds Solaris 12 support along with improved Puppet 4 support. There are significant test improvements, and some minor fixes.
563 - Add support for Solaris 12
566 - Fix for AIO Puppet 4
567 - Fix time for ruby 1.8.7
568 - Specify rspec-puppet version
569 - range() fix for typeerror and missing functionality
570 - Fix pw_hash() on JRuby < 1.7.17
571 - fqdn_rand_string: fix argument error message
572 - catch and rescue from looking up non-existent facts
573 - Use puppet_install_helper, for Puppet 4
576 - Enforce support for Puppet 4 testing
577 - fqdn_rotate/fqdn_rand_string acceptance tests and implementation
578 - Simplify mac address regex
579 - validate_integer, validate_numeric: explicitely reject hashes in arrays
581 - Remove all the pops stuff for rspec-puppet
582 - Sync via modulesync
583 - Add validate_slength optional 3rd arg
584 - Move tests directory to examples directory
586 ## 2015-04-14 - Supported Release 4.6.0
589 Adds functions and function argument abilities, and improves compatibility with the new puppet parser
592 - MODULES-444: `concat()` can now take more than two arrays
593 - `basename()` added to have Ruby File.basename functionality
594 - `delete()` can now take an array of items to remove
595 - `prefix()` can now take a hash
596 - `upcase()` can now take a hash or array of upcaseable things
597 - `validate_absolute_path()` can now take an array
598 - `validate_cmd()` can now use % in the command to embed the validation file argument in the string
599 - MODULES-1473: deprecate `type()` function in favor of `type3x()`
600 - MODULES-1473: Add `type_of()` to give better type information on future parser
601 - Deprecate `private()` for `assert_private()` due to future parser
602 - Adds `ceiling()` to take the ceiling of a number
603 - Adds `fqdn_rand_string()` to generate random string based on fqdn
604 - Adds `pw_hash()` to generate password hashes
605 - Adds `validate_integer()`
606 - Adds `validate_numeric()` (like `validate_integer()` but also accepts floats)
609 - Fix seeding of `fqdn_rotate()`
610 - `ensure_resource()` is more verbose on debug mode
611 - Stricter argument checking for `dirname()`
612 - Fix `is_domain_name()` to better match RFC
613 - Fix `uriescape()` when called with array
614 - Fix `file_line` resource when using the `after` attribute with `match`
616 ## 2015-01-14 - Supported Release 4.5.1
619 This release changes the temporary facter_dot_d cache locations outside of the /tmp directory due to a possible security vunerability. CVE-2015-1029
622 - Facter_dot_d cache will now be stored in puppet libdir instead of tmp
624 ## 2014-12-15 - Supported Release 4.5.0
627 This release improves functionality of the member function and adds improved future parser support.
630 - MODULES-1329: Update member() to allow the variable to be an array.
631 - Sync .travis.yml, Gemfile, Rakefile, and CONTRIBUTING.md via modulesync
634 - Fix range() to work with numeric ranges with the future parser
635 - Accurately express SLES support in metadata.json (was missing 10SP4 and 12)
636 - Don't require `line` to match the `match` parameter
638 ## 2014-11-10 - Supported Release 4.4.0
640 This release has an overhauled readme, new private manifest function, and fixes many future parser bugs.
643 - All new shiny README
644 - New `private()` function for making private manifests (yay!)
647 - Code reuse in `bool2num()` and `zip()`
648 - Fix many functions to handle `generate()` no longer returning a string on new puppets
649 - `concat()` no longer modifies the first argument (whoops)
650 - strict variable support for `getvar()`, `member()`, `values_at`, and `has_interface_with()`
651 - `to_bytes()` handles PB and EB now
652 - Fix `tempfile` ruby requirement for `validate_augeas()` and `validate_cmd()`
653 - Fix `validate_cmd()` for windows
654 - Correct `validate_string()` docs to reflect non-handling of `undef`
655 - Fix `file_line` matching on older rubies
658 ## 2014-07-15 - Supported Release 4.3.2
661 This release merely updates metadata.json so the module can be uninstalled and
662 upgraded via the puppet module command.
664 ## 2014-07-14 - Supported Release 4.3.1
666 This supported release updates the metadata.json to work around upgrade behavior of the PMT.
669 - Synchronize metadata.json with PMT-generated metadata to pass checksums
671 ## 2014-06-27 - Supported Release 4.3.0
673 This release is the first supported release of the stdlib 4 series. It remains
674 backwards-compatible with the stdlib 3 series. It adds two new functions, one bugfix, and many testing updates.
677 - New `bool2str()` function
678 - New `camelcase()` function
681 - Fix `has_interface_with()` when interfaces fact is nil
683 ## 2014-06-04 - Release 4.2.2
686 This release adds PE3.3 support in the metadata and fixes a few tests.
688 ## 2014-05-08 - Release - 4.2.1
690 This release moves a stray symlink that can cause problems.
692 ## 2014-05-08 - Release - 4.2.0
694 This release adds many new functions and fixes, and continues to be backwards compatible with stdlib 3.x
697 - New `base64()` function
698 - New `deep_merge()` function
699 - New `delete_undef_values()` function
700 - New `delete_values()` function
701 - New `difference()` function
702 - New `intersection()` function
703 - New `is_bool()` function
704 - New `pick_default()` function
705 - New `union()` function
706 - New `validate_ipv4_address` function
707 - New `validate_ipv6_address` function
708 - Update `ensure_packages()` to take an option hash as a second parameter.
709 - Update `range()` to take an optional third argument for range step
710 - Update `validate_slength()` to take an optional third argument for minimum length
711 - Update `file_line` resource to take `after` and `multiple` attributes
714 - Correct `is_string`, `is_domain_name`, `is_array`, `is_float`, and `is_function_available` for parsing odd types such as bools and hashes.
715 - Allow facts.d facts to contain `=` in the value
716 - Fix `root_home` fact on darwin systems
717 - Fix `concat()` to work with a second non-array argument
718 - Fix `floor()` to work with integer strings
719 - Fix `is_integer()` to return true if passed integer strings
720 - Fix `is_numeric()` to return true if passed integer strings
721 - Fix `merge()` to work with empty strings
722 - Fix `pick()` to raise the correct error type
723 - Fix `uriescape()` to use the default URI.escape list
724 - Add/update unit & acceptance tests.
727 ## 2014-03-04 - Supported Release - 3.2.1
729 This is a supported release
732 - Fixed `is_integer`/`is_float`/`is_numeric` for checking the value of arithmatic expressions.
739 ##### 2013-05-06 - Jeff McCune <jeff@puppetlabs.com> - 4.1.0
741 * (#20582) Restore facter\_dot\_d to stdlib for PE users (3b887c8)
742 * (maint) Update Gemfile with GEM\_FACTER\_VERSION (f44d535)
744 ##### 2013-05-06 - Alex Cline <acline@us.ibm.com> - 4.1.0
746 * Terser method of string to array conversion courtesy of ethooz. (d38bce0)
748 ##### 2013-05-06 - Alex Cline <acline@us.ibm.com> 4.1.0
750 * Refactor ensure\_resource expectations (b33cc24)
752 ##### 2013-05-06 - Alex Cline <acline@us.ibm.com> 4.1.0
754 * Changed str-to-array conversion and removed abbreviation. (de253db)
756 ##### 2013-05-03 - Alex Cline <acline@us.ibm.com> 4.1.0
758 * (#20548) Allow an array of resource titles to be passed into the ensure\_resource function (e08734a)
760 ##### 2013-05-02 - Raphaël Pinson <raphael.pinson@camptocamp.com> - 4.1.0
762 * Add a dirname function (2ba9e47)
764 ##### 2013-04-29 - Mark Smith-Guerrero <msmithgu@gmail.com> - 4.1.0
766 * (maint) Fix a small typo in hash() description (928036a)
768 ##### 2013-04-12 - Jeff McCune <jeff@puppetlabs.com> - 4.0.2
770 * Update user information in gemspec to make the intent of the Gem clear.
772 ##### 2013-04-11 - Jeff McCune <jeff@puppetlabs.com> - 4.0.1
774 * Fix README function documentation (ab3e30c)
776 ##### 2013-04-11 - Jeff McCune <jeff@puppetlabs.com> - 4.0.0
778 * stdlib 4.0 drops support with Puppet 2.7
779 * stdlib 4.0 preserves support with Puppet 3
781 ##### 2013-04-11 - Jeff McCune <jeff@puppetlabs.com> - 4.0.0
783 * Add ability to use puppet from git via bundler (9c5805f)
785 ##### 2013-04-10 - Jeff McCune <jeff@puppetlabs.com> - 4.0.0
787 * (maint) Make stdlib usable as a Ruby GEM (e81a45e)
789 ##### 2013-04-10 - Erik Dalén <dalen@spotify.com> - 4.0.0
791 * Add a count function (f28550e)
793 ##### 2013-03-31 - Amos Shapira <ashapira@atlassian.com> - 4.0.0
795 * (#19998) Implement any2array (7a2fb80)
797 ##### 2013-03-29 - Steve Huff <shuff@vecna.org> - 4.0.0
799 * (19864) num2bool match fix (8d217f0)
801 ##### 2013-03-20 - Erik Dalén <dalen@spotify.com> - 4.0.0
803 * Allow comparisons of Numeric and number as String (ff5dd5d)
805 ##### 2013-03-26 - Richard Soderberg <rsoderberg@mozilla.com> - 4.0.0
807 * add suffix function to accompany the prefix function (88a93ac)
809 ##### 2013-03-19 - Kristof Willaert <kristof.willaert@gmail.com> - 4.0.0
811 * Add floor function implementation and unit tests (0527341)
813 ##### 2012-04-03 - Eric Shamow <eric@puppetlabs.com> - 4.0.0
815 * (#13610) Add is\_function\_available to stdlib (961dcab)
817 ##### 2012-12-17 - Justin Lambert <jlambert@eml.cc> - 4.0.0
819 * str2bool should return a boolean if called with a boolean (5d5a4d4)
821 ##### 2012-10-23 - Uwe Stuehler <ustuehler@team.mobile.de> - 4.0.0
823 * Fix number of arguments check in flatten() (e80207b)
825 ##### 2013-03-11 - Jeff McCune <jeff@puppetlabs.com> - 4.0.0
827 * Add contributing document (96e19d0)
829 ##### 2013-03-04 - Raphaël Pinson <raphael.pinson@camptocamp.com> - 4.0.0
831 * Add missing documentation for validate\_augeas and validate\_cmd to README.markdown (a1510a1)
833 ##### 2013-02-14 - Joshua Hoblitt <jhoblitt@cpan.org> - 4.0.0
835 * (#19272) Add has\_element() function (95cf3fe)
837 ##### 2013-02-07 - Raphaël Pinson <raphael.pinson@camptocamp.com> - 4.0.0
839 * validate\_cmd(): Use Puppet::Util::Execution.execute when available (69248df)
841 ##### 2012-12-06 - Raphaël Pinson <raphink@gmail.com> - 4.0.0
843 * Add validate\_augeas function (3a97c23)
845 ##### 2012-12-06 - Raphaël Pinson <raphink@gmail.com> - 4.0.0
847 * Add validate\_cmd function (6902cc5)
849 ##### 2013-01-14 - David Schmitt <david@dasz.at> - 4.0.0
851 * Add geppetto project definition (b3fc0a3)
853 ##### 2013-01-02 - Jaka Hudoklin <jakahudoklin@gmail.com> - 4.0.0
855 * Add getparam function to get defined resource parameters (20e0e07)
857 ##### 2013-01-05 - Jeff McCune <jeff@puppetlabs.com> - 4.0.0
859 * (maint) Add Travis CI Support (d082046)
861 ##### 2012-12-04 - Jeff McCune <jeff@puppetlabs.com> - 4.0.0
863 * Clarify that stdlib 3 supports Puppet 3 (3a6085f)
865 ##### 2012-11-30 - Erik Dalén <dalen@spotify.com> - 4.0.0
867 * maint: style guideline fixes (7742e5f)
869 ##### 2012-11-09 - James Fryman <james@frymanet.com> - 4.0.0
871 * puppet-lint cleanup (88acc52)
873 ##### 2012-11-06 - Joe Julian <me@joejulian.name> - 4.0.0
875 * Add function, uriescape, to URI.escape strings. Redmine #17459 (fd52b8d)
877 ##### 2012-09-18 - Chad Metcalf <chad@wibidata.com> - 3.2.0
879 * Add an ensure\_packages function. (8a8c09e)
881 ##### 2012-11-23 - Erik Dalén <dalen@spotify.com> - 3.2.0
883 * (#17797) min() and max() functions (9954133)
885 ##### 2012-05-23 - Peter Meier <peter.meier@immerda.ch> - 3.2.0
887 * (#14670) autorequire a file\_line resource's path (dfcee63)
889 ##### 2012-11-19 - Joshua Harlan Lifton <lifton@puppetlabs.com> - 3.2.0
891 * Add join\_keys\_to\_values function (ee0f2b3)
893 ##### 2012-11-17 - Joshua Harlan Lifton <lifton@puppetlabs.com> - 3.2.0
895 * Extend delete function for strings and hashes (7322e4d)
897 ##### 2012-08-03 - Gary Larizza <gary@puppetlabs.com> - 3.2.0
899 * Add the pick() function (ba6dd13)
901 ##### 2012-03-20 - Wil Cooley <wcooley@pdx.edu> - 3.2.0
903 * (#13974) Add predicate functions for interface facts (f819417)
905 ##### 2012-11-06 - Joe Julian <me@joejulian.name> - 3.2.0
907 * Add function, uriescape, to URI.escape strings. Redmine #17459 (70f4a0e)
909 ##### 2012-10-25 - Jeff McCune <jeff@puppetlabs.com> - 3.1.1
911 * (maint) Fix spec failures resulting from Facter API changes (97f836f)
913 ##### 2012-10-23 - Matthaus Owens <matthaus@puppetlabs.com> - 3.1.0
915 * Add PE facts to stdlib (cdf3b05)
917 ##### 2012-08-16 - Jeff McCune <jeff@puppetlabs.com> - 3.0.1
919 * Fix accidental removal of facts\_dot\_d.rb in 3.0.0 release
921 ##### 2012-08-16 - Jeff McCune <jeff@puppetlabs.com> - 3.0.0
923 * stdlib 3.0 drops support with Puppet 2.6
924 * stdlib 3.0 preserves support with Puppet 2.7
926 ##### 2012-08-07 - Dan Bode <dan@puppetlabs.com> - 3.0.0
928 * Add function ensure\_resource and defined\_with\_params (ba789de)
930 ##### 2012-07-10 - Hailee Kenney <hailee@puppetlabs.com> - 3.0.0
932 * (#2157) Remove facter\_dot\_d for compatibility with external facts (f92574f)
934 ##### 2012-04-10 - Chris Price <chris@puppetlabs.com> - 3.0.0
936 * (#13693) moving logic from local spec\_helper to puppetlabs\_spec\_helper (85f96df)
938 ##### 2012-10-25 - Jeff McCune <jeff@puppetlabs.com> - 2.5.1
940 * (maint) Fix spec failures resulting from Facter API changes (97f836f)
942 ##### 2012-10-23 - Matthaus Owens <matthaus@puppetlabs.com> - 2.5.0
944 * Add PE facts to stdlib (cdf3b05)
946 ##### 2012-08-15 - Dan Bode <dan@puppetlabs.com> - 2.5.0
948 * Explicitly load functions used by ensure\_resource (9fc3063)
950 ##### 2012-08-13 - Dan Bode <dan@puppetlabs.com> - 2.5.0
952 * Add better docs about duplicate resource failures (97d327a)
954 ##### 2012-08-13 - Dan Bode <dan@puppetlabs.com> - 2.5.0
956 * Handle undef for parameter argument (4f8b133)
958 ##### 2012-08-07 - Dan Bode <dan@puppetlabs.com> - 2.5.0
960 * Add function ensure\_resource and defined\_with\_params (a0cb8cd)
962 ##### 2012-08-20 - Jeff McCune <jeff@puppetlabs.com> - 2.5.0
964 * Disable tests that fail on 2.6.x due to #15912 (c81496e)
966 ##### 2012-08-20 - Jeff McCune <jeff@puppetlabs.com> - 2.5.0
968 * (Maint) Fix mis-use of rvalue functions as statements (4492913)
970 ##### 2012-08-20 - Jeff McCune <jeff@puppetlabs.com> - 2.5.0
972 * Add .rspec file to repo root (88789e8)
974 ##### 2012-06-07 - Chris Price <chris@puppetlabs.com> - 2.4.0
976 * Add support for a 'match' parameter to file\_line (a06c0d8)
978 ##### 2012-08-07 - Erik Dalén <dalen@spotify.com> - 2.4.0
980 * (#15872) Add to\_bytes function (247b69c)
982 ##### 2012-07-19 - Jeff McCune <jeff@puppetlabs.com> - 2.4.0
984 * (Maint) use PuppetlabsSpec::PuppetInternals.scope (master) (deafe88)
986 ##### 2012-07-10 - Hailee Kenney <hailee@puppetlabs.com> - 2.4.0
988 * (#2157) Make facts\_dot\_d compatible with external facts (5fb0ddc)
990 ##### 2012-03-16 - Steve Traylen <steve.traylen@cern.ch> - 2.4.0
992 * (#13205) Rotate array/string randomley based on fqdn, fqdn\_rotate() (fef247b)
994 ##### 2012-05-22 - Peter Meier <peter.meier@immerda.ch> - 2.3.3
996 * fix regression in #11017 properly (f0a62c7)
998 ##### 2012-05-10 - Jeff McCune <jeff@puppetlabs.com> - 2.3.3
1000 * Fix spec tests using the new spec\_helper (7d34333)
1002 ##### 2012-05-10 - Puppet Labs <support@puppetlabs.com> - 2.3.2
1004 * Make file\_line default to ensure => present (1373e70)
1005 * Memoize file\_line spec instance variables (20aacc5)
1006 * Fix spec tests using the new spec\_helper (1ebfa5d)
1007 * (#13595) initialize\_everything\_for\_tests couples modules Puppet ver (3222f35)
1008 * (#13439) Fix MRI 1.9 issue with spec\_helper (15c5fd1)
1009 * (#13439) Fix test failures with Puppet 2.6.x (665610b)
1010 * (#13439) refactor spec helper for compatibility with both puppet 2.7 and master (82194ca)
1011 * (#13494) Specify the behavior of zero padded strings (61891bb)
1013 ##### 2012-03-29 Puppet Labs <support@puppetlabs.com> - 2.1.3
1015 * (#11607) Add Rakefile to enable spec testing
1016 * (#12377) Avoid infinite loop when retrying require json
1018 ##### 2012-03-13 Puppet Labs <support@puppetlabs.com> - 2.3.1
1020 * (#13091) Fix LoadError bug with puppet apply and puppet\_vardir fact
1022 ##### 2012-03-12 Puppet Labs <support@puppetlabs.com> - 2.3.0
1024 * Add a large number of new Puppet functions
1025 * Backwards compatibility preserved with 2.2.x
1027 ##### 2011-12-30 Puppet Labs <support@puppetlabs.com> - 2.2.1
1029 * Documentation only release for the Forge
1031 ##### 2011-12-30 Puppet Labs <support@puppetlabs.com> - 2.1.2
1033 * Documentation only release for PE 2.0.x
1035 ##### 2011-11-08 Puppet Labs <support@puppetlabs.com> - 2.2.0
1037 * #10285 - Refactor json to use pson instead.
1038 * Maint - Add watchr autotest script
1039 * Maint - Make rspec tests work with Puppet 2.6.4
1040 * #9859 - Add root\_home fact and tests
1042 ##### 2011-08-18 Puppet Labs <support@puppetlabs.com> - 2.1.1
1044 * Change facts.d paths to match Facter 2.0 paths.
1045 * /etc/facter/facts.d
1046 * /etc/puppetlabs/facter/facts.d
1048 ##### 2011-08-17 Puppet Labs <support@puppetlabs.com> - 2.1.0
1050 * Add R.I. Pienaar's facts.d custom facter fact
1051 * facts defined in /etc/facts.d and /etc/puppetlabs/facts.d are
1052 automatically loaded now.
1054 ##### 2011-08-04 Puppet Labs <support@puppetlabs.com> - 2.0.0
1056 * Rename whole\_line to file\_line
1057 * This is an API change and as such motivating a 2.0.0 release according to semver.org.
1059 ##### 2011-08-04 Puppet Labs <support@puppetlabs.com> - 1.1.0
1061 * Rename append\_line to whole\_line
1062 * This is an API change and as such motivating a 1.1.0 release.
1064 ##### 2011-08-04 Puppet Labs <support@puppetlabs.com> - 1.0.0
1066 * Initial stable release
1067 * Add validate\_array and validate\_string functions
1068 * Make merge() function work with Ruby 1.8.5
1069 * Add hash merging function
1070 * Add has\_key function
1071 * Add loadyaml() function
1072 * Add append\_line native
1074 ##### 2011-06-21 Jeff McCune <jeff@puppetlabs.com> - 0.1.7
1076 * Add validate\_hash() and getvar() functions
1078 ##### 2011-06-15 Jeff McCune <jeff@puppetlabs.com> - 0.1.6
1080 * Add anchor resource type to provide containment for composite classes
1082 ##### 2011-06-03 Jeff McCune <jeff@puppetlabs.com> - 0.1.5
1084 * Add validate\_bool() function to stdlib
1086 ##### 0.1.4 2011-05-26 Jeff McCune <jeff@puppetlabs.com>
1088 * Move most stages after main
1090 ##### 0.1.3 2011-05-25 Jeff McCune <jeff@puppetlabs.com>
1092 * Add validate\_re() function
1094 ##### 0.1.2 2011-05-24 Jeff McCune <jeff@puppetlabs.com>
1096 * Update to add annotated tag
1098 ##### 0.1.1 2011-05-24 Jeff McCune <jeff@puppetlabs.com>
1100 * Add stdlib::stages class with a standard set of stages