(maint) Fixes fqdn_rand_string tests

Puppet 4.4.0 and later has changed fqdn_rand to use a higher ceiling
(PUP-5646), the tests for fqdn_rand_string needed to be updated to
reflect the new expected output.

Merge pull request #577 from EmilienM/enclose_ipv6

Add enclose_ipv6 function

Add enclose_ipv6 function

Copy a function from puppetlabs/apache, created by Benedikt Bock by
55cc3b4e8f4bc859a1255cb57be2c7923005d822 .

This function enclose IPv6 addresses in square brackets.
It takes an array of ip addresses and encloses the ipv6 addresses with
square brackets.

Co-Authored-By: Benedikt Bock <benedikt_bock@web.de>

Merge pull request #570 from gfidente/master

Add is_ipv4_address and is_ipv6_address functions

Merge pull request #575 from guessi/extend_base64_function_support

Extend Base64() function support

Extend Base64() function support

Merge pull request #573 from Yelp/pl-dig

Add dig function

Merge pull request #574 from DavidS/fm-4046-update-msync

(FM-4046) Update to current msync configs [006831f]

(FM-4046) Update to current msync configs [006831f]

This moves all copyright statements to the NOTICE file in accordance with the ASFs guidelines on applying the Apache-2.0 license.

Add dig() function

Deprecates #try_get_value()

Merge pull request #569 from DavidS/fm-4049-update-msync

(FM-4049) update to modulesync_configs

(FM-4049) Update to current msync configs [2c99161]

Add is_ipv4_address and is_ipv6_address functions

These are useful when making decisions based on the type of IP
address received.

Merge pull request #568 from mattbostock/fix_docs

Fix reference to validate_bool in function

Fix reference to validate_bool in function

The documentation in `validate_ip_address` references `validate_bool`,
but I believe this should read `validate_ip_address` instead, which
makes more sense.

Looks like this was copied from `validate_ipv4_address`, which I fixed
in 7b068781.

Merge pull request #567 from alechenninger/add-test-for-basename-with-scheme

Add test for basename on path with scheme

Add test for basename on path with scheme

Merge pull request #566 from puppetlabs/4.11.x

4.11.0 merge back

Merge pull request #552 from mattbostock/add_x509_rsa_key_pair

Add a function to validate an x509 RSA key pair

Change order of tests to be more logical

Put the tests using a valid certificate fixture together and put tests
using a valid key fixture together.

Test certificate and key with a truncated middle

Test a valid certificate and valid key that have had 48 characters
removed from their middle, to simulate a malformed certificate and key.

Suggested by @DavidS in https://github.com/puppetlabs/puppetlabs-stdlib/pull/552

Add a function to validate an x509 RSA key pair

Add a function to validate an x509 RSA certificate and key pair, as
commonly used for TLS certificates.

The rationale behind this is that we store our TLS certificates and
private keys in Hiera YAML files, and poor indentation or formatting in
the YAML file could cause a valid certificate to be considered invalid.

Will cause the Puppet run to fail if:

- an invalid certificate is detected
- an invalid RSA key is detected
- the certificate does not match the key, i.e. the certificate
  has not been signed by the supplied key

The test certificates I've used in the spec tests were generated using
the Go standard library:

    $ go run $GOROOT/src/crypto/tls/generate_cert.go -host localhost

Example output:

    ==> cache-1.router: Error: Not a valid RSA key: Neither PUB key nor PRIV key:: nested asn1 error at /var/govuk/puppet/modules/nginx/manifests/config/ssl.pp:30 on node cache-1.router.dev.gov.uk

Merge pull request #565 from tphoney/4.11.0_tweak

minor tweak to 4.11.0 adding debian 8 to metadata

minor tweak to 4.11.0 adding debian 8 to metadata

Merge pull request #545 from mpolenchuk/master

Add clamp function

Merge pull request #564 from tphoney/4.11.0_prep

4.11.0 prep

Add clamp function

Clamp keeps value within the range.
Employ of soft() makes the whole thing is independant of order.

4.11.0 prep

Merge pull request #553 from logicminds/absolute_path

adds new parser called is_absolute_path

Merge pull request #561 from DavidS/fix-package_provider

Allow package_provider fact to resolve on PE 3.x

Allow package_provider fact to resolve on PE 3.x

PE 3.x emits a puppetversion fact in the format "3.x.x (Puppet Enterprise 3.x.x)". This fact causes an error when invoked on PE 3.x: Could not retrieve fact='package_provider', resolution='<anonymous>': Malformed version number string 3.8.1 (Puppet Enterprise 3.8.1

This fix has been tested on PE 3.8.2 and should work for PE 3.3, 3.7, and 3.8.

Original-fix-by: Alex Harden <aharden@gmail.com>

Merge pull request #559 from DavidS/fm-3802-fix-ensure_resource-test

(FM-3802) make ensure_resource test of packages

(FM-3802) make ensure_resource test of packages

This ensures that the test passes independently of changes to rubygems.

refactors the validate_absolute_path to utilize the is_absolute_path

adds new parser called is_absolute_path

  * is_absolute_path returns boolean true if the given path
    is absolute, returns false otherwise.
  * works for windows and unix

Merge pull request #558 from puppetlabs/4.10.x

4.10.x mergeback

Merge pull request #557 from jbondpdx/4.10.x

edits to README

more carriage returns

more carriage returns, no

removing mid-line carriage returns

edits to README

Merge pull request #556 from HelenCampbell/4.10.0_prep

Changelog and versionbump for 4.10.0

Changelog and versionbump for 4.10.0

Merge pull request #554 from kjetilho/ticket/2886-seeded_rand

(#2886) seeded_rand: new function

Merge pull request #555 from puppetlabs/4.9.x

4.9.x Mergeback

(#2886) seeded_rand: new function

seeded_rand is needed for repeatable randomness across nodes in a cluster

Merge pull request #546 from jdevesa/validate_ip

Add validator for any IP address

Add validator for any IP address

Provide a validator for IP addresses, regardless they are IPv4 or IPv6,
and its documentation.

Merge pull request #550 from tphoney/release_4.9.1

4.9.1 release prep

4.9.1 release prep

Merge pull request #551 from mattbostock/fix_ipv4_doc

Fix reference to validate_bool in IP4 function

Fix reference to validate_bool in IP4 function

The documentation in `validate_ipv4_address` references `validate_bool`,
but I believe this should read `validate_ipv4_address` instead, which
makes more sense.

Merge pull request #548 from bmjen/ruby187

Fix Gemfile to work with ruby 1.8.7

Fix Gemfile to work with ruby 1.8.7

Merge pull request #543 from ghoneycutt/patch-2

Use absolute class name in example

Merge pull request #547 from reidmv/fm_3773

(FM-3773) Fix root_home fact on AIX 5.x

(FM-3773) Fix root_home fact on AIX 5.x

The -C (capital C) flag to lsuser is incorrect. It should be -c
(lowercase).

this commit updates the aix root_home fact to use `lsuser -c`, rather
than `lsuser -C`.

Merge pull request #544 from HelenCampbell/readmeaddition

pick_default addition to readme

pick_default addition to readme

Use absolute class name in example

Merge pull request #542 from greg0ire/patch-1

use properly encoded characters

use properly encoded characters

This is more severe than it sounds. These characters make puppet fail with the following message :

> Error 400 on SERVER: "\xC3" on US-ASCII

Merge pull request #541 from mattflaschen/patch-1

Fix capitalize docs

Fix capitalize docs

Capitalize lower-cases the remaining characters (due to the Ruby function having this behavior); document this, and make minor wording tweaks.

Merge pull request #540 from marrero984/update_str2bool_readme

(#2183) updated str2bool readme wording

(#2183) updated str2bool readme wording

Merge pull request #538 from mmckinst/bool2str_enhance

add functionality to bool2str function

add functionality to bool2str to return strings of your choice for a boolean

Merge pull request #539 from mentat/MODULES-2696

Add check to ensure regex does not throw for none type.

Add check to ensure regex does not throw for none type.

Add a quick check to ensure puppetversion value is not nil and supporting test.

Merge pull request #537 from cmurphy/fix_load_module_metadata

Fix load module metadata

Let load_module_metadata succeed on empty file

Some modules or module versions don't have a metadata.json file, but we
might still want to use the load_module_metadata function on them. The
lack of a file can still give us important information. For example, it
might tell us that the version of the module installed is "very old"
even if we can't read the version number directly. This patch adds a
parameter to let the user specify if an empty file is acceptable. To
preserve backwards compatibility it does not change the current default
behavior, which is to raise an error if metadata.json does not exist.

Rename load_module_metadata test path

`rake spec` only finds test files that end in _spec.rb, so this test
was not being run. Correct the path name so that the test runs
properly.

Merge pull request #536 from DavidS/improve-file_line-docs

(MODULES-2421) improve description of file_line

(MODULES-2421) improve description of file_line

This mostly needed extraction of the existing doc strings from
the type.

Merge pull request #535 from martinpfeifer/package_provider_fact

prevent deprecation warning about the allow_virtual parameter

prevent deprecation warning about the allow_virtual parameter

Merge pull request #534 from asasfu/feature/package_provider_fact

Add package_provider fact

Merge pull request #533 from HelenCampbell/MODULES-2614-Improved

Modules 2614 improved numeric value handling on empty function

Added acceptance test and updated readme

Check for numeric values as empty fails on those

Merge pull request #532 from DavidS/fix-is_a-readme

(FM-3701) Update README for is_a

(FM-3701) Update README for is_a

Merge pull request #531 from asasfu/improvement/service_provider_fact

fixup-PR#506 Speed improvements in facter resolution

fixup-PR#506 Speed improvements in facter resolution

This is to improve speed on Facter resolution of service_provider fact
that was just introduced in PR# 506.  The improvements go from 280ms
resolution time approx. down to 2ms resolution time approx. by adding
requires statements.

Add package_provider fact

This adds a package_provider fact for situations where we need to be
able to know the client's package provider in a simple way.  Situations
such as: package { 'name': install_options => [] }  As those tend to be
package provider specific options.

Merge pull request #506 from binford2k/feature/service_provider_fact

Add a service_provider fact

Merge pull request #530 from HelenCampbell/MODULES-2614

Adding update to empty function readme

Adding update to empty function readme

Merge pull request #528 from mhaskel/is_a_fixes

Update is_a acceptance tests to only run on puppet4

Update is_a acceptance tests to only run on puppet4

Merge pull request #527 from mhaskel/511_compatibility

Fix backwards compatibility from #511

Fix backwards compatibility from #511

Maintain the old behavior in the case where the optional second
parameter isn't passed. Also, adding arity is backwards incompatible since
stdlib still supports 2.7, so remove that.

Merge pull request #526 from DavidS/improve-validate_re-docs

(MAINT) validate_re: Clarify docs and error message

(MAINT) validate_re: Clarify docs and error message

Merge pull request #524 from binford2k/docs/intersection_truthiness

Clarify what an empty intersection looks like.

Clarify what an empty intersection looks like.

Merge pull request #523 from DavidS/modules-2516-is_a

(MODULES-2561) add is_a function

Merge pull request #511 from dmitryilyin/parseyaml_default

[MODULES-2462] Improve parseyaml function

(MODULES-2516) Adds an is_a() function

The data type system is very hard to understand. Many people don't
understand why

    type_of([1,2,3]) == Array

will fail, but

    type_of([1,2,3]) <= Array

passes. This does a simpler validation that doesn't rely on explicit
data types. Instead, use

    $foo = [1,2,3]
    if $foo.is_a(Array) {
      notify { 'This is an array': }
    }

This is based on code by Ben Ford <ben.ford@puppetlabs.com>.

  * Added acceptance tests
  * Added dispatch
  * Improved unit tests
  * Added docs to README