<commit_before>puppet_functions
================

This module contains custom functions for puppet in addition to the stdlib functions.

# Compatibility #

The puppet_functions module has only been tested against puppet 3.3.2.

# Functions #

create_path
---
Takes a string containing a fully qualified path and ensures that the
directory specified **and** all parent directories exist.  Any special
permissions and/or attributes may be specified in an override.

This example creates '/tmp/create_path/testing123' and ensures that the
'/tmp/create_path' directory is owned by the 'puppet' user:

    create_path('/tmp/create_path/testing123')

    File['/tmp/create_path'] {
      owner => 'puppet',
    }

- *Type*: rvalue

As an aside, the "official" way in Puppet to ensure a directory and all it's 
parents are created is to create an array of parents and the final directory 
and pass that to the File resource type.
            
  example ('official' method):<commit_msg>update readme to account for function rename<commit_after>puppet_functions
================

This module contains custom functions for puppet in addition to the stdlib functions.

# Compatibility #

The puppet_functions module has only been tested against puppet 3.3.2.

# Functions #

ensure_path
---
Takes a string containing a fully qualified path and ensures that the
directory specified **and** all parent directories exist.  Any special
permissions and/or attributes may be specified in an override.

This example creates '/tmp/ensure_path/testing123' and ensures that the
'/tmp/ensure_path' directory is owned by the 'puppet' user:

    ensure_path('/tmp/ensure_path/testing123')

    File['/tmp/ensure_path'] {
      owner => 'puppet',
    }

- *Type*: rvalue

As an aside, the "official" way in Puppet to ensure a directory and all it's 
parents are created is to create an array of parents and the final directory 
and pass that to the File resource type.
            
  example ('official' method):
{'fraction_non_alphanumeric': 0.08354302969300453, 'fraction_numerical': 0.009058882737795673, 'mean_word_length': 3.982456140350877, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3413237', 'n_tokens_mistral': 557, 'n_tokens_neox': 523, 'n_words': 243}