simpcat

Builds files from fragments

Module Stats

12,375 downloads

6,197 latest version

5.0 quality score

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

released Mar 18th 2019

This version is compatible with:

Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
Puppet >= 4.7.0 < 6.0.0
, ,

Start using this module

Installation method

Add this module to your Puppetfile:

mod 'simp-simpcat', '6.0.3'

Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add simp-simpcat

Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install simp-simpcat --version 6.0.3

Tags: concat, simp

Documentation

simp/simpcat — version 6.0.3 Mar 18th 2019

This is a SIMP module

This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.

If you find any issues, they can be submitted to our JIRA.

Please read our Contribution Guide.

Work in Progress

Please excuse us as we transition this code into the public domain.

Downloads, discussion, and patches are still welcome!

Types in this module release

simpcat_build

Build file from SIMP concat fragments

Parameters
clean_comments	If a line begins with the specified string it will not be printed in the output file.
clean_whitespace	Cleans whitespace. Can be passed an array. 'lines' will cause the output to not contain any blank lines. 'all' is equivalent to [leading, trailing, lines]
file_delimiter	Acts as the delimiter between concatenated file fragments. For instance, if you have two files with contents 'foo' and 'bar', the result with a file_delimiter of ':' will be a file containing 'foo:bar'.
name
onlyif	Copy file to target only if this command exits with status '0'
parent_build	Specify the parent to this build step. Only needed for multiple staged builds. Can be an array. It does not make sense to specify a parent build without setting the target to the parent's fragment directory.
provider
quiet	Suppress errors when no fragments exist for build
sort	Sort the built file. This tries to sort in a human fashion with 1 < 2 < 10 < 20 < a, etc.. sort. Note that this will need to read the entire file into memory `Example Sort: ['a','1','b','10','2','20','Z','A'] translates to ['1','2','10','20','a','A','b','Z'] Note: If you use a file delimiter with this, it will not be sorted!`
squeeze_blank	Never output more than one blank line
target	Fully qualified path to copy output file to
unique	Only print unique lines to the output file. Sort takes precedence. This does not affect file delimiters. `true: Uses Ruby's Array.uniq function. It will remove all duplicates regardless of where they are in the file. uniq: Acts like the uniq command found in GNU coreutils and only removes consecutive duplicates.`

Properties
order	Array containing ordering info for build

Providers
simpcat_build	simpcat_build provider

simpcat_fragment

Create a SIMP concat fragment

Parameters
externally_managed	Set to 'true' if you have something else managing the content of this file. The file will be created if it doesn't currently exist.
fragment	Stub parameter, don't assign values to this
group	Stub parameter, don't assign values to this
name
provider

Properties
content

Providers
simpcat_fragment	simpcat_fragment provider

Thu Mar 07 2019 Liz Nemsick lnemsick.simp@gmail.com - 6.0.3-0

Update the upper bound of stdlib to < 6.0.0
Update URLs in the README.md

Sun Mar 25 2018 Trevor Vaughan tvaughan@onyxpoint.com - 6.0.2-0

Add support for OEL and Puppet 5

Thu Jul 06 2017 Liz Nemsick lnemsick.simp@gmail.com - 6.0.1-0

Confine puppet version in metadata.json

Mon Nov 21 2016 Chris Tessmer chris.tessmer@onyxpoint.com - 6.0.0-0

Minor cleanup

Mon Nov 14 2016 Nick Miller nick.miller@onyxpoint.com - 6.0.0-0

Changed from using Puppet[:vardir] to Facter.value(:puppet_vardir), which accounts for the different vardirs on agent and server.

Fri Sep 30 2016 Trevor Vaughan tvaughan@onyxpoint.com - 6.0.0-0

Fully deconflict with puppetlabs-concat by renaming all types and providers to 'simpcat'

Thu May 26 2016 Trevor Vaughan tvaughan@onyxpoint.com - 5.0.1-0

Update to use the $puppet_vardir fact

Sat Nov 07 2015 Chris Tessmer chris.tessmer@onyxpoint.com - 5.0.0-0

Renamed pupmod-concat to pupmod-simpcat

Fri Jan 16 2015 Trevor Vaughan tvaughan@onyxpoint.com - 4.0.0-3

Changed puppet-server requirement to puppet

Thu Aug 07 2014 Trevor Vaughan tvaughan@onyxpoint.com - 4.0.0-2

Updated the concat_output and fragmentdir functions to properly handle String/Array conversions in Ruby 2.

Fri Jun 20 2014 Trevor Vaughan tvaughan@onyxpoint.com - 4.0.0-1

Updated to work with Ruby 2

Tue Jan 28 2014 Trevor Vaughan tvaughan@onyxpoint.com - 4.0.0-0

Updated several aspects of concat_build to work properly with Puppet 3.4

Thu Jan 16 2014 Kendall Moore kmoore@keywcorp.com - 2.1.1-3

Updated provided for concat_build so that empty concat fragments wouldn't error out when quiet is set to true.

Mon Jan 28 2013 Maintenance 2.1.1-2

Create a test to check concat_build, concat_fragment, concat_output, and fragmentdir using postfix and snmpd modules.

Mon Sep 10 2012 Maintenance 2.1.1-1

Fixed a bug where concat_build would explode if a file to be read had no content.
Added an option 'externally_managed' to indicate that the fragment in question was to be externally managed. This was mainly done to support Augeas building parts of files.

Thu Jun 07 2012 Maintenance 2.1.1-0

Ensure that Arrays in templates are flattened.
Call facts as instance variables.
Cleaned up a few items that cut down the run time. Most notably added a break in the file comparison segment.
Moved mit-tests to /usr/share/simp...
Updated the methods to return the proper property values.

Fri Mar 02 2012 Maintenance 2.1.0-3

Improved test stubs.

Fri Feb 10 2012 Maintenance 2.1.0-2

The concat module was not properly picking up changes from submodules.
Added checking to be sure that an appropriate target is set if using parent builds.

Mon Dec 26 2011 Maintenance 2.1.0-1

Updated the spec file to not require a separate file list.

Thu Nov 10 2011 Maintenance - 2.1.0-0

Massive rewrite for optimization.

Fri Feb 11 2011 Maintenance - 2.0.0-0

Initial implementation of concat_build and concat_fragment custom types.

pupmod-simp-simpcat - A Puppet Module for native file Concatenation

--

Per Section 105 of the Copyright Act of 1976, these works are not entitled to
domestic copyright protection under US Federal law.

The US Government retains the right to pursue copyright protections outside of
the United States.

The United States Government has unlimited rights in this software and all
derivatives thereof, pursuant to the contracts under which it was developed and
the License under which it falls.

Some work derived from external code:

Copyright (C) 2012 Onyx Point, Inc.

---

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Modules

Discover

Contribute

Puppet

Premium features

Downloads

Resources

About Forge

Getting Started