ra10ke 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b40e69bd38407cb3c0e54c36a83cdc1699ac85ea8512118275bce2f9e8dc6ef
-  data.tar.gz: 4cedb006d2cf6591280e75df20fcf33ba4abdd5f8647caf68497f13c53c05f36
+  metadata.gz: 64e7e73cfb508697efd25e4aec36655c126a168a81fca44345f6564929be6bcd
+  data.tar.gz: 2139cb8c668b255a04d975121014006bd94cc4a4b45d71008e37e9e1341c74d6
 SHA512:
-  metadata.gz: 0d87d64c5635eb697987a69e3ce56dcb230175f43182ee67e54817da51624c07426ad5f7c82b6f31c896ef88e2ed2132584c5dfc4d085c591e9336fc1d5fc6b3
-  data.tar.gz: 84247260dbf741c18cd0aef1888b40f07328c015b228f1c021ae15c1d8846497819bbe6a6226e51cfe43697e84707c4d0a827f57796a6e73cce76015b354272a
+  metadata.gz: d05765b4c95390301ec8c6e0917f251ee60333b09810174c643d1d6a5608824ee96c46d334f60232beb026ea28caa4c4c5ea0e1e6b72b0f12ff7c7fdda6783b4
+  data.tar.gz: dc0317d3c47ce2e18e9c8818d7dd468f0acdd8e5a8047dad637938f40745196c66369ac4741293e092f8ab28e6a115aec70e936ea8845cb133c6f1f9108a0cd0

data/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "bundler" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"

data/.github/workflows/release.yml

@@ -0,0 +1,32 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'voxpupuli'
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Ruby 3.0
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.0'
+        env:
+          BUNDLE_WITHOUT: release
+      - name: Build gem
+        run: gem build *.gemspec
+      - name: Publish gem to rubygems.org
+        run: gem push *.gem
+        env:
+          GEM_HOST_API_KEY: '${{ secrets.RUBYGEMS_AUTH_TOKEN }}'
+      - name: Setup GitHub packages access
+        run: |
+          mkdir -p ~/.gem
+          echo ":github: Bearer ${{ secrets.GITHUB_TOKEN }}" >> ~/.gem/credentials
+          chmod 0600 ~/.gem/credentials
+      - name: Publish gem to GitHub packages
+        run: gem push --key github --host https://rubygems.pkg.github.com/voxpupuli *.gem

data/.github/workflows/test.yml

@@ -0,0 +1,35 @@
+name: Test
+
+on:
+  - pull_request
+  - push
+
+env:
+  BUNDLE_WITHOUT: release
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - ruby: "2.4"
+          - ruby: "2.5"
+          - ruby: "2.6"
+          - ruby: "2.7"
+          - ruby: "3.0"
+            coverage: "yes"
+    env:
+      COVERAGE: ${{ matrix.coverage }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install Ruby ${{ matrix.ruby }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake
+      - name: Build gem
+        run: gem build *.gemspec

data/.gitignore

@@ -1,3 +1,6 @@
 Gemfile.lock
+coverage
 pkg
 .bundle
+vendor
+.vendor

data/.ruby-version

@@ -1 +1 @@
-2.5.3
+2.5.7

data/.travis.yml

@@ -6,6 +6,7 @@ rvm:
   - '2.3'
   - '2.4'
   - '2.5'
+  - '2.6'
 deploy:
   provider: rubygems
   api_key:

data/CHANGELOG.md

@@ -1,8 +1,36 @@
-CHANGELOG
-=========
+# Changelog
 
-1.0.0
------
+All notable changes to this project will be documented in this file.
+
+## [v1.1.0](https://github.com/voxpupuli/ra10ke/tree/v1.1.0) (2021-10-26)
+
+[Full Changelog](https://github.com/voxpupuli/ra10ke/compare/v1.0.0...v1.1.0)
+
+**Implemented enhancements:**
+
+- Support r10k:validate with control\_branch [\#58](https://github.com/voxpupuli/ra10ke/issues/58)
+- Implement GitHub Actions and fix tests [\#62](https://github.com/voxpupuli/ra10ke/pull/62) ([bastelfreak](https://github.com/bastelfreak))
+- Add handling for additional r10k args in validate for control\_branch [\#61](https://github.com/voxpupuli/ra10ke/pull/61) ([ananace](https://github.com/ananace))
+- Add r10k:deprecation task [\#60](https://github.com/voxpupuli/ra10ke/pull/60) ([ananace](https://github.com/ananace))
+- Support r10k:validate with control\_branch modules [\#59](https://github.com/voxpupuli/ra10ke/pull/59) ([ananace](https://github.com/ananace))
+- allow to add other version formats in dependencies [\#56](https://github.com/voxpupuli/ra10ke/pull/56) ([jduepmeier](https://github.com/jduepmeier))
+- Fixes \#52 - validate task fails when repo does not exist [\#53](https://github.com/voxpupuli/ra10ke/pull/53) ([logicminds](https://github.com/logicminds))
+
+**Fixed bugs:**
+
+- Fix source of control\_branch data [\#63](https://github.com/voxpupuli/ra10ke/pull/63) ([ananace](https://github.com/ananace))
+
+**Closed issues:**
+
+- validate task fails when repo does not exist [\#52](https://github.com/voxpupuli/ra10ke/issues/52)
+
+**Merged pull requests:**
+
+- Add Dependabot config [\#65](https://github.com/voxpupuli/ra10ke/pull/65) ([bastelfreak](https://github.com/bastelfreak))
+- Set minimal Ruby version to 2.4.0 [\#64](https://github.com/voxpupuli/ra10ke/pull/64) ([bastelfreak](https://github.com/bastelfreak))
+- Add coverage reports [\#54](https://github.com/voxpupuli/ra10ke/pull/54) ([logicminds](https://github.com/logicminds))
+
+## [v1.0.0](https://github.com/voxpupuli/ra10ke/tree/v1.0.0) (2020-02-08)
 
 2020-02-08
 
@@ -120,3 +148,6 @@ Many thanks to [Alexander "Ace" Olofsson](https://github.com/ace13) and [James P
 2015-12-07
 
 * Initial release
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/Gemfile

@@ -2,3 +2,12 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in ra10ke.gemspec
 gemspec
+
+group :release do
+  gem 'github_changelog_generator', :require => false
+end
+
+group :coverage, optional: ENV['COVERAGE']!='yes' do
+  gem 'simplecov-console', :require => false
+  gem 'codecov', :require => false
+end

data/HISTORY.md

@@ -0,0 +1,118 @@
+## [v1.0.0](https://github.com/voxpupuli/ra10ke/tree/v1.0.0) (2020-02-08)
+
+2020-02-08
+
+Closed Pull Requests:
+
+* [#44](https://github.com/voxpupuli/ra10ke/pull/44) - Fix the faulty docs for Ra10ke::Validate#all_refs after [#42](https://github.com/voxpupuli/ra10ke/pull/42)
+* [#45](https://github.com/voxpupuli/ra10ke/pull/45) - Add a duplicates check
+* [#48](https://github.com/voxpupuli/ra10ke/pull/48) - Allow semverse 3.x
+
+0.6.2
+-----
+
+2019-08-26
+
+Closed Pull Requests:
+
+* [#42](https://github.com/voxpupuli/ra10ke/pull/42) - Fix lost refs in validation
+
+Again many thanks to the following contributors for submitting PRs:
+
+* [Alexander Olofsson](https://github.com/ananace)
+
+0.6.1
+-----
+
+2019-08-17
+
+Closed Pull Requests:
+
+* [#40](https://github.com/voxpupuli/ra10ke/pull/40) - Fix a fault in the mod handling behaviour
+
+Closed Issues:
+
+* [#25](https://github.com/voxpupuli/ra10ke/issues/25) - Consider making r10k:install have a default path of '.'
+
+Many thanks to the following contributors for submitting PRs:
+
+* [Alexander Olofsson](https://github.com/ananace)
+
+0.6.0
+-----
+
+2019-07-30
+
+Closed Pull Requests:
+
+* [#35](https://github.com/voxpupuli/ra10ke/pull/35) Adds new validate task for verifying the integrity of all modules      specified in the Puppetfile
+* [#33](https://github.com/voxpupuli/ra10ke/pull/33) Refactor tasks, Version tag handling fix, purge option
+* [#32](https://github.com/voxpupuli/ra10ke/pull/32) Make it possible to configure the tasks in the rakefile
+
+Many thanks to the following contributors for submitting PRs:
+
+* [Corey Osman](https://github.com/logicminds)
+* [Andreas Zuber](https://github.com/ZeroPointEnergy)
+
+0.5.0
+-----
+
+2018-12-26
+
+Closed Pull Requests:
+
+* [#22](https://github.com/voxpupuli/ra10ke/pull/22) Add rudimentary r10k:install task
+* [#26](https://github.com/voxpupuli/ra10ke/pull/26) make use of the forge command in puppetfile
+* [#29](https://github.com/voxpupuli/ra10ke/pull/29) Abort (exit 1) if Puppetfile syntax check fails
+* [#30](https://github.com/voxpupuli/ra10ke/pull/30) enable travis deployment
+
+0.4.0
+-----
+
+2018-06-17
+
+* [#13](https://github.com/voxpupuli/ra10ke/pull/13) Avoid using `desired_ref` directly for Git
+* [#14](https://github.com/voxpupuli/ra10ke/pull/14) Set required Ruby version as `>= 2.1.0`
+* [#15](https://github.com/voxpupuli/ra10ke/pull/15) ignore invalid ref
+* [#16](https://github.com/voxpupuli/ra10ke/pull/16) Use Semantic Versioning for Git tags
+* [#17](https://github.com/voxpupuli/ra10ke/pull/17) Be careful around trimming Git tags
+* [#19](https://github.com/voxpupuli/ra10ke/pull/19) Ensure Puppetfile gets parsed with absolute path
+
+Many thanks to the following contributors for submitting the PRs:
+* [Valter Jansons](https://github.com/sigv)
+* [Martin Alfke](https://github.com/tuxmea)
+* [Matthias Baur](https://github.com/baurmatt)
+
+0.3.0
+-----
+
+2017-10-08
+
+* [#6](https://github.com/voxpupuli/ra10ke/pull/6) Add a dependency solver based on the Ruby Solve library (thanks to [Jarkko Oranen](https://github.com/oranenj))
+* [#8](https://github.com/voxpupuli/ra10ke/pull/8) Add numeric tag convention support (thanks to [Hervé MARTIN](https://github.com/HerveMARTIN))
+
+0.2.0
+-----
+
+2017-01-03
+
+* Moved to [Vox Pupuli](https://voxpupuli.org/)
+* [#3](https://github.com/voxpupuli/ra10ke/pull/3) Update ra10ke with r10k 2.4.0 support
+* [#4](https://github.com/voxpupuli/ra10ke/pull/4) Added git support
+
+Many thanks to [Alexander "Ace" Olofsson](https://github.com/ace13) and [James Powis](https://github.com/james-powis) for their contributions!
+
+0.1.1
+-----
+
+2016-08-22
+
+* [#1](https://github.com/tampakrap/ra10ke/issues/1) update docs to mention Gemfile and Rakefile
+* properly advertise the user agent
+
+0.1.0
+-----
+
+2015-12-07
+
+* Initial release

data/README.md

@@ -1,7 +1,12 @@
 ra10ke
 ======
 
-[![Gem Version](https://badge.fury.io/rb/ra10ke.svg)](https://badge.fury.io/rb/ra10ke)
+[![License](https://img.shields.io/github/license/voxpupuli/ra10ke.svg)](https://github.com/voxpupuli/ra10ke/blob/master/LICENSE.txt)
+[![Test](https://github.com/voxpupuli/ra10ke/actions/workflows/test.yml/badge.svg)](https://github.com/voxpupuli/ra10ke/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/voxpupuli/ra10ke/branch/master/graph/badge.svg?token=Mypkl78hvK)](https://codecov.io/gh/voxpupuli/ra10ke)
+[![Release](https://github.com/voxpupuli/ra10ke/actions/workflows/release.yml/badge.svg)](https://github.com/voxpupuli/ra10ke/actions/workflows/release.yml)
+[![RubyGem Version](https://img.shields.io/gem/v/ra10ke.svg)](https://rubygems.org/gems/ra10ke)
+[![RubyGem Downloads](https://img.shields.io/gem/dt/ra10ke.svg)](https://rubygems.org/gems/ra10ke)
 
 Rake tasks related to [R10K](https://github.com/puppetlabs/r10k) and
 [Puppetfile](https://github.com/puppetlabs/r10k/blob/master/doc/puppetfile.mkd).
@@ -145,3 +150,22 @@ gitlab:
 
 Error: Duplicates exist in the Puppetfile
 ```
+
+### r10k:deprecation
+
+This rake task checks all the Forge modules listed in the Puppetfile, looking
+for modules that are marked as deprecated on the Forge.
+
+Example
+
+```
+NAME                    | DEPRECATED_AT            
+------------------------|--------------------------
+kemra102-auditd         | 2021-07-22 12:11:46      
+puppet-staging          | 2018-12-18 11:11:29      
+puppetlabs-resource_api | 2021-03-31 12:53:24      
+puppetlabs-ruby         | 2021-04-22 10:29:42      
+puppetlabs-translate    | 2021-03-19 10:11:51      
+
+Error: Puppetfile contains deprecated modules.
+```

data/Rakefile

@@ -14,3 +14,16 @@ task :default => [:spec]
 RSpec::Core::RakeTask.new(:spec) do |spec|
     spec.pattern = FileList['spec/**/*_spec.rb']
 end
+
+begin
+  require 'github_changelog_generator/task'
+  GitHubChangelogGenerator::RakeTask.new :changelog do |config|
+    version = Ra10ke::VERSION
+    config.future_release = "v#{version}" if version =~ /^\d+\.\d+.\d+$/
+    config.header = "# Changelog\n\nAll notable changes to this project will be documented in this file."
+    config.exclude_labels = %w{duplicate question invalid wontfix wont-fix skip-changelog}
+    config.user = 'voxpupuli'
+    config.project = 'ra10ke'
+  end
+rescue LoadError
+end

data/lib/ra10ke/dependencies.rb

@@ -1,4 +1,34 @@
 module Ra10ke::Dependencies
+  @@version_formats = {}
+
+  # Registers a block that finds the latest version.
+  # The block will be called with a list of tags.
+  # If the block returns nil the next format will be tried.
+  def self.register_version_format(name, &block)
+    @@version_formats[name] = block
+  end
+
+  # semver is the default version format.
+  register_version_format(:semver) do |tags|
+    latest_tag = tags.map do |tag|
+      begin
+        Semverse::Version.new tag[/\Av?(.*)\Z/, 1]
+      rescue Semverse::InvalidVersionFormat
+        # ignore tags that do not comply to semver
+        nil
+      end
+    end.select { |tag| !tag.nil? }.sort.last.to_s.downcase
+    latest_ref = tags.detect { |tag| tag[/\Av?(.*)\Z/, 1] == latest_tag }
+  end
+
+  def get_latest_ref(remote_refs)
+    tags = remote_refs['tags'].keys
+    latest_ref = nil
+    @@version_formats.detect { |_, block| latest_ref = block.call(tags) }
+    latest_ref = 'undef (tags do not follow any known pattern)' if latest_ref.nil?
+    latest_ref
+  end
+
   def define_task_dependencies(*_args)
     desc "Print outdated forge modules"
     task :dependencies do
@@ -44,17 +74,10 @@ module Ra10ke::Dependencies
             # we have to be be opinionated here
             # so semantic versioning (vX.Y.Z) it is for us
             # as well as support for skipping the leading v letter
-            tags = remote_refs['tags'].keys
-            latest_tag = tags.map do |tag|
-              begin
-                Semverse::Version.new tag[/\Av?(.*)\Z/, 1]
-              rescue Semverse::InvalidVersionFormat
-                # ignore tags that do not comply to semver
-                nil
-              end
-            end.select { |tag| !tag.nil? }.sort.last.to_s.downcase
-            latest_ref = tags.detect { |tag| tag[/\Av?(.*)\Z/, 1] == latest_tag }
-            latest_ref = 'undef (tags do not match semantic versioning)' if latest_ref.nil?
+            #
+            # register own version formats with
+            # Ra10ke::Dependencies.register_version_format(:name, &block)
+            latest_ref = get_latest_ref(remote_refs)
           elsif ref.match(/^[a-z0-9]{40}$/)
             # for sha just assume head should be tracked
             latest_ref = remote_refs['head'][:sha]
@@ -66,6 +89,5 @@ module Ra10ke::Dependencies
         end
       end
     end
-
   end
 end

data/lib/ra10ke/deprecation.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require 'ra10ke/puppetfile_parser'
+require 'English'
+require 'puppet_forge'
+require 'table_print'
+require 'time'
+
+module Ra10ke::Deprecation
+  # Validate the git urls and refs
+  def define_task_deprecation(*)
+    desc 'Validate that no forge modules are deprecated'
+    task :deprecation do
+      valid = Ra10ke::Deprecation::Validation.new(get_puppetfile.puppetfile_path)
+      exit_code = 0
+      if valid.bad_mods?
+        exit_code = 1
+        message = "\nError: Puppetfile contains deprecated modules."
+        tp valid.sorted_mods, :name, :deprecated_at
+      else
+        message = 'Puppetfile contains no deprecated Forge modules.'
+      end
+      abort(message) if exit_code.positive?
+
+      puts message
+    end
+  end
+
+  class Validation
+    include Ra10ke::PuppetfileParser
+
+    attr_reader :puppetfile
+
+    def initialize(file)
+      file ||= './Puppetfile'
+      @puppetfile = File.expand_path(file)
+      abort("Puppetfile does not exist at #{puppetfile}") unless File.readable?(puppetfile)
+    end
+
+    # @return [Array[Hash]] array of module information and git status
+    def deprecated_modules
+      @deprecated_modules ||= begin
+        deprecated = forge_modules(puppetfile).map do |mod|
+          # For Ruby 2.4 support
+          begin # rubocop:disable Style/RedundantBegin
+            module_name = "#{mod[:namespace] || mod[:name]}-#{mod[:name]}"
+            forge_data = PuppetForge::Module.find(module_name)
+
+            next forge_data if forge_data.deprecated_at
+
+            nil
+          rescue Faraday::ResourceNotFound
+            nil
+          end
+        end
+        deprecated.compact.map do |mod|
+          { name: mod.slug, deprecated_at: Time.parse(mod.deprecated_at) }
+        end
+      end
+    end
+
+    # @return [Boolean] - true if there are any bad mods
+    def bad_mods?
+      deprecated_modules.any?
+    end
+
+    # @return [Hash] - sorts the mods based on good/bad
+    def sorted_mods
+      deprecated_modules.sort_by { |a| a[:name] }
+    end
+  end
+end

data/lib/ra10ke/git_repo.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require 'tempfile'
+
+module Ra10ke
+  class GitRepo
+    attr_reader :url
+
+    REMOTE_REFS_CMD = 'git ls-remote --symref'
+    CLONE_CMD = 'git clone --no-tags'
+    CURRENT_BRANCH_CMD = 'git symbolic-ref --short HEAD'
+    SHOW_CMD = 'git show'
+
+    def initialize(url)
+      @url = url
+    end
+
+    # Get the current branch for a Git repo
+    # @param path [String] - The path to the repository to check
+    # @return [String] - The current active branch of the Git repo
+    def self.current_branch(path)
+      Dir.chdir(path) do
+        data, success = run_command(CURRENT_BRANCH_CMD)
+        return success ? data.strip : nil
+      end
+    end
+
+    # @return [Array] - the raw data from the git ls-remote command as lines array
+    # return empty array if url or command failed
+    def remote_refs
+      @remote_refs ||= begin
+        data, success = run_command("#{REMOTE_REFS_CMD} #{url}")
+        success ? data.lines : []
+      end
+    end
+
+    # @return [Boolean] true if the git url is valid
+    def valid_url?
+      !remote_refs.empty?
+    end
+
+    # @return [Boolean] - return true if the commit sha is valid
+    # @param url [String] - the git string either https or ssh url
+    # @param ref [String] - the sha id
+    def valid_commit?(sha)
+      return false if sha.nil? || sha.empty?
+      return true if valid_ref?(sha)
+
+      # cloning is a last resort if for some reason we cannot
+      # remotely get via ls-remote
+      Dir.mktmpdir do |dir|
+        run_command("#{CLONE_CMD} #{url} #{dir}", silent: true)
+        Dir.chdir(dir) do
+          _, status = run_command("#{SHOW_CMD} #{sha}", silent: true)
+          status
+        end
+      end
+    end
+
+    # @return [Boolean] - return true if the ref is valid
+    # @param url [String] - the git string either https or ssh url
+    # @param ref [String] - the ref object, branch name, tag name, or commit sha, defaults to HEAD
+    def valid_ref?(ref = 'HEAD')
+      return false if ref.nil?
+
+      found = all_refs.find do |data|
+        # we don't need to bother with these types
+        next if data[:type] == :pull || data[:type] == :merge_request
+
+        # is the name equal to the tag or branch?  Is the commit sha equal?
+        data[:name].eql?(ref) || data[:sha].slice(0, 8).eql?(ref.slice(0, 8))
+      end
+      !found.nil?
+    end
+
+    # @return [Array] - an array of all the refs associated with the remote repository
+    # @param url [String] - the git string either https or ssh url
+    # @example
+    #   [{:sha=>"0ec707e431367bbe2752966be8ab915b6f0da754", :ref=>"refs/heads/74110ac", :type=>:branch, :subtype=>nil, :name=>"74110ac"},
+    #     :sha=>"07bb5d2d94db222dca5860eb29c184e8970f36f4", :ref=>"refs/pull/74/head", :type=>:pull, :subtype=>:head, :name=>"74"},
+    #     :sha=>"156ca9a8ea69e056e86355b27d944e59d1b3a1e1", :ref=>"refs/heads/master", :type=>:branch, :subtype=>nil, :name=>"master"},
+    #     :sha=>"fcc0532bbc5a5b65f3941738339e9cc7e3d767ce", :ref=>"refs/pull/249/head", :type=>:pull, :subtype=>:head, :name=>"249"},
+    #     :sha=>"8d54891fa5df75890ee15d53080c2a81b4960f92", :ref=>"refs/pull/267/head", :type=>:pull, :subtype=>:head, :name=>"267"}]
+    def all_refs
+      @all_refs ||= begin
+        remote_refs.each_with_object([]) do |line, refs|
+          sha, ref = line.split("\t")
+          next refs if sha.eql?('ref: refs/heads/master')
+
+          _, type, name, subtype = ref.chomp.split('/')
+          next refs unless name
+
+          type = :tag if type.eql?('tags')
+          type = type.to_sym
+          subtype = subtype.to_sym if subtype
+          type = :branch if type.eql?(:heads)
+          refs << { sha: sha, ref: ref.chomp, type: type, subtype: subtype, name: name }
+        end
+      end
+    end
+
+    # useful for mocking easily
+    # @param cmd [String]
+    # @param silent [Boolean] set to true if you wish to send output to /dev/null, false by default
+    # @return [Array]
+    def self.run_command(cmd, silent: false)
+      out_args = silent ? '2>&1 > /dev/null' : '2>&1'
+      out = `#{cmd} #{out_args}`
+      [out, $CHILD_STATUS.success?]
+    end
+
+    def run_command(cmd, silent: false)
+      self.class.run_command(cmd, silent: silent)
+    end
+  end
+end

data/lib/ra10ke/puppetfile_parser.rb

@@ -12,6 +12,13 @@ module Ra10ke
         end
       end
 
+      # @return [Array] - returns a array of hashes that contain modules from the Forge
+      def forge_modules(file = puppetfile)
+        modules(file).reject do |mod|
+          mod[:args].key?(:git)
+        end
+      end
+
       # @param puppetfile [String] - the absolute path to the puppetfile
       # @return [Array] - returns an array of module hashes that represent the puppetfile
       # @example