rototiller 0.0.0.b

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1d55671811e2416321d690faed5b873e6656bb5a
+  data.tar.gz: c6bd60e740eafc188f462997b429132752806a70
+SHA512:
+  metadata.gz: 2641a1a861d9f54b1218c6b718179ff985b9f2c77a2472729d2a0ba58907279e484e6c448506b83fe8c2234720a28df78e0fe2dfdfca6a823b0f7e2c3c3437b8
+  data.tar.gz: 77a6855654474501fb1152b470e4e71d99c160065f0e46a0940e976f34fd1e9e01b139f7c336d677b8f933474978e210f751b5e41ab6b97e74232189895b83eb

data/Gemfile

@@ -0,0 +1,32 @@
+source 'https://rubygems.org'
+
+# place all development, system_test, etc dependencies here
+
+group :system_tests do
+  #gem 'beaker', :path => "../../beaker/"
+  gem 'beaker'               ,'~> 2.22'
+  gem 'beaker-hostgenerator'
+end
+
+group :development do
+  gem 'rspec'                ,'~> 3.1.0'
+  gem 'simplecov'
+  #Documentation dependencies
+  gem 'yard'                 ,'~> 0'
+  gem 'markdown'             ,'~> 0'
+  # restrict version to enable ruby 1.9.3
+  gem 'mime-types'           ,'~> 2.0'
+end
+
+local_gemfile = "#{__FILE__}.local"
+if File.exists? local_gemfile
+  eval(File.read(local_gemfile), binding)
+end
+
+user_gemfile = File.join(Dir.home,'.Gemfile')
+if File.exists? user_gemfile
+  eval(File.read(user_gemfile), binding)
+end
+
+# Specify your gem's dependencies in rototiller.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,279 @@
+PATH
+  remote: .
+  specs:
+    rototiller (0.0.0.b)
+      rake
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (2.3.2)
+    activesupport (4.2.6)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    addressable (2.4.0)
+    aws-sdk (1.66.0)
+      aws-sdk-v1 (= 1.66.0)
+    aws-sdk-v1 (1.66.0)
+      json (~> 1.4)
+      nokogiri (>= 1.4.4)
+    beaker (2.37.0)
+      aws-sdk (~> 1.57)
+      beaker-answers (~> 0.0)
+      beaker-hiera (~> 0.0)
+      beaker-pe (~> 0.0)
+      docker-api
+      fission (~> 0.4)
+      fog (~> 1.25, < 1.35.0)
+      fog-google (~> 0.0.9)
+      google-api-client (~> 0.8)
+      hocon (~> 0.1)
+      inifile (~> 2.0)
+      json (~> 1.8)
+      mime-types (~> 2.99)
+      minitest (~> 5.4)
+      net-scp (~> 1.2)
+      net-ssh (~> 2.9)
+      open_uri_redirections (~> 0.2.1)
+      rbvmomi (~> 1.8)
+      rsync (~> 1.0.9)
+      stringify-hash (~> 0.0)
+      unf (~> 0.1)
+    beaker-answers (0.4.0)
+      require_all (~> 1.3.2)
+      stringify-hash (~> 0.0.0)
+    beaker-hiera (0.1.1)
+      stringify-hash (~> 0.0.0)
+    beaker-hostgenerator (0.4.0)
+      deep_merge (~> 1.0)
+      stringify-hash (~> 0.0.0)
+    beaker-pe (0.1.0)
+      stringify-hash (~> 0.0.0)
+    builder (3.2.2)
+    deep_merge (1.0.1)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    docker-api (1.26.2)
+      excon (>= 0.38.0)
+      json
+    excon (0.48.0)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    fission (0.5.0)
+      CFPropertyList (~> 2.2)
+    fog (1.34.0)
+      fog-atmos
+      fog-aws (>= 0.6.0)
+      fog-brightbox (~> 0.4)
+      fog-core (~> 1.32)
+      fog-dynect (~> 0.0.2)
+      fog-ecloud (~> 0.1)
+      fog-google (>= 0.0.2)
+      fog-json
+      fog-local
+      fog-powerdns (>= 0.1.1)
+      fog-profitbricks
+      fog-radosgw (>= 0.0.2)
+      fog-riakcs
+      fog-sakuracloud (>= 0.0.4)
+      fog-serverlove
+      fog-softlayer
+      fog-storm_on_demand
+      fog-terremark
+      fog-vmfusion
+      fog-voxel
+      fog-xml (~> 0.1.1)
+      ipaddress (~> 0.5)
+      nokogiri (~> 1.5, >= 1.5.11)
+    fog-atmos (0.1.0)
+      fog-core
+      fog-xml
+    fog-aws (0.9.2)
+      fog-core (~> 1.27)
+      fog-json (~> 1.0)
+      fog-xml (~> 0.1)
+      ipaddress (~> 0.8)
+    fog-brightbox (0.10.1)
+      fog-core (~> 1.22)
+      fog-json
+      inflecto (~> 0.0.2)
+    fog-core (1.36.0)
+      builder
+      excon (~> 0.45)
+      formatador (~> 0.2)
+    fog-dynect (0.0.3)
+      fog-core
+      fog-json
+      fog-xml
+    fog-ecloud (0.3.0)
+      fog-core
+      fog-xml
+    fog-google (0.0.9)
+      fog-core
+      fog-json
+      fog-xml
+    fog-json (1.0.2)
+      fog-core (~> 1.0)
+      multi_json (~> 1.10)
+    fog-local (0.3.0)
+      fog-core (~> 1.27)
+    fog-powerdns (0.1.1)
+      fog-core (~> 1.27)
+      fog-json (~> 1.0)
+      fog-xml (~> 0.1)
+    fog-profitbricks (0.0.5)
+      fog-core
+      fog-xml
+      nokogiri
+    fog-radosgw (0.0.5)
+      fog-core (>= 1.21.0)
+      fog-json
+      fog-xml (>= 0.0.1)
+    fog-riakcs (0.1.0)
+      fog-core
+      fog-json
+      fog-xml
+    fog-sakuracloud (1.7.5)
+      fog-core
+      fog-json
+    fog-serverlove (0.1.2)
+      fog-core
+      fog-json
+    fog-softlayer (1.1.0)
+      fog-core
+      fog-json
+    fog-storm_on_demand (0.1.1)
+      fog-core
+      fog-json
+    fog-terremark (0.1.0)
+      fog-core
+      fog-xml
+    fog-vmfusion (0.1.0)
+      fission
+      fog-core
+    fog-voxel (0.1.0)
+      fog-core
+      fog-xml
+    fog-xml (0.1.2)
+      fog-core
+      nokogiri (~> 1.5, >= 1.5.11)
+    formatador (0.2.5)
+    google-api-client (0.9.4)
+      addressable (~> 2.3)
+      googleauth (~> 0.5)
+      httpclient (~> 2.7)
+      hurley (~> 0.1)
+      memoist (~> 0.11)
+      mime-types (>= 1.6)
+      representable (~> 2.3.0)
+      retriable (~> 2.0)
+      thor (~> 0.19)
+    googleauth (0.5.1)
+      faraday (~> 0.9)
+      jwt (~> 1.4)
+      logging (~> 2.0)
+      memoist (~> 0.12)
+      multi_json (~> 1.11)
+      os (~> 0.9)
+      signet (~> 0.7)
+    hocon (0.9.5)
+    httpclient (2.7.1)
+    hurley (0.2)
+    i18n (0.7.0)
+    inflecto (0.0.2)
+    inifile (2.0.2)
+    ipaddress (0.8.3)
+    json (1.8.3)
+    jwt (1.5.4)
+    kramdown (1.10.0)
+    little-plugger (1.1.4)
+    logging (2.1.0)
+      little-plugger (~> 1.1)
+      multi_json (~> 1.10)
+    logutils (0.6.1)
+    markdown (0.4.0)
+      kramdown (>= 0.13.7)
+      props (>= 0.2.0)
+      textutils (>= 0.2.0)
+    memoist (0.14.0)
+    mime-types (2.99.1)
+    mini_portile2 (2.0.0)
+    minitest (5.8.4)
+    multi_json (1.11.2)
+    multipart-post (2.0.0)
+    net-scp (1.2.1)
+      net-ssh (>= 2.6.5)
+    net-ssh (2.9.4)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    open_uri_redirections (0.2.1)
+    os (0.9.6)
+    props (1.1.2)
+    rake (11.1.2)
+    rbvmomi (1.8.2)
+      builder
+      nokogiri (>= 1.4.1)
+      trollop
+    representable (2.3.0)
+      uber (~> 0.0.7)
+    require_all (1.3.3)
+    retriable (2.1.0)
+    rspec (3.1.0)
+      rspec-core (~> 3.1.0)
+      rspec-expectations (~> 3.1.0)
+      rspec-mocks (~> 3.1.0)
+    rspec-core (3.1.7)
+      rspec-support (~> 3.1.0)
+    rspec-expectations (3.1.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.1.0)
+    rspec-mocks (3.1.3)
+      rspec-support (~> 3.1.0)
+    rspec-support (3.1.2)
+    rsync (1.0.9)
+    rubyzip (1.2.0)
+    signet (0.7.2)
+      addressable (~> 2.3)
+      faraday (~> 0.9)
+      jwt (~> 1.5)
+      multi_json (~> 1.10)
+    simplecov (0.11.2)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    stringify-hash (0.0.2)
+    textutils (1.4.0)
+      activesupport
+      logutils (>= 0.6.1)
+      props (>= 1.1.2)
+      rubyzip (>= 1.0.0)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    trollop (2.1.2)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    uber (0.0.15)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.2)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  beaker (~> 2.22)
+  beaker-hostgenerator
+  markdown (~> 0)
+  mime-types (~> 2.0)
+  rototiller!
+  rspec (~> 3.1.0)
+  simplecov
+  yard (~> 0)
+
+BUNDLED WITH
+   1.11.2

data/LICENSE.md

@@ -0,0 +1,15 @@
+   Copyright 2015 Puppet Labs Inc
+   
+   Puppet Labs can be contacted at: info@puppetlabs.com
+
+   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,57 @@
+# rototiller
+
+A shared rake task library for use at Puppet.
+Goals of Rototiller
+
+* Provide a tool that can house shared rake task code for Puppet Labs.  
+
+* Reduce duplication in rakefiles across projects at Puppet Labs.
+
+* Reduce effort required to write first class rake tasks.
+
+* Reduce time and effort trying to understand requirement to run rake tasks. 
+
+* Provide a standard interface for executing tests in a given test tier regardless of framework (Not MVP)
+
+## Classes & Modules under development
+For more detailed documentation please refer to the yard docs.  
+
+####[EnvVar](lib/rototiller/utilities/env_var.rb)
+
+  A class that tracks the state of an ENV variable.  
+  This class is responsible for formatting its own messaging, the value that should be used, and if a task should stop.  
+    
+####[Flag](lib/rototiller/utilities/flag.rb)
+
+   A class that tracks the desired state of command line flags used in test invocation.  
+   The desired state of these flags is determined by the user.  
+    
+####[ParamCollection](lib/rototiller/utilities/param_collection.rb)
+
+  A class to contain EnvVar and Flag classes.  
+  Behaves similar to an Array.  
+    
+####[RototillerTask](lib/rototiller/task/rototiller_task.rb)
+
+  A class used to build a rake task.  
+  Similar in approach to [RSpec::Core::RakeTask](https://github.com/rspec/rspec-core/blob/master/lib/rspec/core/rake_task.rb)  
+    
+####[CLIFlags](lib/rototiller/task/flags/cli_flags.rb)
+
+  A class to contain the known CLI flags.
+
+## More Documentation
+
+
+Rototiller is documented using yard 
+to view yard docs
+
+First build a local copy of the gem
+
+    $ bundle exec rake build 
+    
+Next start the yard server
+
+    $ bundle exec yard server
+    
+Finally navigate to http://0.0.0.0:8808/ to view the documentation

data/Rakefile

@@ -0,0 +1,56 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+task :default => :test
+
+desc "Run spec tests"
+RSpec::Core::RakeTask.new(:test) do |t|
+  t.rspec_opts = ['--color']
+  t.pattern = 'spec/'
+end
+
+task :generate_host_config do |t, args|
+  if ENV["BEAKER_CONFIG"]
+    next
+  end
+
+  target = ENV["TEST_TARGET"] || 'centos7-64'
+  generate = "bundle exec beaker-hostgenerator"
+  generate += " #{target}"
+  generate += " > acceptance/hosts.cfg"
+  sh generate
+  sh "cat acceptance/hosts.cfg"
+end
+
+task acceptance: :generate_host_config
+
+desc 'Run acceptance tests for Rototiller'
+task :acceptance do |t, args|
+
+  config = ENV["BEAKER_CONFIG"] || 'acceptance/hosts.cfg'
+
+  preserve_hosts = ENV["BEAKER_PRESERVEHOSTS"] || 'never'
+  type = 'pe'
+  keyfile = ENV["BEAKER_KEYFILE"] || "#{ENV['HOME']}/.ssh/id_rsa-acceptance"
+  load_path = ENV["BEAKER_LOADPATH"] || 'acceptance/lib'
+  pre_suite = ENV["BEAKER_PRESUITE"] || 'acceptance/pre-suite'
+  post_suite = ENV["BEAKER_POSTSUITE"] || ''
+  test_suite = ENV["BEAKER_TESTSUITE"] || 'acceptance/tests'
+  opts = ENV["BEAKER_OPTS"] || ''
+
+  beaker = "bundle exec beaker "
+  beaker += " --xml"
+  beaker += " --debug"
+  beaker += " --root-keys"
+  beaker += " --repo-proxy"
+  beaker += " --preserve-hosts #{preserve_hosts}" if preserve_hosts != ''
+  beaker += " --config #{config}" if config != ''
+  beaker += " --type #{type}" if type != ''
+  beaker += " --keyfile #{keyfile}" if keyfile != ''
+  beaker += " --load-path #{load_path}" if load_path != ''
+  beaker += " --pre-suite #{pre_suite}" if pre_suite != ''
+  beaker += " --post-suite #{post_suite}" if post_suite != ''
+  beaker += " --tests #{test_suite}" if test_suite != ''
+  beaker += " #{opts}" if opts != ''
+  sh beaker
+end

data/lib/rototiller.rb

@@ -0,0 +1,2 @@
+require 'rototiller/rake/dsl/dsl_extention'
+require 'rototiller/task/rototiller_task'

data/lib/rototiller/rake/dsl/dsl_extention.rb

@@ -0,0 +1,14 @@
+require 'rototiller/task/rototiller_task'
+
+module Rake
+  module DSL
+
+    def acceptance_task(*args, &block)
+      # Default task description
+      # can be overridden with 'desc' method
+      desc "Tests in the 'Acceptance' tier" unless ::Rake.application.last_comment
+      Rototiller::Task::RototillerTask.define_task :acceptance, &block
+    end
+
+  end
+end

data/lib/rototiller/task/flags/cli_flags.rb

@@ -0,0 +1,7 @@
+module Rototiller
+  module Task
+    module CLIFlags
+      @@cli_flag_names = [:xml, :debug, :root_keys, :repo_proxy, :preserve_hosts, :config, :helper, :type, :keyfile, :options_file, :load_path, :pre_suite, :post_suite, :tests]
+    end
+  end
+end

data/lib/rototiller/task/rototiller_task.rb

@@ -0,0 +1,95 @@
+require 'rototiller/utilities/env_var'
+require 'rototiller/utilities/param_collection'
+require 'rototiller/utilities/env_collection'
+require 'rototiller/utilities/flag_collection'
+require 'rake/tasklib'
+
+module Rototiller
+  module Task
+    class RototillerTask < ::Rake::TaskLib
+      attr_accessor :name
+      attr_accessor :command
+
+      # Whether or not to fail Rake when an error occurs (typically when
+      # examples fail). Defaults to `true`.
+      attr_accessor :fail_on_error
+
+      # A message to print to stderr when there are failures.
+      attr_accessor :failure_message
+
+      def initialize(*args, &task_block)
+        @name          = args.shift
+        @fail_on_error = true
+        @command       = 'echo empty RototillerTask. You should define a command, send a block, or EnvVar to track.'
+        # rake's in-task implied method is true when using --verbose
+        @verbose       = verbose == true
+        @env_vars      = EnvCollection.new
+        @flags         = FlagCollection.new
+
+        define(args, &task_block)
+      end
+
+      # define_task is included to allow task to work like Rake::Task
+      # using .define_task or .new as appropriate
+      def self.define_task(*args, &task_block)
+        self.new(*args, &task_block)
+      end
+
+      #TODO add arg validation to EnvVar and CommandFlag
+      # add_env(EnvVar.new(), EnvVar.new(), EnvVar.new())
+      # add_env('FOO', 'This is how you use FOO', 'default_value')
+      def add_env(*args)
+        args.all?{ |arg| arg.is_a?(EnvVar)} ? @env_vars.push(*args) : @env_vars.push(EnvVar.new(*args))
+      end
+
+      #TODO add arg validation to CommandFlag
+      # add_flag(CommandFlag.new(), CommandFlag.new(), CommandFlag.new())
+      # add_flag('--foo', 'This is how you use --foo', 'default_value')
+      def add_flag(*args)
+        args.all?{ |arg| arg.is_a?(CommandFlag)} ? @flags.push(*flags) : @flags.push(CommandFlag.new(*args))
+      end
+
+      private
+
+      # @private
+      def run_task
+        puts @flags.format_messages
+        puts @env_vars.format_messages
+        exit if @env_vars.stop?
+
+        command_str = @command << @flags.to_s
+        puts command_str if @verbose
+
+        return if system(command_str)
+        puts failure_message if failure_message
+
+        return unless fail_on_error
+        $stderr.puts "#{command_str} failed" if @verbose
+        exit $?.exitstatus
+      end
+
+      # @private
+      # register the new block w/ run_task call in a rake task
+      #   any block passed is run prior to our command
+      # TODO: probably need pre/post-command block functionality
+      def define(args, &task_block)
+        # Default task description
+        # can be overridden with standard 'desc' DSL method
+        desc "RototillerTask: A Task with optional environment variable and command flag tracking" unless ::Rake.application.last_comment
+
+        task(@name, *args) do |_, task_args|
+          RakeFileUtils.__send__(:verbose, @verbose) do
+            task_block.call(*[self, task_args].slice(0, task_block.arity)) if task_block
+            run_task
+          end
+        end
+      end
+
+      # @private
+      #   for unit testing, we need a shortcut around rake's CLI --verbose
+      def set_verbose(verbosity=true)
+        @verbose = verbosity
+      end
+    end
+  end
+end

data/lib/rototiller/utilities/color_text.rb

@@ -0,0 +1,32 @@
+module ColorText
+
+  # Colors a string of text
+  # @param text [String] the text to color
+  # @param color [Integer] ASCII-code 30-37 http://ascii-table.com/ansi-escape-sequences.php
+  # @return [String] formatted text with color
+  def colorize(text, color)
+    "\e[#{color}m#{text}\e[0m"
+  end
+
+  # Adds yellow color to a string of text
+  # @param text [String] The text to color
+  # @return [String] Text formatted in yellow color
+  def yellow_text(text)
+    colorize(text, 33)
+  end
+
+  # Adds green color to a string of text
+  # @param text [String] The text to color
+  # @return [String] Text formatted in green color
+  def green_text(text)
+    colorize(text, 32)
+  end
+
+  # Adds red color to a string of text
+  # @param text [String] The text to color
+  # @return [String] Text formatted in red color
+  def red_text(text)
+    colorize(text, 31)
+  end
+
+end

data/lib/rototiller/utilities/command_flag.rb

@@ -0,0 +1,35 @@
+require 'rototiller/utilities/color_text'
+
+class CommandFlag
+
+  include ColorText
+
+  # @return [String] the flag to be set on a CLI '-v' or '--verbose'
+  attr_reader :flag
+
+  # @return [true, false, nil, String] the value if any of the flag
+  attr_reader :value
+
+  # Creates a new instance of CommandFlag, holds information about desired state of a CLI flag
+  # @param flag [String] the flag to be set on a CLI '-v' or '--verbose'
+  # @param message [String] the message describing the Flag
+  # @param value [String] the value to use as the value if one is required
+  def initialize(flag, value=nil, message)
+    @flag = flag
+    @message = message
+    @value = value
+  end
+
+  # The formatted message to be displayed to the user
+  # @return [String] the CommandFlag's message, formatted with color
+  def message
+    green_text(@message) << "\n" << describe_flag_state
+  end
+
+  private
+  def describe_flag_state
+    only_flag = "The CLI flag #{@flag} will be used, no value was provided."
+    flag_with_value = "The CLI flag #{@flag} will be used with value #{@value}."
+    green_text(@value.nil? ? only_flag : flag_with_value)
+  end
+end

data/lib/rototiller/utilities/env_collection.rb

@@ -0,0 +1,15 @@
+require 'rototiller/utilities/param_collection'
+
+class EnvCollection < ParamCollection
+
+  def push(*args)
+    check_classes(EnvVar, *args)
+    super
+  end
+
+  # Do any of the contents of this ParamCollection require the task to stop
+  # @return [true, nil] should the values of this ParamCollection stop the task
+  def stop?
+    @collection.any?{ |param| param.stop }
+  end
+end

data/lib/rototiller/utilities/env_var.rb

@@ -0,0 +1,62 @@
+require 'rototiller/utilities/color_text'
+
+class EnvVar
+
+  include ColorText
+
+  attr_accessor :var, :message, :default
+
+  # @return [Symbol] the debug level of the message, ':warning', ':error', ':info'
+  attr_reader :message_level
+
+  # @return [true, nil] if the state of the EnvVar requires the task to stop
+  attr_reader :stop
+
+  # Creates a new instance of EnvVar, holds information about the ENV in the environment
+  # @param var [String] the ENV in the environment, 'HOME'
+  # @param message [String] the message describing the ENV
+  # @param default [String] the value to use as the default if the ENV is not present
+  def initialize(var, default=false, message)
+    @var = var
+    @message = message
+    @default = default
+    set_message_level
+  end
+
+  # The value of the ENV determined by the EnvVar class
+  # @return [String] the value determined by the EnvVar class
+  def value
+    ENV[@var] || @default
+  end
+
+  # The formatted message to be displayed to the user
+  # @return [String] the EnvVar's message, formatted for color and meaningful to the state of the EnvVAr
+  def message
+    if message_level == :error
+      red_text("The ENV #{@var} is required, #{@message}")
+    elsif message_level == :info
+      green_text("The ENV #{@var} was found in the environment with the value #{value}")
+    elsif message_level == :warning
+      yellow_text("WARNING: the ENV #{@var} is not set, proceeding with default value: #{@default}")
+    end
+  end
+
+  private
+  def check
+    ENV.key?(@var)
+  end
+
+  def set_message_level
+    if !@default && !check
+      # ENV is not Present and it has no default value
+      @message_level = :error
+      @stop = true
+    elsif !@default && check || @default && check
+      # ENV is present and it has no default value
+      @message_level = :info
+    elsif @default && !check
+      # ENV is not present and it has default value
+      @message_level = :warning
+    end
+  end
+end

data/lib/rototiller/utilities/flag_collection.rb

@@ -0,0 +1,26 @@
+require 'rototiller/utilities/param_collection'
+
+class FlagCollection < ParamCollection
+
+  def push(*args)
+    check_classes(CommandFlag, *args)
+    super
+  end
+
+  # Joins contents into a String, works with no value flags and flags with value
+  # @return [String] flags formatted into a single string
+  def to_s
+
+    flag_str = String.new
+
+    @collection.each do |flag|
+      if flag.value.nil?
+        flag_str << ' ' << flag.flag
+      else
+        flag_str << ' ' << flag.flag << ' ' << flag.value
+      end
+    end
+
+    flag_str
+  end
+end

data/lib/rototiller/utilities/param_collection.rb

@@ -0,0 +1,67 @@
+require 'rototiller/utilities/command_flag'
+require 'rototiller/utilities/env_var'
+require 'forwardable'
+
+class ParamCollection
+
+  # This may be useful if we use individual ParamCollection objects for EnvVars and Flags
+  extend Forwardable
+
+  def_delegators :@collection, :clear, :delete_if, :include?, :include, :inspect, :push
+
+  # collect a given task's params
+  def initialize
+    @collection = []
+  end
+
+  # format the messages inside this ParamCollection
+  # @param [Hash] filters any method from EnvVar can be used as a key
+  # @option filters [String, false, true] :stop the value of the return from .stop on EnvVar
+  # @option filters [String, false, true] :message_level the value of the return from .message_level on EnvVar
+  # @option filters [String, false, true] :default the value of the return from .default on EnvVar
+  # @option filters [String, false, true] :message the value of the return from .message on EnvVar
+  # @option filters [String, false, true] :var the value of the return from .var on EnvVar
+  # @return [String] messages from the contents of this ParamCollection, formatted with new lines and color
+  # @example Get the messages where :stop is true & :message_level is :warning
+    'format_message({:stop => true, :message_level => :warning})'
+  def format_messages(filters=nil)
+
+    formatted_message = String.new
+    build_message = lambda { |param| formatted_message << param.message << "\n"}
+    filters ? filter_contents(filters).each(&build_message) : @collection.each(&build_message)
+    formatted_message
+  end
+
+  def filter_contents(filters={})
+
+    filtered = []
+
+    @collection.each do |param|
+
+      filtered.push(param) if filters.all? do |method, value|
+
+        if param.respond_to?(method)
+          if param.send(method).nil?
+            value.nil?
+          else
+            param.send(method).to_s =~ /#{value.to_s}/
+          end
+        end
+      end
+    end
+    filtered
+  end
+
+  def check_classes(allowed_klass, *args)
+
+    args.each do |arg|
+
+      unless arg.is_a?(allowed_klass)
+        argument_error = "Argument was of class #{arg.class}, Can only be of class #{allowed_klass}"
+        raise(ArgumentError, argument_error)
+      end
+    end
+  end
+
+  private :filter_contents, :check_classes
+end

data/lib/rototiller/version.rb

@@ -0,0 +1,5 @@
+module Rototiller
+  module Version
+    STRING = '0.0.0.b'
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,41 @@
+if ENV["COVERAGE"]
+  require 'simplecov'
+  SimpleCov.start do
+    add_filter '/spec/'
+    add_filter '.bundle/gems'
+  end
+end
+
+require 'rspec'
+require 'rototiller'
+
+def random_string
+  (0...10).map { ('a'..'z').to_a[rand(26)] }.join
+end
+
+def set_random_env
+  name = unique_env
+  ENV[name] = random_string
+  return name
+end
+
+def unique_env
+  env = random_string
+  env = random_string until !ENV[env]
+  return env
+end
+
+def with_captured_stdout
+  begin
+    old_stdout = $stdout
+    $stdout = StringIO.new('','w')
+    yield
+    $stdout.string
+  ensure
+    $stdout = old_stdout
+  end
+end
+
+RSpec.configure do |config|
+  config.include Rake::DSL
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: rototiller
+version: !ruby/object:Gem::Version
+  version: 0.0.0.b
+platform: ruby
+authors:
+- Puppetlabs
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+description: Puppetlabs tool for building rake tasks
+email:
+- qa@puppetlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
+- README.md
+- Rakefile
+- lib/rototiller.rb
+- lib/rototiller/rake/dsl/dsl_extention.rb
+- lib/rototiller/task/flags/cli_flags.rb
+- lib/rototiller/task/rototiller_task.rb
+- lib/rototiller/utilities/color_text.rb
+- lib/rototiller/utilities/command_flag.rb
+- lib/rototiller/utilities/env_collection.rb
+- lib/rototiller/utilities/env_var.rb
+- lib/rototiller/utilities/flag_collection.rb
+- lib/rototiller/utilities/param_collection.rb
+- lib/rototiller/version.rb
+- spec/spec_helper.rb
+homepage: https://github.com/puppetlabs/rototiller
+licenses:
+- Apache-2.0
+metadata: {}
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.2
+signing_key: 
+specification_version: 4
+summary: Puppetlabs rake tool
+test_files: []
+has_rdoc: