simp-rake-helpers 1.0.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ade6e1ae8a744fa8b543ed966cb67ed411ab41c0
+  data.tar.gz: ec51fff88f43b136d2932a655f8f39e2a2344510
+SHA512:
+  metadata.gz: 34978e726b9a3378f5ecb2e5b943eb010c6b45722b48bb8ab388404786a7f538359af9ffd751b0aff84daa4f753f19c062ff8e0293a2659267358c402701d55b
+  data.tar.gz: 0464603d53ab8e63fa4cc0d130fecafd5a68ce41343ea66e4a1c86448d98232d6762e2ac58901656d6af65797d564c687727d9119ce652d2c32a7be899f694a2

data/.gitignore

@@ -0,0 +1,3 @@
+*.sw[pnoqst]
+Gemfile.lock
+dist/

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+script:
+  - "bundle exec rake spec"

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+### 1.0.6 / 2015-06-24
+* Cleanup gemspec
+* Fixed bugs in the RPM signing code regarding fetching the username and
+  password from the appropriate source.
+
+### 1.0.4 / 2015-06-22
+* Added support for reading information directly from RPMs as well as spec
+  files.
+
+### 1.0.2 / 2105-04-02
+* Added support for snapshot_release, adds date and time to rpm release
+  version
+
+### 1.0.1 / 2015-02-03
+* Added the top level rake and rpm files to the Manifest
+
+### 1.0.0 / 2014-12-09
+* Refactored all the SIMP repositories' common Rakefile tasks into this gem.
+  * Birthday!
+

data/CONTRIBUTING.md

@@ -0,0 +1,4 @@
+## Contributing
+
+Please refer to the main [SIMP Project Contributing Guide](https://github.com/NationalSecurityAgency/SIMP/blob/master/CONTRIBUTING.md)
+for details on contributing to this project.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Guardfile

@@ -0,0 +1,24 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end
+
+# Add files and commands to this file, like the example:
+#   watch(%r{file/path}) { `command(s)` }
+#
+guard :shell do
+  watch(/(.*).md/) {|m| `tail #{m[0]}` }
+end

data/LICENSE

@@ -0,0 +1,27 @@
+rubygem-simp-rake-helpers - Common helper methods for SIMP Rakefiles
+
+--
+
+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.
+
+---
+
+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.

data/README.md

@@ -0,0 +1,27 @@
+# simp-rake-helpers
+
+Common helper methods for SIMP Rakefiles
+
+## Features
+* supports multithreaded mock operations
+
+
+## Usage
+```ruby
+require 'simp/rake/helpers'
+```
+
+## Requirements
+* SIMP source
+
+
+## Install
+* sudo gem install simp-rake-helpers
+
+
+## License
+See [LICENSE](LICENSE)
+
+
+## History
+See [CHANGELOG.md](CHANGELOG.md)

data/Rakefile

@@ -0,0 +1,56 @@
+# -*- ruby -*-
+
+require "rubygems"
+require 'rake/clean'
+require 'find'
+
+@package='simp-rake-helpers'
+@rakefile_dir=File.dirname(__FILE__)
+
+CLEAN.include "#{@package}-*.gem"
+CLEAN.include 'pkg'
+CLEAN.include 'dist'
+Find.find( @rakefile_dir ) do |path|
+  if File.directory? path
+    CLEAN.include path if File.basename(path) == 'tmp'
+  else
+    Find.prune
+  end
+end
+
+desc 'Ensure gemspec-safe permissions on all files'
+task :chmod do
+  gemspec = File.expand_path( "#{@package}.gemspec", @rakefile_dir ).strip
+  spec = Gem::Specification::load( gemspec )
+  spec.files.each do |file|
+    FileUtils.chmod 'go=r', file
+  end
+end
+
+desc 'run all RSpec tests'
+task :spec do
+  Dir.chdir @rakefile_dir
+  sh 'bundle exec rspec spec'
+end
+
+namespace :pkg do
+  desc "build rubygem package for #{@package}"
+  task :gem => :chmod do
+    Dir.chdir @rakefile_dir
+    Dir['*.gemspec'].each do |spec_file|
+      cmd = %Q{SIMP_RPM_BUILD=1 bundle exec gem build "#{spec_file}"}
+      sh cmd
+      FileUtils.mkdir_p 'dist'
+      FileUtils.mv Dir.glob("#{@package}*.gem"), 'dist/'
+    end
+  end
+
+  desc "build and install rubygem package for #{@package}"
+  task :install_gem => [:clean, :gem] do
+    Dir.chdir @rakefile_dir
+    Dir.glob("dist/#{@package}*.gem") do |pkg|
+      sh %Q{bundle exec gem install #{pkg}}
+    end
+  end
+end
+# vim: syntax=ruby

data/bin/simp_rake_helpers

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+abort "you need to write me"

data/lib/simp/rake.rb

@@ -0,0 +1,134 @@
+module Simp; end
+module Simp::Rake
+  require 'rubygems'
+  require 'erb'
+  require 'rake/clean'
+  require 'find'
+  require 'yaml'
+  require 'shellwords'
+  require 'parallel'
+  require 'tempfile'
+  require 'simp/rpm'
+  require 'simp/rake/pkg'
+
+  # Force the encoding to something that Ruby >= 1.9 is happy with
+  def encode_line(line)
+    if Gem::Version.new(RUBY_VERSION) < Gem::Version.new('1.9')
+      require 'iconv'
+      line = Iconv.new('ISO-8859-1//IGNORE','UTF-8').iconv(line)
+    else
+      line = line.force_encoding(Encoding::ISO_8859_1).encode(Encoding::UTF_8,:replace => nil,:undef => :replace)
+    end
+  end
+
+  # by default, we use all processors - 1
+  def get_cpu_limit
+    cpus = Parallel.processor_count
+    env_cpus = ENV.fetch( 'SIMP_RAKE_LIMIT_CPUS', '-1' ).strip.to_i
+
+    env_cpus  = 1          if env_cpus == 0
+    env_cpus += cpus       if env_cpus < 0
+    # sanitize huge numbers
+    env_cpus  = (cpus - 1) if env_cpus >= cpus
+    env_cpus  = 1          if env_cpus < 0
+
+    env_cpus
+  end
+
+  # Snarfed from http://nex-3.com/posts/73-git-style-automatic-paging-in-ruby
+  def run_pager
+    return if RUBY_PLATFORM =~ /win32/
+    return unless STDOUT.tty?
+
+    read, write = IO.pipe
+
+    unless Kernel.fork # Child process
+      STDOUT.reopen(write)
+      STDERR.reopen(write) if STDERR.tty?
+      read.close
+      write.close
+      return
+    end
+
+    # Parent process, become pager
+    STDIN.reopen(read)
+    read.close
+    write.close
+
+    ENV['LESS'] = 'FSRX' # Don't page if the input is short enough
+
+    Kernel.select [STDIN] # Wait until we have input before we start the pager
+    pager = ENV['PAGER'] || 'less'
+    exec pager rescue exec "/bin/sh", "-c", pager
+  end
+
+  # Originally snarfed from
+  # http://stackoverflow.com/questions/2108727/which-in-ruby-checking-if-program-exists-in-path-from-ruby
+  def which(cmd)
+    File.executable?(cmd) and return cmd
+
+    cmd = File.basename(cmd)
+
+    exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+    ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+      exts.each { |ext|
+        exe = File.join(path, "#{cmd}#{ext}")
+        return exe if File.executable? exe
+      }
+    end
+
+    warn "Warning: Command #{cmd} not found on the system."
+    return nil
+  end
+
+  # Return whether or not the user is in the mock group
+  def validate_in_mock_group?
+    if not %x{groups}.split.include?('mock')
+      raise(Exception,"You need to be in the 'mock' group.")
+    end
+  end
+
+  def help
+    run_pager
+
+    puts <<-EOM
+= SIMP Build Tasks =
+
+Use 'rake' and choose one of the options below that best suits your
+needs. If you are simply trying to build the SIMP tarball, use the
+'rake tar:build[:chroot]' option.
+
+NOTE: Any task that requires a :chroot input will require you to be in
+the 'mock' group and have the 'mock' package installed.
+
+== Space Requirements ==
+
+A full parallel build will take around 500M for each git submodule built.
+
+If you are space limited, set SIMP_RAKE_LIMIT_CPUS=1 at build time.
+
+== Environment Variables ==
+
+* SIMP_RAKE_CHOWN_EVERYTHING=(Y|n)
+  - Chown everything to the 'mock' group prior to building
+
+* SIMP_RAKE_MOCK_OFFLINE=(y|N)
+  - Mock runs are limited to the local cache
+
+* SIMP_RAKE_LIMIT_CPUS=#
+  - Default: Num system CPUs - 1
+  - An Integer that limits builds to # processors
+  - If set to '1', will only build in a single mock directory
+
+* SIMP_GIT_BRANCH=<Branch ID>
+  - If you are working in the supermodule and wish to perform a reset, but
+    retain your working branch at the supermodule level. You can set this to
+    ignore the current supermodule branch value.
+  - This is particularly valuable when using Jenkins.
+
+********************
+EOM
+
+    sh %{rake -D}
+  end
+end

data/lib/simp/rake/helpers.rb

@@ -0,0 +1,7 @@
+module Simp; end
+module Simp::Rake; end
+
+class Simp::Rake::Helpers
+  VERSION = '1.0.6'
+  require 'simp/rake/pkg'
+end

data/lib/simp/rake/pkg.rb

@@ -0,0 +1,321 @@
+# This file provided many common build-related tasks and helper methods from
+# the SIMP Rakefile ecosystem.
+
+require 'rake'
+require 'rake/clean'
+require 'rake/tasklib'
+require 'fileutils'
+require 'find'
+
+module Simp; end
+module Simp::Rake
+  class Pkg < ::Rake::TaskLib
+
+    # path to the project's directory.  Usually `File.dirname(__FILE__)`
+    attr_accessor :base_dir
+
+    # the name of the package.  Usually `File.basename(@base_dir)`
+    attr_accessor :pkg_name
+
+    # path to the project's RPM specfile
+    attr_accessor :spec_file
+
+    # path to the directory to place generated assets (e.g., rpm, srpm, tar.gz)
+    attr_accessor :pkg_dir
+
+    # array of items to exclude from the tarball
+    attr_accessor :exclude_list
+
+    # array of items to additionally clean
+    attr_accessor :clean_list
+
+    #
+    attr_accessor :unique_name
+
+    # array of items to ignore when checking if the tarball needs to be rebuilt
+    attr_accessor :ignore_changes_list
+
+    def initialize( base_dir, unique_name=nil )
+       @base_dir            = base_dir
+       @pkg_name            = File.basename(@base_dir)
+       @spec_file           = Dir.glob("#{@base_dir}/build/*.spec").first
+       @pkg_dir             = "#{@base_dir}/dist"
+       @exclude_list        = [ File.basename(@pkg_dir) ]
+       @clean_list          = []
+       @ignore_changes_list = []
+       @chroot_name         = unique_name
+
+       ::CLEAN.include( @pkg_dir )
+
+       yield self if block_given?
+
+       ::CLEAN.include( @clean_list )
+
+       @spec_info      = Pkg.get_info( @spec_file )
+       @chroot_name    = @chroot_name || "#{@spec_info[:name]}__#{ENV.fetch( 'USER', 'USER' )}"
+       @dir_name       = "#{@spec_info[:name]}-#{@spec_info[:version]}"
+       @mfull_pkg_name = "#{@dir_name}-#{@spec_info[:release]}"
+       @full_pkg_name  = @mfull_pkg_name.gsub("%{?snapshot_release}","")
+       @tar_dest = "#{@pkg_dir}/#{@full_pkg_name}.tar.gz"
+
+       define
+    end
+
+
+    def define
+      # For the most part, we don't want to hear Rake's noise, unless it's an error
+      # TODO: Make this configurable
+      verbose(false)
+
+      define_clean
+      define_clobber
+      define_pkg_tar
+      define_pkg_srpm
+      define_pkg_rpm
+      define_pkg_scrub
+      task :default => 'pkg:tar'
+      self
+    end
+
+
+    def define_clean
+      desc <<-EOM
+      Clean build artifacts for #{@pkg_name} (except for mock)
+      EOM
+      task :clean do |t,args|
+        # this is provided by 'rake/clean' and the ::CLEAN constant
+      end
+    end
+
+
+
+    def define_clobber
+      desc <<-EOM
+      Clobber build artifacts for #{@pkg_name} (except for mock)
+      EOM
+      task :clobber do |t,args|
+      end
+    end
+
+
+    def define_pkg_tar
+      namespace :pkg do
+        directory @pkg_dir
+
+        # :pkg:tar
+        # -----------------------------
+        desc <<-EOM
+        Build the #{@pkg_name} tar package
+            * :snapshot_release - Add snapshot_release (date and time) to rpm version, rpm spec file must have macro for this to work.
+        EOM
+        task :tar,[:snapshot_release] => [@pkg_dir] do |t,args|
+          args.with_defaults(:snapshot_release => false)
+
+          l_date = ''
+          if args.snapshot_release == 'true' then
+            l_date = '.' + "#{TIMESTAMP}"
+            @tar_dest = "#{@pkg_dir}/#{@full_pkg_name}#{l_date}.tar.gz"
+          end
+          Dir.chdir("#{@base_dir}/..") do
+            Find.find(@pkg_name) do |path|
+              Find.prune if path =~ /^\.git/
+              Find.prune if path == "#{@pkg_name}/#{File.basename(@pkg_dir)}"
+              Find.prune if @ignore_changes_list.include?(path)
+              if path == @pkg_name and not uptodate?(@tar_dest,[path]) then
+                sh %Q{tar --owner 0 --group 0 --exclude-vcs --exclude=#{@exclude_list.join(' --exclude=')} --transform='s/^#{@pkg_name}/#{@dir_name}/' -cpzf "#{@tar_dest}" #{@pkg_name}}
+                break
+              end
+            end
+          end
+        end
+      end
+    end
+
+
+    def define_pkg_srpm
+      namespace :pkg do
+        desc <<-EOM
+        Build the #{@pkg_name} SRPM
+          Building RPMs requires a working Mock setup (http://fedoraproject.org/wiki/Projects/Mock)
+            * :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.
+                        Rpm spec file must have macro for this to work.
+        EOM
+        task :srpm,[:chroot,:unique,:snapshot_release] => [:tar] do |t,args|
+          args.with_defaults(:unique => false)
+          args.with_defaults(:snapshot_release => false)
+
+          l_date = ''
+          if args.snapshot_release == 'true' then
+            l_date = '.' + "#{TIMESTAMP}"
+            mocksnap = "-D 'snapshot_release #{l_date}'"
+            @tar_dest = "#{@pkg_dir}/#{@full_pkg_name}#{l_date}.tar.gz"
+          end
+
+          mock_cmd = mock_pre_check( args.chroot, @chroot_name, args.unique )
+          output = "#{@full_pkg_name}#{l_date}.src.rpm"
+          if not uptodate?("#{@pkg_dir}/#{output}",[@tar_dest]) then
+            cmd = %Q{#{mock_cmd} --no-clean --root #{args.chroot} #{mocksnap} --buildsrpm --spec #{@spec_file} --source #{@pkg_dir}}
+            sh cmd
+          end
+        end
+      end
+    end
+
+
+
+    def define_pkg_rpm
+      namespace :pkg do
+        desc <<-EOM
+        Build the #{@pkg_name} RPM
+          Building RPMs requires a working Mock setup (http://fedoraproject.org/wiki/Projects/Mock)
+            * :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.
+        EOM
+        task :rpm,[:chroot,:unique,:snapshot_release] do |t,args|
+          args.with_defaults(:unique => false)
+          args.with_defaults(:snapshot_release => false)
+
+          l_date = ''
+          if args.snapshot_release == 'true' then
+            l_date = '.' + "#{TIMESTAMP}"
+            mocksnap = "-D 'snapshot_release #{l_date}'"
+            @tar_dest = "#{@pkg_dir}/#{@full_pkg_name}#{l_date}.tar.gz"
+          end
+
+          mock_cmd = mock_pre_check( args.chroot, @chroot_name, args.unique )
+          Rake::Task['pkg:srpm'].invoke(args.chroot,args.unique,args.snapshot_release)
+
+          output = "#{@full_pkg_name}#{l_date}.#{@spec_info[:arch]}.rpm"
+          if not uptodate?("#{@pkg_dir}/#{output}",[@tar_dest]) then
+            cmd = %Q{#{mock_cmd} --root #{args.chroot} #{mocksnap} #{@pkg_dir}/#{@full_pkg_name}#{l_date}.src.rpm}
+            sh cmd
+          end
+        end
+      end
+    end
+
+    def define_pkg_scrub
+      namespace :pkg do
+        # :pkg:scrub
+        # -----------------------------
+        desc <<-EOM
+        Scrub the #{@pkg_name} mock build directory
+        EOM
+        task :scrub,[:chroot,:unique] do |t,args|
+          args.with_defaults(:unique => false)
+
+          mock_cmd = mock_pre_check( args.chroot, @chroot_name, args.unique, false )
+          cmd = %Q{#{mock_cmd} --scrub=all}
+          sh cmd
+        end
+
+      end
+
+    end
+
+    # ------------------------------------------------------------------------------
+    # helper methods
+    # ------------------------------------------------------------------------------
+    # Pull the main RPM information out of the package spec file.
+    def Pkg.get_info(specfile)
+      info = Hash.new
+      info[:arch] = %x{uname -i}
+
+      if File.readable?(specfile) then
+        File.open(specfile).each do |line|
+          if line =~ /^\s*Version:\s+(.*)\s*/ then
+            info[:version] = $1
+            next
+          elsif line =~ /^\s*Release:\s+(.*)\s*/ then
+            info[:release] = $1
+            next
+          elsif line =~ /^\s*Name:\s+(.*)\s*/ then
+            info[:name] = $1
+            next
+          elsif line =~ /^\s*Buildarch:\s+(.*)\s*/ then
+            info[:arch] = $1
+            next
+          end
+        end
+      else
+        raise "Error: unable to read the spec file '#{specfile}'"
+      end
+      return info
+    end
+
+
+    # Get a list of all of the mock configs available on the system.
+    def Pkg.get_mock_configs
+      Dir.glob('/etc/mock/*.cfg').sort.map{ |x| x = File.basename(x,'.cfg')}
+    end
+
+
+    # Run some pre-checks to make sure that mock will work properly.
+    #
+    # chroot   = name of mock chroot to use
+    # unique_ext = TODO
+    # Pass init=false if you do not want the function to initialize.
+    #
+    # Returns a String that contains the appropriate mock command.
+    def mock_pre_check( chroot, unique_ext, unique=false, init=true )
+
+      raise %Q{unique_ext must be a String ("#{unique_ext}" = #{unique_ext.class})} if not unique_ext.is_a? String
+
+      mock = ENV['mock'] || '/usr/bin/mock'
+      raise(Exception,"Could not find mock on your system, exiting") unless File.executable?('/usr/bin/mock')
+
+      mock_configs = Pkg.get_mock_configs
+      if not chroot then
+        raise(Exception,
+          "Error: No mock chroot provided. Your choices are:\n  #{mock_configs.join("\n  ")}"
+        )
+      end
+      if not mock_configs.include?(chroot) then
+        raise(Exception,
+          "Error: Invalid mock chroot provided. Your choices are:\n  #{mock_configs.join("\n  ")}"
+        )
+      end
+
+      # if true, restrict yum to the chroot's local yum cache (defaults to false)
+      mock_offline = ENV.fetch( 'SIMP_RAKE_MOCK_OFFLINE', 'N' ).chomp.index( %r{^(1|Y|true|yes)$} ) || false
+
+      mock_cmd =  "#{mock} --quiet"
+      mock_cmd += " --uniqueext=#{unique_ext}" if unique
+      mock_cmd += " --offline"               if mock_offline
+
+      initialized = is_mock_initialized( mock_cmd, chroot)
+
+      if init and not initialized then
+        sh %Q{#{mock_cmd} --root #{chroot} --init ##{unique_ext} }
+      else
+        # Remove any old build cruft from the mock directory.
+        # This is kludgy but WAY faster than rebuilding them all, even with a cache.
+        sh %Q{#{mock_cmd} --root #{chroot} --chroot "/bin/rm -rf /builddir/build/BUILDROOT /builddir/build/*/*"}
+      end
+
+      mock_cmd + " --no-clean --no-cleanup-after --resultdir=#{@pkg_dir} --disable-plugin=package_state"
+    end
+
+    def is_mock_initialized( mock_cmd, chroot )
+      %x{#{mock_cmd} --root #{chroot} --chroot "test -d /tmp" &> /dev/null }
+      initialized = $?.success?
+
+      # A simple test to see if the chroot is initialized.
+      initialized
+    end
+
+    def pry
+      #FIXME: remove this debugging nonsense before release
+      if Rake::verbose.is_a? TrueClass
+        require 'pry'
+        binding.pry
+      end
+    end
+  end
+end

data/lib/simp/rpm.rb

@@ -0,0 +1,162 @@
+module Simp
+  # Simp::RPM represents a single package that is built and packaged by the Simp team.
+  class Simp::RPM
+    require 'expect'
+    require 'pty'
+
+    @@gpg_keys = Hash.new
+    attr_accessor :basename, :version, :release, :full_version, :name, :sources, :verbose
+
+    if Gem.loaded_specs['rake'].version >= Gem::Version.new('0.9')
+      def self.sh(args)
+        system args
+      end
+    end
+
+    # Constructs a new Simp::RPM object. Requires the path to the spec file
+    # from which information will be gathered.
+    #
+    # The following information will be retreived:
+    # [basename] The name of the package (as it would be queried in yum)
+    # [version] The version of the package
+    # [release] The release version of the package
+    # [full_version] The full version of the package: [version]-[release]
+    # [name] The full name of the package: [basename]-[full_version]
+    def initialize(rpm_source)
+      info = Simp::RPM.get_info(rpm_source)
+      @basename = info[:name]
+      @version = info[:version]
+      @release = info[:release]
+      @full_version = info[:full_version]
+      @name = "#{@basename}-#{@full_version}"
+      @sources = Array.new
+    end
+
+    # Copies specific content from one directory to another.
+    # start_dir:: the root directory where the original files are located within
+    # src:: a pattern given to find(1) to match against the desired files to copy
+    # dest:: the destination directory to receive the copies
+    def self.copy_wo_vcs(start_dir, src, dest, dereference=true)
+      if dereference.nil? || dereference
+        dereference = "--dereference"
+      else
+        dereference = ""
+      end
+
+      Dir.chdir(start_dir) do
+        sh %{find #{src} \\( -path "*/.svn" -a -type d -o -path "*/.git*" \\) -prune -o -print | cpio -u --warning none --quiet --make-directories #{dereference} -p "#{dest}" 2>&1 > /dev/null}
+      end
+    end
+
+    # Parses information, such as the version, from the given specfile or RPM
+    # into a hash.
+    def self.get_info(rpm_source)
+      info = Hash.new
+      if File.readable?(rpm_source)
+        if rpm_source.split('.').last == 'rpm'
+          rpm_info = %x(rpm -q --queryformat '%{NAME} %{VERSION} %{RELEASE}' -p #{rpm_source} 2>/dev/null)
+          info[:name],info[:version],info[:release] = rpm_info.split(' ')
+        else
+          File.open(rpm_source).each do |line|
+            if line =~ /^\s*Version:\s+(.*)\s*/
+              info[:version] = $1
+              next
+            elsif line =~ /^\s*Release:\s+(.*)\s*/
+              info[:release] = $1
+              next
+            elsif line =~ /^\s*Name:\s+(.*)\s*/
+              info[:name] = $1
+              next
+            end
+          end
+        end
+      else
+        raise "Error: unable to read '#{rpm_source}'"
+      end
+
+      info[:full_version] = "#{info[:version]}-#{info[:release]}"
+
+      return info
+    end
+
+    # Loads metadata for a GPG key. The GPG key is to be used to sign RPMs. The
+    # value of gpg_key should be the full path of the directory where the key
+    # resides. If the metadata cannot be found, then the user will be prompted
+    # for it.
+    def self.load_key(gpg_key)
+      keydir = gpg_key
+      File.directory?(keydir) || fail("Error: Could not find '#{keydir}'")
+
+      gpg_key = File.basename(gpg_key)
+
+      if @@gpg_keys[gpg_key]
+          return @@gpg_keys[gpg_key]
+      end
+
+      gpg_name = nil
+      gpg_password = nil
+      begin
+        File.read("#{keydir}/gengpgkey").each_line do |ln|
+          name_line = ln.split(/^\s*Name-Email:/)
+          if name_line.length > 1
+            gpg_name = name_line.last.strip
+          end
+
+          passwd_line = ln.split(/^\s*Passphrase:/)
+          if passwd_line.length > 1
+            gpg_password = passwd_line.last.strip
+          end
+        end
+      rescue Errno::ENOENT
+      end
+
+      if gpg_name.nil?
+        puts "Warning: Could not find valid e-mail address for use with GPG."
+        puts "Please enter e-mail address to use:"
+        gpg_name = $stdin.gets.strip
+      end
+
+      if gpg_password.nil?
+        if File.exist?(%(#{keydir}/password))
+          gpg_password = File.read(%(#{keydir}/password)).chomp
+        end
+
+        if gpg_password.nil?
+          puts "Warning: Could not find a password in '#{keydir}/password'!"
+          puts "Please enter your GPG key password:"
+          system 'stty -echo'
+          gpg_password = $stdin.gets.strip
+          system 'stty echo'
+        end
+      end
+
+      @@gpg_keys[gpg_key] = { :dir => keydir, :name => gpg_name, :password => gpg_password }
+    end
+
+    # Signs the given RPM with the given gpg_key (see Simp::RPM.load_key for
+    # details on the value of this parameter).
+    def self.signrpm(rpm, gpg_key)
+      gpgkey = load_key(gpg_key)
+      signcommand = "rpm " +
+          "--define '%_signature gpg' " +
+          "--define '%_gpg_name #{gpgkey[:name]}' " +
+          "--define '%_gpg_path #{gpgkey[:dir]}' " +
+          "--resign #{rpm}"
+      begin
+        PTY.spawn(signcommand) do |read, write, pid|
+          begin
+            read.expect(/Enter pass phrase: /) do |text|
+              write.print("#{gpgkey[:password]}\n")
+            end
+          rescue Errno::EIO
+            # This ALWAYS happens in Ruby 1.8.
+          end
+          Process.wait(pid)
+        end
+      rescue Exception => e
+        puts "Error occured while attempting to sign #{rpm}, skipping."
+        puts e
+      end
+    end
+  end
+end

data/spec/lib/simp/files/build/testpackage.spec

@@ -0,0 +1,37 @@
+Name:           testpackage
+Version:        1
+Release:        0%{?dist}
+Summary:        a test package
+
+License:        Apache-2.0
+URL:
+Source0:
+
+BuildRequires:
+Requires:
+
+%description
+
+
+%prep
+%setup -q
+
+
+%build
+%configure
+make %{?_smp_mflags}
+
+
+%install
+rm -rf $RPM_BUILD_ROOT
+%make_install
+
+
+%files
+%doc
+
+
+
+%changelog
+* Wed Jun 10 2015 nobody
+- some comment

data/spec/lib/simp/files/testpackage.spec

@@ -0,0 +1,37 @@
+Name:           testpackage
+Version:        1
+Release:        0%{?dist}
+Summary:        a test package
+
+License:        Apache-2.0
+URL:
+Source0:
+
+BuildRequires:
+Requires:
+
+%description
+
+
+%prep
+%setup -q
+
+
+%build
+%configure
+make %{?_smp_mflags}
+
+
+%install
+rm -rf $RPM_BUILD_ROOT
+%make_install
+
+
+%files
+%doc
+
+
+
+%changelog
+* Wed Jun 10 2015 nobody
+- some comment

data/spec/lib/simp/rake/helpers_spec.rb

@@ -0,0 +1,15 @@
+require 'simp/rake/helpers'
+require 'spec_helper'
+
+describe Simp::Rake::Helpers do
+  before :each do
+    @obj = Simp::Rake::Helpers.new
+  end
+
+  describe "#initialize" do
+    it "initialized (smoke test)" do
+      expect( @obj.class ).to eq Simp::Rake::Helpers
+    end
+  end
+end
+

data/spec/lib/simp/rake/pkg_spec.rb

@@ -0,0 +1,15 @@
+require 'simp/rake/pkg'
+require 'spec_helper'
+
+describe Simp::Rake::Pkg do
+  before :all do
+    dir        = File.expand_path( '../files', File.dirname( __FILE__ ) )
+    @obj = Simp::Rake::Pkg.new( dir )
+  end
+
+  describe "#initialize" do
+    it "initializes (smoke test)" do
+      expect( @obj.class ).to eq Simp::Rake::Pkg
+    end
+  end
+end

data/spec/lib/simp/rake_spec.rb

@@ -0,0 +1,21 @@
+require 'simp/rake'
+require 'spec_helper'
+
+describe Simp::Rake do
+  RSpec.configure do |c|
+    c.include Simp::Rake
+  end
+
+  describe ".get_cpu_limit" do
+    it "detects number of CPUs" do
+      expect( get_cpu_limit ).to be > 0
+    end
+  end
+
+
+  describe 'tests are missing' do
+    it 'should have more tests' do
+      skip 'TODO: write more tests'
+    end
+  end
+end

data/spec/lib/simp/rpm_spec.rb

@@ -0,0 +1,24 @@
+require 'simp/rpm'
+require 'spec_helper'
+
+describe Simp::RPM do
+  before :all do
+    dir        = File.expand_path( 'files', File.dirname( __FILE__ ) )
+    @spec_file = File.join( dir, 'testpackage.spec' )
+    @obj = Simp::RPM.new( @spec_file )
+  end
+
+  describe "#initialize" do
+    it "initializes (smoke test)" do
+      expect( @obj.class ).to eq Simp::RPM
+    end
+  end
+
+  describe ".get_info" do
+    it "extracts correct information from a .spec file" do
+      info = Simp::RPM.get_info(@spec_file)
+      expect( info.fetch( :name    ) ).to eq 'testpackage'
+      expect( info.fetch( :version ) ).to eq '1'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+#  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -0,0 +1,285 @@
+--- !ruby/object:Gem::Specification
+name: simp-rake-helpers
+version: !ruby/object:Gem::Version
+  version: 1.0.6
+platform: ruby
+authors:
+- Chris Tessmer
+- Trevor Vaughan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: coderay
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  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
+  name: puppet-lint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: puppetlabs_spec_helper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: parallel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: gitlog-md
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-doc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: guard-shell
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4'
+description: |2
+      "simp-rake-helpers provides common methods for SIMP Rake Tasks"
+email: simp@simp-project.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/simp_rake_helpers
+- lib/simp/rake.rb
+- lib/simp/rake/helpers.rb
+- lib/simp/rake/pkg.rb
+- lib/simp/rpm.rb
+- spec/lib/simp/files/build/testpackage.spec
+- spec/lib/simp/files/testpackage.spec
+- spec/lib/simp/rake/helpers_spec.rb
+- spec/lib/simp/rake/pkg_spec.rb
+- spec/lib/simp/rake_spec.rb
+- spec/lib/simp/rpm_spec.rb
+- spec/spec_helper.rb
+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
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: SIMP rake helpers
+test_files: []
+has_rdoc: