simp-rake-helpers 1.0.9 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 110e3f2af50e46dc49f2a79cf25d5296e8672414
-  data.tar.gz: 8130ce80eb6667c8e72b3c83a67d37e81e752eb7
+  metadata.gz: 93def8d379879e106ff6d75e7824a955e62801a1
+  data.tar.gz: b1e7d9ac4a46ed7687ecbebcf27cac3d0c98248a
 SHA512:
-  metadata.gz: b8a60728425f1d35d6f62584ecaf9a34d11080724c558b3415c1188d566dc7c03452d99e530f462635967cba81da6e84f8712e5d2c45ef531e03e27f43846770
-  data.tar.gz: f5bba0a68c0eb1d32aac9702903e0866d067587e8754c8010aa1840c2441d624a4d87d750350b2a0840e587ba90b4a8e7868898995ed279f8cbbff2c77e30320
+  metadata.gz: 07e7d770569a585dbd70a1036d95c02066999e20adbd5a8d525e45891b6ff8cbe84f23d7ceeaaa726a623b2341b15f858064cadf745a366b05cc4335f668db7d
+  data.tar.gz: 02c7c7d0dd9dd45b6223016079f8a88cbd6511c44b8709700047d4e1d65819ab755426af3f38388e5ceeed8ac97ab22f1e08d3d1c68c68425f0688e271dedde3

data/.rspec

@@ -1,3 +1,3 @@
 --color
---format progress
+--format documentation
 --require spec_helper

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+### 1.0.10 / 2015-07-23
+* Relax dependency to allow puppet 3 or above
+
 ### 1.0.9 / 2015-07-15
 * Ensure that the GPG signing code works on Fedora 22 and RHEL7 and RHEL6
 

data/Gemfile

@@ -1,3 +1,14 @@
-source 'https://rubygems.org'
+# Variables:
+#
+# SIMP_GEM_SERVERS | a space/comma delimited list of rubygem servers
+# PUPPET_VERSION   | specifies the version of the puppet gem to load
+puppetversion = ENV.key?('PUPPET_VERSION') ? "#{ENV['PUPPET_VERSION']}" : false
+gem_sources   = ENV.key?('SIMP_GEM_SERVERS') ? ENV['SIMP_GEM_SERVERS'].split(/[, ]+/) : ['https://rubygems.org']
+
+gem_sources.each { |gem_source| source gem_source }
 
 gemspec
+
+if puppetversion
+  gem 'puppet', puppetversion
+end

data/README.md

@@ -1,27 +1,111 @@
 # simp-rake-helpers
+[![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html) [![Build Status](https://travis-ci.org/simp/rubygems-simp-rake-helpers.svg?branch=master)](https://travis-ci.org/simp/rubygems-simp-rake-helpers)
 
+
+## Work in Progress
+
+Please excuse us as we transition this code into the public domain.
+
+Downloads, discussion, and patches are still welcome!
 Common helper methods for SIMP Rakefiles
 
-## Features
+#### Table of Contents
+
+1. [Overview](#overview)
+  * [This gem is part of SIMP](#this-gem-is-part-of-simp)
+  * [Features](#features)
+2. [Setup - The basics of getting started with iptables](#setup)
+3. [Usage - Configuration options and additional functionality](#usage)
+4. [Reference - An under-the-hood peek at what the gem is doing and how](#reference)
+5. [Limitations - OS compatibility, etc.](#limitations)
+6. [Development - Guide for contributing to the module](#development)
+  * [License](#license)
+  * [History](#history)
+
+
+## Overview
+The `simp-rake-helpers` gem provides common Rake tasks to support the SIMP build process.
+
+
+### This gem is part of SIMP
+This gem is part of (the build tooling for) the [System Integrity Management Platform](https://github.com/NationalSecurityAgency/SIMP), a compliance-management framework built on [Puppet](https://puppetlabs.com/).
+
+
+### Features
 * supports multithreaded mock operations
+* RPM packaging and signing
+
+
+## Setup
+Within a project's Gemfile:
+
+```ruby
+gem 'simp-rake-helpers'
+```
 
 
 ## Usage
+Within a project's Rakefile:
+
 ```ruby
 require 'simp/rake/helpers'
 ```
 
-## Requirements
-* SIMP source
+To see the extra rake tasks:
+
+```sh
+bunde exec rake -T
+```
+
+## Reference
+
+### simp/rake/rpm
+
+#### rake pkg:rpm[chroot,unique,snapshot_release]
+Builds an RPM to package the current SIMP project.
+
+**NOTE**: Building RPMs requires a working Mock setup (http://fedoraproject.org/wiki/Projects/Mock)
+
+##### Parameters
+
+  * **:chroot** - The Mock chroot configuration to use. See the '--root' option in mock(1)."
+  * **:unique** - Whether or not to build the RPM in a unique Mock environment.  This can be very useful for parallel builds of all modules.
+* **:snapshot_release** - Add snapshot_release (date and time) to rpm version.  Rpm spec file must have macro for this to work.
+
+
+#### rake pkg:scrub[chroot,unique]
+
+Scrub the current SIMP project's mock build directory.
+
+
+#### rake pkg:srpm[chroot,unique,snapshot_release]
+Build the pupmod-simp-iptables SRPM.   Building RPMs requires a working Mock setup (http://fedoraproject.org/wiki/Projects/Mock)
+
+**NOTE**: Building RPMs requires a working Mock setup (http://fedoraproject.org/wiki/Projects/Mock)
+
+##### Parameters
+
+  * **:chroot** - The Mock chroot configuration to use. See the '--root' option in mock(1)."
+  * **:unique** - Whether or not to build the SRPM in a unique Mock environment.  This can be very useful for parallel builds of all modules.
+  * **:snapshot_release** - Add snapshot_release (date and time) to rpm version.  The RPM spec file must support macros for this to work.
+
+#### rake pkg:tar[snapshot_release]
+
+##### Parameters
+
+Build the pupmod-simp-iptables tar package
+  * :snapshot_release - Add snapshot_release (date and time) to rpm version, rpm spec file must have macro for this to work.
+
+## Limitations
 
 
-## Install
-* sudo gem install simp-rake-helpers
+## Development
 
+Please see the [SIMP Contribution Guidelines](https://simp-project.atlassian.net/wiki/display/SD/Contributing+to+SIMP).
 
-## License
+### License
 See [LICENSE](LICENSE)
 
 
-## History
+### History
 See [CHANGELOG.md](CHANGELOG.md)

data/lib/simp/rake/helpers.rb

@@ -2,6 +2,5 @@ module Simp; end
 module Simp::Rake; end
 
 class Simp::Rake::Helpers
-  VERSION = '1.0.9'
-  require 'simp/rake/pkg'
+  VERSION = '1.0.10'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simp-rake-helpers
 version: !ruby/object:Gem::Version
-  version: 1.0.9
+  version: 1.0.10
 platform: ruby
 authors:
 - Chris Tessmer
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-17 00:00:00.000000000 Z
+date: 2015-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -57,14 +57,14 @@ dependencies:
   name: puppet
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: '3'
 - !ruby/object:Gem::Dependency
@@ -260,7 +260,7 @@ homepage: https://github.com/simp/rubygem-simp-rake-helpers
 licenses:
 - Apache-2.0
 metadata:
-  issue_tracker: https://github.com/simp/rubygem-simp-rake-helpers/issues
+  issue_tracker: https://simp-project.atlassian.net
 post_install_message: 
 rdoc_options: []
 require_paths: