right_develop 1.2.2 → 2.0.1

data/.ruby-version

@@ -0,0 +1 @@
+1.8.7-p371

data/CHANGELOG.rdoc

@@ -1,3 +1,8 @@
 == 1.0
 
-Initial release calved from RightSupport.
+Initial release calved from RightSupport.
+
+== 2.0
+
+Delegated reusable RightDevelop::Git functionality to right_git gem, removed
+local class definitions. Some developer-specific git behavior remains.

data/Rakefile

@@ -11,6 +11,8 @@ require 'rspec/core/rake_task'
 require 'cucumber/rake/task'
 
 # We use RightDevelop's CI harness in its own Rakefile. Hooray dogfood!
+lib_dir = File.expand_path('../lib', __FILE__)
+$: << lib_dir unless $:.include?(lib_dir)
 require 'right_develop'
 
 # But, we have a very special need, because OUR Cucumbers need to run with a pristine
@@ -62,10 +64,10 @@ Jeweler::Tasks.new do |gem|
   gem.files.exclude "spec/**/*"
 end
 
-# This is a closed-source gem; omit gemcutter tasks so people don't accidentally
-# push this gem to the public!
-#Jeweler::RubygemsDotOrgTasks.new
+Jeweler::RubygemsDotOrgTasks.new
 
 CLEAN.include('pkg')
 
 RightDevelop::CI::RakeTask.new
+RightDevelop::Git::RakeTask.new
+RightDevelop::S3::RakeTask.new

data/VERSION

@@ -1 +1 @@
-1.2.2
+2.0.1

data/lib/right_develop/ci/java_spec_formatter.rb

@@ -25,7 +25,7 @@ require 'time'
 require 'builder'
 
 # Try to load RSpec 2.x - 1.x formatters
-['rspec/core', 'spec', 'rspec/core/formatters/base_text_formatter', 'spec/runner/formatter/base_text_formatter'].each do |f|
+['rspec/core', 'spec', 'rspec/core/formatters/base_formatter', 'spec/runner/formatter/base_text_formatter'].each do |f|
   begin
     require f
   rescue LoadError

data/lib/right_develop/commands/git.rb

@@ -1,3 +1,27 @@
+#
+# Copyright (c) 2013 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'right_git'
+require 'right_develop'
 require "action_view"
 
 module RightDevelop::Commands
@@ -46,8 +70,10 @@ EOS
 
       case task
       when "prune"
-        git = RightDevelop::Git::Repository.new(Dir.pwd)
-        self.new(git, :prune, options)
+        repo = ::RightGit::Repository.new(
+          ::Dir.pwd,
+          ::RightDevelop::Utility::Git::DEFALT_REPO_OPTIONS)
+        self.new(repo, :prune, options)
       else
         Trollop.die "unknown task #{task}"
       end

data/lib/right_develop/git/rake_task.rb

@@ -0,0 +1,102 @@
+#
+# Copyright (c) 2013 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# Make sure the rest of RightDevelop & Gitis required, since this file can be
+# required directly.
+require 'right_develop/git'
+
+# Once this file is required, the Rake DSL is loaded - don't do this except inside Rake!!
+require 'rake/tasklib'
+
+module RightDevelop::Git
+
+  class RakeTask < ::Rake::TaskLib
+    DEFAULT_OPTIONS = {
+      :git_namespace      => :git,
+      :pre_checkout_step  => nil,
+      :post_checkout_step => nil,
+      :pre_verify_step    => nil,
+      :post_verify_step   => nil,
+    }
+
+    include ::Rake::DSL if defined?(::Rake::DSL)
+
+    attr_accessor :git_namespace
+    attr_accessor :pre_checkout_step, :post_checkout_step
+    attr_accessor :pre_verify_step, :post_verify_step
+
+    def initialize(options = {})
+      # Let client provide options object-style, in our initializer
+      options = DEFAULT_OPTIONS.merge(options)
+      self.git_namespace = options[:git_namespace]
+      self.pre_checkout_step = options[:pre_checkout_step]
+      self.post_checkout_step = options[:post_checkout_step]
+      self.pre_verify_step = options[:pre_verify_step]
+      self.post_verify_step = options[:post_verify_step]
+
+      # Let client provide options DSL-style by calling our writers
+      yield(self) if block_given?
+
+      namespace self.git_namespace do
+
+        desc "Perform 'git submodule update --init --recursive'"
+        task :setup do
+          git.setup
+        end
+
+        desc "If HEAD is a branch or tag ref, ensure that all submodules are checked out to the same tag or branch or ensure consistency for SHA"
+        task :verify, [:revision, :base_dir] do |_, args|
+          revision = args[:revision].to_s.strip
+          base_dir = args[:base_dir].to_s.strip
+          revision = nil if revision.empty?
+          base_dir = '.' if base_dir.empty?
+          ::Dir.chdir(base_dir) do
+            pre_verify_step.call(revision) if pre_verify_step
+            git.verify_revision(revision)
+            post_verify_step.call(revision) if post_verify_step
+          end
+        end
+
+        desc "Checkout supermodule and all submodules to given tag, branch or SHA"
+        task :checkout, [:revision, :base_dir] do |_, args|
+          revision = args[:revision].to_s.strip
+          base_dir = args[:base_dir].to_s.strip
+          raise ::ArgumentError, 'revision is required' if revision.empty?
+          base_dir = '.' if base_dir.empty?
+          ::Dir.chdir(base_dir) do
+            pre_checkout_step.call(revision) if pre_checkout_step
+            git.checkout_revision(revision, :force => true, :recursive => true)
+            post_checkout_step.call(revision) if post_checkout_step
+          end
+        end
+
+      end # namespace
+    end # initialize
+
+    private
+
+    def git
+      ::RightDevelop::Utility::Git
+    end
+
+  end # RakeTask
+end # RightDevelop::Git

data/lib/right_develop/git.rb

@@ -1,22 +1,30 @@
-module RightDevelop
-  module Git
-    # A Git command failed unexpectedly.
-    class CommandError < StandardError
-      attr_reader :output
+#
+# Copyright (c) 2013 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-      def initialize(message)
-        @output = message
-        lines = message.split("\n").map { |l| l.strip }.reject { |l| l.empty? }
-        super(lines.last || @output)
-      end
-    end
+# ancestor
+require 'right_develop'
 
-    # A Git command's output did not match with expected output.
-    class FormatError < StandardError; end
+module RightDevelop
+  module Git
+    autoload :RakeTask, 'right_develop/git/rake_task'
   end
-
-  require "right_develop/git/branch"
-  require "right_develop/git/branch_collection"
-  require "right_develop/git/commit"
-  require "right_develop/git/repository"
-end
+end

data/lib/right_develop/parsers/sax_parser.rb

@@ -1,9 +1,18 @@
-require 'xml/libxml'
-require 'active_support/inflector'
-require 'right_develop/parsers/xml_post_parser.rb'
-
 module RightDevelop::Parsers
   class SaxParser
+    begin
+      # libxml-ruby requires a C library and headers to be available before it will install; thus,
+      # we do not call it out as a gemspec dependency
+      require 'xml/libxml'
+
+      # ActiveSupport is not a runtime
+      require 'active_support/inflector'
+
+      AVAILABLE = true
+    rescue LoadError => e
+      AVAILABLE = false
+    end
+
     extend XmlPostParser
 
     # Parses XML into a ruby hash
@@ -14,6 +23,10 @@ module RightDevelop::Parsers
     #   the return content of the initial xml parser.
     # @return [Array or Hash] returns rubified XML in Hash and Array format
     def self.parse(text, opts = {})
+      unless AVAILABLE
+        raise NotImplementedError, "#{self.name} is unavailable on this system because libxml-ruby and/or active_support are not installed"
+      end
+
       # Parse the xml text
       # http://libxml.rubyforge.org/rdoc/
       xml           = ::XML::SaxParser::string(text)
@@ -32,6 +45,10 @@ module RightDevelop::Parsers
     end
 
     def initialize
+      unless AVAILABLE
+        raise NotImplementedError, "#{self.name} is unavailable on this system because libxml-ruby and/or active_support are not installed"
+      end
+
       @tag  = {}
       @path = []
     end
@@ -136,4 +153,4 @@ module RightDevelop::Parsers
     def on_end_document
     end
   end
-end
+end

data/lib/right_develop/parsers/xml_post_parser.rb

@@ -1,7 +1,12 @@
-require 'active_support/inflector'
-
 module RightDevelop::Parsers
   module XmlPostParser
+    begin
+      require 'active_support/inflector'
+
+      AVAILABLE = true
+    rescue LoadError => e
+      AVAILABLE = false
+    end
 
     # Parses a rubified XML hash/array, removing the top level xml tag, along with
     # any arrays encoded with singular/plural for parent/child nodes.
@@ -40,6 +45,10 @@ module RightDevelop::Parsers
     # @return [Array or Hash] returns a ruby Array or Hash with top level xml tags removed,
     #   as well as any extra XML encoded array tags.
     def self.remove_nesting(xml_object)
+      unless AVAILABLE
+        raise NotImplementedError, "#{self.name} is unavailable on this system because libxml-ruby and/or active_support are not installed"
+      end
+
       if xml_object.length != 1 || (!xml_object.is_a?(Hash) && !xml_object.is_a?(Array))
         raise ArgumentError, "xml_object format doesn't have a single top level entry"
       end

data/lib/right_develop/parsers.rb

@@ -6,5 +6,5 @@ module RightDevelop
   end
 end
 
-# Explicitly require everything else to avoid overreliance on autoload (1-module-deep rule)
+require 'right_develop/parsers/xml_post_parser.rb'
 require 'right_develop/parsers/sax_parser.rb'

data/lib/right_develop/s3/interface.rb

@@ -0,0 +1,298 @@
+#
+# Copyright (c) 2013 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'right_aws'
+
+module RightDevelop
+  module S3
+
+    # Provides a Ruby OOP interface to Amazon S3.
+    #
+    # Note: filters are used as options for multiple storage actions below and
+    # refers to an array of Regexp or wildcard-style filter strings
+    # (e.g. '*.txt'). they are used to match file paths relative to a given
+    # subdirectory or else from the root of the bucket or directory on disk).
+    class Interface
+      NO_SLASHES_REGEXP = /^[^\/]+$/
+
+      DEFAULT_OPTIONS = {
+        :filters => nil,
+        :subdirectory => nil,
+        :recursive => true,
+        :aws_access_key_id => nil,
+        :aws_secret_access_key => nil,
+        :logger => nil
+      }.freeze
+
+      # @option options [String] :aws_access_key_id defaults to using env var value
+      # @option options [String] :aws_secret_access_key defaults to using env var value
+      # @option options [Logger] :logger or nil to log to STDOUT
+      def initialize(options={})
+        options = DEFAULT_OPTIONS.merge(options)
+
+        aws_access_key_id  = options[:aws_access_key_id]
+        aws_secret_access_key = options[:aws_secret_access_key]
+        unless aws_access_key_id && aws_secret_access_key
+          raise ::ArgumentError,
+                'Missing one or both mandatory options - :aws_access_key_id and :aws_secret_access_key'
+        end
+
+        @logger = options[:logger] || Logger.new(STDOUT)
+        @s3 = ::RightAws::S3Interface.new(aws_access_key_id, aws_secret_access_key, :logger => @logger)
+      end
+
+      attr_accessor :logger
+
+      # Lists the files in the given bucket.
+      #
+      # @param [String] bucket to query
+      # @option options [String] :subdirectory to start from or nil
+      # @option options [TrueClass|FalseClass] :recursive true if recursive (default)
+      # @option options [Array] :filters for returned paths or nil or empty
+      # @return [Array] list of relative file paths or empty
+      def list_files(bucket, options={})
+        options = DEFAULT_OPTIONS.dup.merge(options)
+        prefix = normalize_subdirectory_path(options[:subdirectory])
+        filters = normalize_filters(options)
+        files = []
+        trivial_filters = filters.select { |filter| filter.is_a?(String) }
+        if trivial_filters.empty?
+          @s3.incrementally_list_bucket(bucket, 'prefix' => prefix) do |response|
+            incremental_files = response[:contents].map do |details|
+              details[:key][(prefix.length)..-1]
+            end
+            files += filter_files(incremental_files, filters)
+          end
+        else
+          trivial_filters.each do |filename|
+            begin
+              # use head to query file existence.
+              @s3.head(bucket, "#{prefix}#{filename}")
+              files << filename
+            rescue RightAws::AwsError => e
+              # do nothing if file not found
+              raise unless '404' == e.http_code
+            end
+          end
+        end
+        return files
+      end
+
+      # Downloads all files from the given bucket to the given directory.
+      #
+      # @param [String] bucket for download
+      # @param [String] to_dir_path source directory to upload
+      # @option options [String] :subdirectory to start from or nil
+      # @option options [TrueClass|FalseClass] :recursive true if recursive (default)
+      # @option options [Array] :filters for returned paths or nil or empty
+      # @return [Fixnum] count of uploaded files
+      def download_files(bucket, to_dir_path, options={})
+        options = DEFAULT_OPTIONS.dup.merge(options)
+        prefix = normalize_subdirectory_path(options[:subdirectory])
+        files = list_files(bucket, options)
+        if files.empty?
+          logger.info("No files found in \"#{bucket}/#{prefix}\"")
+        else
+          logger.info("Downloading #{files.count} files...")
+          prefix = normalize_subdirectory_path(options[:subdirectory])
+          downloaded = 0
+          files.each do |path|
+            key = "#{prefix}#{path}"
+            to_file_path = File.join(to_dir_path, path)
+            parent_path = File.dirname(to_file_path)
+            FileUtils.mkdir_p(parent_path) unless File.directory?(parent_path)
+
+            disk_file = to_file_path
+            file_md5 = File.exist?(disk_file) && Digest::MD5.hexdigest(File.read(disk_file))
+
+            if file_md5
+              head = @s3.head(bucket, key) rescue nil
+              key_md5 = head && head['etag'].gsub(/[^0-9a-fA-F]/, '')
+              skip = (key_md5 == file_md5)
+            end
+
+            if skip
+              logger.info("Skipping #{bucket}/#{key} (identical contents)")
+            else
+              logger.info("Downloading #{bucket}/#{key}")
+              ::File.open(to_file_path, 'wb') do |f|
+                @s3.get(bucket, key) { |chunk| f.write(chunk) }
+              end
+              downloaded += 1
+            end
+
+            logger.info("Downloaded to \"#{to_file_path}\"")
+          end
+        end
+
+        downloaded
+      end
+
+      # Uploads all files from the given directory (ignoring any empty
+      # directories) to the given bucket.
+      #
+      # @param [String] bucket for upload
+      # @param [String] from_dir_path source directory to upload
+      # @option options [String] :subdirectory to start from or nil
+      # @option options [TrueClass|FalseClass] :recursive true if recursive (default)
+      # @option options [Array] :filters for returned paths or nil or empty
+      # @option options [String] :visibility for uploaded files, defaults to 'public-read'
+      # @return [Fixnum] count of downloaded files
+      def upload_files(bucket, from_dir_path, options={})
+        Dir.chdir(from_dir_path) do
+          logger.info("Working in #{Dir.pwd.inspect}")
+          options = DEFAULT_OPTIONS.dup.merge(options)
+          prefix = normalize_subdirectory_path(options[:subdirectory])
+          filters = normalize_filters(options)
+          pattern = options[:recursive] ? '**/*' : '*'
+          files = Dir.glob(pattern).select { |path| File.file?(path) }
+          filter_files(files, filters)
+          access = normalize_access(options)
+          uploaded = 0
+          files.each do |path|
+            key = "#{prefix}#{path}"
+            file_md5 = Digest::MD5.hexdigest(File.read(path))
+            File.open(path, 'rb') do |f|
+              head = @s3.head(bucket, key) rescue nil
+              key_md5 = head && head['etag'].gsub(/[^0-9a-fA-F]/, '')
+
+              if file_md5 == key_md5
+                logger.info("Skipping #{bucket}/#{key} (identical contents)")
+              else
+                logger.info("Uploading to #{bucket}/#{key}")
+                @s3.put(bucket, key, f, 'x-amz-acl' => access)
+                uploaded += 1
+              end
+            end
+          end
+
+          uploaded
+        end
+      end
+
+      # Deletes all files from the given bucket.
+      #
+      # @param [String] bucket for delete
+      # @option options [String] :subdirectory to start from or nil
+      # @option options [TrueClass|FalseClass] :recursive true if recursive (default)
+      # @option options [Regexp] :filter for files to delete or nil
+      # @return [Fixnum] count of deleted files
+      def delete_files(bucket, options={})
+        options = DEFAULT_OPTIONS.dup.merge(options)
+        prefix = normalize_subdirectory_path(options[:subdirectory])
+        files = list_files(bucket, options)
+        if files.empty?
+          logger.info("No files found in \"#{bucket}/#{prefix}\"")
+        else
+          logger.info("Deleting #{files.count} files...")
+          files.each do |path|
+            @s3.delete(bucket, "#{prefix}#{path}")
+            logger.info("Deleted \"#{bucket}/#{prefix}#{path}\"")
+          end
+        end
+        return files.size
+      end
+
+      protected
+
+      # Normalizes a relative file path for use with S3.
+      #
+      # @param [String] subdirectory
+      def normalize_file_path(path)
+        # remove leading and trailing slashes and change any multiple slashes to single.
+        return (path || '').gsub("\\", '/').gsub(/^\/+/, '').gsub(/\/+$/, '').gsub(/\/+/, '/')
+      end
+
+      # Normalizes subdirectory path for use with S3.
+      #
+      # @param [String] path
+      # @return [String] normalized path
+      def normalize_subdirectory_path(path)
+        path = normalize_file_path(path)
+        path += '/' unless path.empty?
+        return path
+      end
+
+      # Normalizes storage filters from options.
+      #
+      # @option options [Array] :filters for returned paths or nil or empty
+      def normalize_filters(options)
+        initial_filters = Array(options[:filters])
+        normalized_filters = nil
+
+        # support trivial filters as simple string array for direct lookup of
+        # one or more S3 object (since listing entire buckets can be slow).
+        # recursion always requires a listing so that cannot be trivial.
+        if !options[:recursive] && initial_filters.size == 1
+          # filter is trivial unless it contains wildcards. more than one
+          # non-wildcard filenames delimited by semicolon can be trivial.
+          filter = initial_filters.first
+          if filter.kind_of?(String) && filter == filter.gsub('*', '').gsub('?', '')
+            normalized_filters = filter.split(';').uniq
+          end
+        end
+        unless normalized_filters
+          normalized_filters = []
+          normalized_filters << NO_SLASHES_REGEXP unless options[:recursive]
+          initial_filters.each do |filter|
+            if filter.kind_of?(String)
+              # split on semicolon (;) and OR the result into one regular expression.
+              # example: "*.tar;*.tgz;*.zip" -> /^.*\.tar|.*\.tgz|.*\.zip$/
+              #
+              # convert wildcard-style filter string (e.g. '*.txt') to Regexp.
+              escaped = Regexp.escape(filter).gsub("\\*", '.*').gsub("\\?", '.').gsub(';', '|')
+              regexp = Regexp.compile("^#{escaped}$")
+              filter = regexp
+            end
+            normalized_filters << filter unless normalized_filters.index(filter)
+          end
+        end
+        return normalized_filters
+      end
+
+      # Normalizes access from options (for uploading files).
+      #
+      # Note: access strings are AWS S3-style but can easily be mapped to any
+      # bucket storage implementation which supports ACLs.
+      #
+      # @option options [String] :access requested ACL or nil for public-read
+      # @return @return [String] normalized access
+      def normalize_access(options)
+        access = options[:access].to_s.empty? ? nil : options[:access]
+        return access || 'public-read'
+      end
+
+      # Filters the given list of file paths using the given filters, if any.
+      #
+      # @param [Array] files to filter
+      # @param [Array] filters for matching or empty
+      # @return [Array] filtered files
+      def filter_files(files, filters)
+        return files if filters.empty?
+
+        # select each path only if it matches all filters.
+        return files.select { |path| filters.all? { |filter| filter.match(path) } }
+      end
+
+    end  # Interface
+  end  # Buckets
+end  # RightDevelop