Sha256: dc6c11b3cc1b94074a255a71472215c55baa7db45a7318a4b02d9802da9c05b0

Contents?: true

Size: 1.75 KB

Versions: 17

Compression:

Stored size: 1.75 KB

Contents

module CMSScanner
  module Finders
    # Unique Finders container
    #
    # This class is designed to return a unique result such as a version
    # Note: Finders contained can return multiple results but the #run will only
    # returned the best finding
    class UniqueFinders < IndependentFinders
      # @param [ Hash ] opts
      # @option opts [ Symbol ] :mode :mixed, :passive or :aggressive
      # @option opts [ Int ] :confidence_threshold  If a finding's confidence reaches this value,
      #                                             it will be returned as the best finding.
      #                                             Default is 100.
      #                                             If <= 0, all finders will be ran.
      #
      # @return [ Object, false ] The best finding or false if none
      def run(opts = {})
        opts[:confidence_threshold] ||= 100

        symbols_from_mode(opts[:mode]).each do |symbol|
          each do |finder|
            [*finder.send(symbol, opts.merge(found: findings))].compact.each do |found|
              findings << found
            end

            next if opts[:confidence_threshold] <= 0

            findings.each { |f| return f if f.confidence >= opts[:confidence_threshold] }
          end
        end

        best_finding(findings)
      end

      # @param [ Array<Object> ] findings
      #
      # @return [ Object, false ] The best finding or false if none
      def best_finding(findings)
        # results are sorted by confidence ASC
        findings.sort_by!(&:confidence)

        # If all findings have the same confidence, false is returned
        return false if findings.size > 1 && findings.first.confidence == findings.last.confidence

        findings.last || false
      end
    end
  end
end

Version data entries

17 entries across 17 versions & 1 rubygems

Version Path
cms_scanner-0.0.33 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.32 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.31 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.30 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.29 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.28 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.27 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.26 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.25 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.24 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.23 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.22 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.21 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.20 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.19 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.18 lib/cms_scanner/finders/unique_finders.rb
cms_scanner-0.0.17 lib/cms_scanner/finders/unique_finders.rb