pwn 0.5.508 → 0.5.509

data/lib/pwn/plugins/detect_os.rb

@@ -1,71 +0,0 @@
-# frozen_string_literal: true
-
-require 'os'
-
-module PWN
-  module Plugins
-    # This plugin converts images to readable text
-    module DetectOS
-      # Supported Method Parameters::
-      # PWN::Plugins::DetectOS.type
-
-      public_class_method def self.type
-        os = :cygwin if OS.cygwin?
-        os = :freebsd if OS.freebsd?
-        os = :linux if OS.linux?
-        os = :netbsd if OS.host_os.include?('netbsd')
-        os = :openbsd if OS.host_os.include?('openbsd')
-        os = :osx if OS.osx?
-        os = :windows if OS.windows?
-
-        os
-      rescue StandardError => e
-        raise e
-      end
-
-      # Supported Method Parameters::
-      # PWN::Plugins::DetectOS.arch
-
-      public_class_method def self.arch
-        OS.host_cpu
-      rescue StandardError => e
-        raise e
-      end
-
-      # Supported Method Parameters::
-      # PWN::Plugins::DetectOS.endian
-
-      public_class_method def self.endian
-        if [1].pack('I') == [1].pack('N')
-          :big
-        else
-          :little
-        end
-      rescue StandardError => e
-        raise e
-      end
-
-      # Author(s):: 0day Inc. <support@0dayinc.com>
-
-      public_class_method def self.authors
-        "AUTHOR(S):
-          0day Inc. <support@0dayinc.com>
-        "
-      end
-
-      # Display Usage for this Module
-
-      public_class_method def self.help
-        puts "USAGE:
-          #{self}.type
-
-          #{self}.arch
-
-          #{self}.endian
-
-          #{self}.authors
-        "
-      end
-    end
-  end
-end

data/lib/pwn/plugins/ein.rb

@@ -1,141 +0,0 @@
-# frozen_string_literal: true
-
-module PWN
-  module Plugins
-    # This plugin provides useful employer identification number capabilities
-    module EIN
-      # Supported Method Parameters::
-      # PWN::Plugins::EIN.generate(
-      #   count: 'required - number of EIN numbers to generate'
-      # )
-
-      public_class_method def self.generate(opts = {})
-        count = opts[:count].to_i
-
-        ein_prefix_data_struct = [
-          { campus: :andover, prefix: 10 },
-          { campus: :andover, prefix: 12 },
-          { campus: :atlanta, prefix: 60 },
-          { campus: :atlanta, prefix: 67 },
-          { campus: :austin, prefix: 50 },
-          { campus: :austin, prefix: 53 },
-          { campus: :brookhaven, prefix: 1 },
-          { campus: :brookhaven, prefix: 2 },
-          { campus: :brookhaven, prefix: 3 },
-          { campus: :brookhaven, prefix: 4 },
-          { campus: :brookhaven, prefix: 5 },
-          { campus: :brookhaven, prefix: 6 },
-          { campus: :brookhaven, prefix: 11 },
-          { campus: :brookhaven, prefix: 13 },
-          { campus: :brookhaven, prefix: 14 },
-          { campus: :brookhaven, prefix: 16 },
-          { campus: :brookhaven, prefix: 21 },
-          { campus: :brookhaven, prefix: 22 },
-          { campus: :brookhaven, prefix: 23 },
-          { campus: :brookhaven, prefix: 25 },
-          { campus: :brookhaven, prefix: 34 },
-          { campus: :brookhaven, prefix: 51 },
-          { campus: :brookhaven, prefix: 52 },
-          { campus: :brookhaven, prefix: 54 },
-          { campus: :brookhaven, prefix: 55 },
-          { campus: :brookhaven, prefix: 56 },
-          { campus: :brookhaven, prefix: 57 },
-          { campus: :brookhaven, prefix: 58 },
-          { campus: :brookhaven, prefix: 59 },
-          { campus: :brookhaven, prefix: 65 },
-          { campus: :cincinnati, prefix: 30 },
-          { campus: :cincinnati, prefix: 32 },
-          { campus: :cincinnati, prefix: 35 },
-          { campus: :cincinnati, prefix: 36 },
-          { campus: :cincinnati, prefix: 37 },
-          { campus: :cincinnati, prefix: 38 },
-          { campus: :cincinnati, prefix: 61 },
-          { campus: :fresno, prefix: 15 },
-          { campus: :fresno, prefix: 24 },
-          { campus: :kansas_city, prefix: 40 },
-          { campus: :kansas_city, prefix: 44 },
-          { campus: :memphis, prefix: 94 },
-          { campus: :memphis, prefix: 95 },
-          { campus: :ogden, prefix: 80 },
-          { campus: :ogden, prefix: 90 },
-          { campus: :philadelphia, prefix: 33 },
-          { campus: :philadelphia, prefix: 39 },
-          { campus: :philadelphia, prefix: 41 },
-          { campus: :philadelphia, prefix: 42 },
-          { campus: :philadelphia, prefix: 43 },
-          { campus: :philadelphia, prefix: 46 },
-          { campus: :philadelphia, prefix: 48 },
-          { campus: :philadelphia, prefix: 62 },
-          { campus: :philadelphia, prefix: 63 },
-          { campus: :philadelphia, prefix: 64 },
-          { campus: :philadelphia, prefix: 66 },
-          { campus: :philadelphia, prefix: 68 },
-          { campus: :philadelphia, prefix: 71 },
-          { campus: :philadelphia, prefix: 72 },
-          { campus: :philadelphia, prefix: 73 },
-          { campus: :philadelphia, prefix: 74 },
-          { campus: :philadelphia, prefix: 75 },
-          { campus: :philadelphia, prefix: 76 },
-          { campus: :philadelphia, prefix: 77 },
-          { campus: :philadelphia, prefix: 82 },
-          { campus: :philadelphia, prefix: 83 },
-          { campus: :philadelphia, prefix: 84 },
-          { campus: :philadelphia, prefix: 85 },
-          { campus: :philadelphia, prefix: 86 },
-          { campus: :philadelphia, prefix: 87 },
-          { campus: :philadelphia, prefix: 88 },
-          { campus: :philadelphia, prefix: 91 },
-          { campus: :philadelphia, prefix: 92 },
-          { campus: :philadelphia, prefix: 93 },
-          { campus: :philadelphia, prefix: 98 },
-          { campus: :philadelphia, prefix: 99 },
-          { campus: :internet, prefix: 20 },
-          { campus: :internet, prefix: 26 },
-          { campus: :internet, prefix: 27 },
-          { campus: :internet, prefix: 45 },
-          { campus: :internet, prefix: 46 },
-          { campus: :internet, prefix: 47 },
-          { campus: :internet, prefix: 81 },
-          { campus: :internet, prefix: 82 },
-          { campus: :internet, prefix: 83 },
-          { campus: :small_business_administration, prefix: 31 }
-        ]
-
-        ein_result_arr = []
-        (1..count).each do
-          this_ein_prefix_data_struct_index = Random.rand(ein_prefix_data_struct.length)
-          this_ein_prefix_data_struct = ein_prefix_data_struct[this_ein_prefix_data_struct_index]
-          this_ein_prefix_campus = this_ein_prefix_data_struct[:campus]
-          this_ein_prefix = format('%0.2d', this_ein_prefix_data_struct[:prefix])
-          this_ein_suffix = format('%0.7d', Random.rand(0..9_999_999))
-          this_ein = { campus: this_ein_prefix_campus, ein: "#{this_ein_prefix}-#{this_ein_suffix}" }
-          ein_result_arr.push(this_ein)
-        end
-
-        ein_result_arr
-      rescue StandardError => e
-        raise e
-      end
-
-      # Author(s):: 0day Inc. <support@0dayinc.com>
-
-      public_class_method def self.authors
-        "AUTHOR(S):
-          0day Inc. <support@0dayinc.com>
-        "
-      end
-
-      # Display Usage for this Module
-
-      public_class_method def self.help
-        puts "USAGE:
-          #{self}.generate(
-            count: 'required - number of EIN numbers to generate'
-          )
-
-          #{self}.authors
-        "
-      end
-    end
-  end
-end

data/lib/pwn/plugins/file_fu.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-require 'fileutils'
-require 'shellwords'
-require 'rubygems/package'
-require 'zlib'
-
-module PWN
-  module Plugins
-    # This plugin is primarily used for interacting with files and directories
-    # in addition to the capabilities already built within the File and FileUtils
-    # built-in ruby classes (e.g. contains an easy to use recursion method that
-    # uses yield to interact with each entry on the fly).
-    module FileFu
-      # Supported Method Parameters::
-      # PWN::Plugins::FileFu.recurse_in_dir(
-      #   dir_path: 'optional path to dir defaults to .',
-      #   include_extensions: 'optional - array of file extensions to search for in scan (e.g. ['.js', '.php'])',
-      #   exclude_extensions: 'optional - array of file extensions to exclude from scan (e.g. ['.log', '.txt', '.spec'])'
-      # )
-
-      public_class_method def self.recurse_in_dir(opts = {})
-        dir_path = opts[:dir_path] ||= '.'
-        dir_path = dir_path.to_s.scrub unless dir_path.is_a?(String)
-        raise "PWN Error: Invalid Directory #{dir_path}" unless Dir.exist?(dir_path)
-
-        include_extensions = opts[:include_extensions] ||= []
-        exclude_extensions = opts[:exclude_extensions] ||= []
-
-        previous_dir = Dir.pwd
-        Dir.chdir(dir_path)
-        # Execute this like this:
-        # recurse_in_dir(:dir_path => 'path to dir') {|entry| puts entry}
-        Dir.glob('./**/*').each do |entry|
-          next if exclude_extensions.include?(File.extname(entry))
-
-          next unless include_extensions.empty? || include_extensions.include?(File.extname(entry))
-
-          yield Shellwords.escape(entry)
-        end
-      rescue StandardError => e
-        raise e
-      ensure
-        Dir.chdir(previous_dir) if Dir.exist?(previous_dir)
-      end
-
-      # Supported Method Parameters::
-      # PWN::Plugins::FileFu.untar_gz_file(
-      #   tar_gz_file: 'required - path to .tar.gz file',
-      #   destination: 'required - destination folder to save extracted contents'
-      # )
-
-      public_class_method def self.untar_gz_file(opts = {})
-        tar_gz_file = opts[:tar_gz_file].to_s.scrub if File.exist?(opts[:tar_gz_file].to_s.scrub)
-        destination = opts[:destination].to_s.scrub if Dir.exist?(File.dirname(tar_gz_file))
-        puts `tar -xzvf #{tar_gz_file} -C #{destination}`
-
-        nil
-      rescue StandardError => e
-        raise e
-      end
-
-      # Author(s):: 0day Inc. <support@0dayinc.com>
-
-      public_class_method def self.authors
-        "AUTHOR(S):
-          0day Inc. <support@0dayinc.com>
-        "
-      end
-
-      # Display Usage for this Module
-
-      public_class_method def self.help
-        puts "USAGE:
-          #{self}.recurse_in_dir(
-            dir_path: 'optional path to dir defaults to .',
-            include_extensions: 'optional - array of file extensions to search for in scan (e.g. ['.js', '.php'])',
-            exclude_extensions: 'optional - array of file extensions to exclude from scan (e.g. ['.log', '.txt', '.spec'])'
-          ) do |entry|
-            puts entry
-          end
-
-          #{self}.untar_gz_file(
-            tar_gz_file: 'required - path to .tar.gz file',
-            destination: 'required - destination folder to save extracted contents'
-          )
-
-          #{self}.authors
-        "
-      end
-    end
-  end
-end

data/lib/pwn/plugins/fuzz.rb

@@ -1,204 +0,0 @@
-# frozen_string_literal: true
-
-require 'base64'
-require 'cgi'
-require 'htmlentities'
-
-module PWN
-  module Plugins
-    # This plugin was created to support fuzzing various networking protocols
-    module Fuzz
-      # Supported Method Parameters::
-      # socket_fuzz_results_arr = PWN::Plugins::Fuzz.socket(
-      #   target: 'required - target host or ip',
-      #   port: 'required - target port',
-      #   protocol: 'optional - :tcp || :udp (defaults to tcp)',
-      #   tls: 'optional - boolean connect to target socket using TLS (defaults to false)',
-      #   fuzz_delimeter: 'optional - fuzz delimeter used in request to specify where payloads should reside (defaults to \u2665)',
-      #   request: 'required - String object of socket request w/ \u001A as fuzz delimeter (e.g. "GET /\u001A\u001A HTTP/1.1\r\nHost: \u001A127..0.0.1\u001A\r\n\r\n")',
-      #   payload: 'required - payload string',
-      #   encoding: 'optional - :base64 || :hex || :html_entity || :url (Defaults to nil)',
-      #   encoding_depth: 'optional - number of times to encode payload (defaults to 1)',
-      #   char_encoding: 'optional - character encoding returned by PWN::Plugins::Char.list_encoders (defaults to UTF-8)',
-      #   response_timeout: 'optional - float (defaults to 0.9)',
-      #   request_rate_limit: 'optional - float (defaults to 0.3)'
-      # )
-
-      public_class_method def self.socket(opts = {})
-        target = opts[:target].to_s.scrub
-        port = opts[:port].to_i
-        protocol = opts[:protocol]
-        tls = opts[:tls]
-        opts[:encoding].nil? ? encoding = nil : encoding = opts[:encoding].to_s.strip.chomp.scrub.downcase.to_sym
-        opts[:encoding_depth].nil? ? encoding_depth = 1 : encoding_depth = opts[:encoding_depth].to_i
-        opts[:char_encoding].nil? ? char_encoding = 'UTF-8' : char_encoding = opts[:char_encoding].to_s
-        opts[:fuzz_delimeter].nil? ? fuzz_delimeter = "\u2665" : fuzz_delimeter = opts[:fuzz_delimeter]
-        request = opts[:request].to_s.encode(char_encoding, 'UTF-8')
-        payload = opts[:payload].to_s.encode(char_encoding, 'UTF-8')
-
-        if encoding
-          case encoding
-          when :base64
-            if encoding_depth > 1
-              (1..encoding_depth).each do
-                payload = Base64.strict_encode64(payload)
-              end
-            else
-              payload = Base64.strict_encode64(payload)
-            end
-          when :hex
-            if encoding_depth > 1
-              (1..encoding_depth).each do
-                hex_payload = ''
-                payload.each_byte { |b| hex_payload = "#{hex_payload}#{format('\x%02x', b)}" }
-                payload = hex_payload
-              end
-            else
-              hex_payload = ''
-              payload.each_byte { |b| hex_payload = "#{hex_payload}#{format('\x%02x', b)}" }
-              payload = hex_payload
-            end
-          when :html_entity
-            if encoding_depth > 1
-              (1..encoding_depth).each do
-                payload = HTMLEntities.new.encode(payload)
-              end
-            else
-              payload = HTMLEntities.new.encode(payload)
-            end
-          when :url
-            if encoding_depth > 1
-              (1..encoding_depth).each do
-                payload = CGI.escape(payload)
-              end
-            else
-              payload = CGI.escape(payload)
-            end
-          else
-            raise "Encoding type: #{encoding} not supported."
-          end
-        end
-
-        opts[:response_timeout].nil? ? response_timeout = 0.9 : response_timeout = opts[:response_timeout].to_f
-        opts[:request_rate_limit].nil? ? request_rate_limit = 0.3 : request_rate_limit = opts[:request_rate_limit].to_f
-        socket_fuzz_results_arr = []
-
-        # Find fuzz delimeter index numbers in request
-        request_delim_index_arr = []
-        request.each_char.with_index do |char, char_index|
-          request_delim_index_arr.push(char_index) if char == fuzz_delimeter
-        end
-
-        # request_delim_index_arr should always return an even length,
-        # otherwise the request is missing a fuzz delimeter.
-        request_delim_index_arr.each_slice(2).with_index do |placeholder_slice, placeholder_slice_index|
-          this_socket_fuzz_result = {}
-          begin_delim_char_index_shift_width = placeholder_slice_index * 2
-          begin_delim_char_index = placeholder_slice[0].to_i - begin_delim_char_index_shift_width
-
-          end_delim_char_index_shift_width = (placeholder_slice_index * 2) + 2
-          end_delim_char_index = placeholder_slice[1].to_i - end_delim_char_index_shift_width
-
-          this_request = request.dup.delete(fuzz_delimeter).encode(char_encoding, 'UTF-8')
-
-          if end_delim_char_index.positive?
-            this_request[begin_delim_char_index..end_delim_char_index] = payload
-          else
-            # begin_delim_char_index should always be 0
-            this_request[begin_delim_char_index] = payload
-          end
-
-          sock_obj = PWN::Plugins::Sock.connect(
-            target: target,
-            port: port,
-            protocol: protocol,
-            tls: tls
-          )
-
-          this_socket_fuzz_result[:timestamp] = Time.now.strftime('%Y-%m-%d %H:%M:%S.%9N %z').to_s
-
-          this_socket_fuzz_result[:request] = this_request
-          this_socket_fuzz_result[:request_encoding] = this_request.encoding.name
-          this_socket_fuzz_result[:request_len] = this_request.length
-
-          # Send Fuzz Payload in its rawest form (as long as it will undump first)
-          sock_obj.write(this_request.encode('ASCII-8BIT', undef: :replace).undump)
-
-          does_respond = sock_obj.wait_readable(response_timeout)
-          if does_respond
-            response = sock_obj.read
-            response_len = response.length
-            this_socket_fuzz_result[:response] = response.to_s.inspect
-            this_socket_fuzz_result[:response_len] = response_len
-          else
-            this_socket_fuzz_result[:response] = ''
-            this_socket_fuzz_result[:response_len] = 0
-          end
-          sleep request_rate_limit
-          sock_obj = PWN::Plugins::Sock.disconnect(sock_obj: sock_obj)
-          # TODO: dump into file once array reaches max length (avoid memory consumption issues)
-          socket_fuzz_results_arr.push(this_socket_fuzz_result)
-        rescue Errno::ECONNRESET => e
-          response = e.message
-          this_socket_fuzz_result[:response] = response
-          this_socket_fuzz_result[:response_len] = response.length
-
-          sleep request_rate_limit
-          sock_obj = PWN::Plugins::Sock.disconnect(sock_obj: sock_obj) unless sock_obj.nil?
-          # TODO: dump into file once array reaches max length (avoid memory consumption issues)
-          socket_fuzz_results_arr.push(this_socket_fuzz_result)
-
-          next
-        rescue StandardError => e
-          response = "#{e.class}: #{e.message} #{e.backtrace}"
-          this_socket_fuzz_result[:response] = response
-          this_socket_fuzz_result[:response_len] = response.length
-
-          sleep request_rate_limit
-          sock_obj = PWN::Plugins::Sock.disconnect(sock_obj: sock_obj) unless sock_obj.nil?
-          # TODO: dump into file once array reaches max length (avoid memory consumption issues)
-          socket_fuzz_results_arr.push(this_socket_fuzz_result)
-
-          next
-        end
-
-        socket_fuzz_results_arr
-      rescue StandardError => e
-        raise e
-      ensure
-        sock_obj = PWN::Plugins::Sock.disconnect(sock_obj: sock_obj) unless sock_obj.nil?
-      end
-
-      # Author(s):: 0day Inc. <support@0dayinc.com>
-
-      public_class_method def self.authors
-        "AUTHOR(S):
-          0day Inc. <support@0dayinc.com>
-        "
-      end
-
-      # Display Usage for this Module
-
-      public_class_method def self.help
-        puts "USAGE:
-          socket_fuzz_results_arr = #{self}.socket(
-            target: 'required = target host or ip',
-            port: 'required => target port',
-            protocol: 'optional => :tcp || :udp (defaults to tcp)',
-            tls: 'optional - boolean connect to target socket using TLS (defaults to false)',
-            fuzz_delimeter: \"optional - fuzz delimeter used in request to specify where payloads should reside (defaults to \u2665)\",
-            request: \"required - String object of socket request w/ \u2665 as fuzz delimeter (e.g. '\"GET /\u2665\u2665 HTTP/1.1\\r\\nHost: \u2665127.0.0.1\u2665\\r\\n\\r\\n\"')\",
-            payload: 'required - payload string',
-            encoding: 'optional - :base64 || :hex || :html_entity || :url (Defaults to nil)',
-            encoding_depth: 'optional - number of times to encode payload (defaults to 1)',
-            char_encoding: 'optional - character encoding returned by PWN::Plugins::Char.list_encoders (defaults to UTF-8)',
-            response_timeout: 'optional - float (defaults to 0.9)',
-            request_rate_limit: 'optional - float (defaults to 0.3)'
-          )
-
-          #{self}.authors
-        "
-      end
-    end
-  end
-end

data/lib/pwn/plugins/git.rb

@@ -1,159 +0,0 @@
-# frozen_string_literal: true
-
-require 'shellwords'
-
-module PWN
-  module Plugins
-    # Used primarily in the past to clone local repos and generate an
-    # html diff to be sent via email (deprecated).  In the future this
-    # plugin may be used to expand upon capabilities required w/ Git.
-    module Git
-      @@logger = PWN::Plugins::PWNLogger.create
-      # Supported Method Parameters::
-      # PWN::Plugins::Git.gen_html_diff(
-      #   repo: 'required git repo name',
-      #   branch: 'required git repo branch (e.g. master, develop, etc)',
-      #   since: 'optional date, otherwise default to last pull'
-      # )
-
-      public_class_method def self.gen_html_diff(opts = {})
-        git_repo_name = opts[:repo].to_s
-        git_repo_branch = opts[:branch].to_s
-        since_date = opts[:since]
-
-        git_pull_output = '<div style="background-color:#CCCCCC; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">'
-        if since_date
-          git_pull_output << "<h3>#{git_repo_name}->#{git_repo_branch} Diff Summary Since #{since_date}</h3>"
-          git_entity = `git log --since #{since_date} --stat-width=65535 --graph`.to_s.scrub
-        else
-          git_pull_output << "<h3>#{git_repo_name}->#{git_repo_branch} Diff Summary Since Last Pull</h3>"
-          git_entity = `git log ORIG_HEAD.. --stat-width=65535 --graph 2> /dev/null`.to_s.scrub
-        end
-        # For debugging purposes
-        @@logger.info(git_entity)
-        git_pull_output << git_entity.gsub("\n", '<br />')
-        git_pull_output << '</div>'
-        git_pull_output << '<br />'
-
-        git_pull_output
-      rescue StandardError => e
-        raise e
-      end
-
-      # Supported Method Parameters::
-      # get_author_by_line_range(
-      #   repo_root: 'optional path to git repo root (defaults to ".")'
-      #   from_line: 'required line number to start in range',
-      #   to_line: 'required line number to stop in range',
-      #   target_file: 'require file in which line range is queried'
-      # )
-
-      private_class_method def self.get_author_by_line_range(opts = {})
-        repo_root = opts[:repo_root] ||= '.'
-        repo_root = opts[:repo_root].to_s unless repo_root.is_a?(String)
-        from_line = opts[:from_line].to_i
-        to_line = opts[:to_line].to_i
-        target_file = opts[:target_file].to_s
-        target_file.gsub!(%r{^#{repo_root}/}, '')
-
-        `git --git-dir="#{Shellwords.escape(repo_root)}/.git" log -L #{from_line},#{to_line}:"#{Shellwords.escape(target_file)}" 2> /dev/null | grep Author | head -n 1`.to_s.scrub if File.directory?(repo_root) && File.file?("#{repo_root}/#{target_file}")
-      rescue StandardError => e
-        raise e
-      end
-
-      # Supported Method Parameters::
-      # PWN::Plugins::Git.dump_all_repo_branches(
-      #   git_url: 'required git repo url'
-      # )
-
-      public_class_method def self.dump_all_repo_branches(opts = {})
-        git_url = opts[:git_url].to_s.scrub
-        `git ls-remote #{git_url} 2> /dev/null`.to_s.scrub
-      rescue StandardError => e
-        raise e
-      end
-
-      # Supported Method Parameters::
-      # get_author(
-      #   repo_root: dir_path,
-      #   from_line: line_no,
-      #   to_line:line_no,
-      #   target_file: entry,
-      #   entry_beautified: entry_beautified
-      # )
-
-      public_class_method def self.get_author(opts = {})
-        repo_root = opts[:repo_root]
-        from_line = opts[:from_line]
-        to_line = opts[:to_line]
-        target_file = opts[:target_file]
-        entry_beautified = opts[:entry_beautified]
-
-        # In order to get the original author
-        # we need to query the original file
-        # instead of the .JS-BEAUTIFIED file
-        if entry_beautified
-          target_file.gsub!(/\.JS-BEAUTIFIED$/, '')
-          target_file_line_length = `wc -l #{target_file}`.split.first.to_i
-          target_file_line_length = 1 if target_file_line_length < 1 # wc -l doesn't count line is \n is missing
-
-          author = get_author_by_line_range(
-            repo_root: repo_root,
-            from_line: 1,
-            to_line: target_file_line_length,
-            target_file: target_file
-          )
-        else
-          if from_line.to_i && to_line.to_i < 1
-            from_line = 1
-            to_line = 1
-          end
-          author = get_author_by_line_range(
-            repo_root: repo_root,
-            from_line: from_line,
-            to_line: to_line,
-            target_file: target_file
-          )
-        end
-
-        author ||= 'N/A'
-      rescue StandardError => e
-        raise e
-      end
-
-      # Author(s):: Jacob Hoopes <jake.hoopes@gmail.com>
-
-      public_class_method def self.authors
-        "AUTHOR(S):
-          Jacob Hoopes <jake.hoopes@gmail.com>
-        "
-      end
-
-      # Display Usage for this Module
-
-      public_class_method def self.help
-        puts %{USAGE:
-          git_html_resp = #{self}.gen_html_diff(
-            repo: 'required git repo name',
-            branch: 'required git repo branch (e.g. master, develop, etc)',
-            since: 'optional date, otherwise default to last pull'
-          )
-
-          author = #{self}.get_author(
-            repo_root: 'optional path to git repo root (defaults to ".")'
-            from_line: 'required line number to start in range',
-            to_line: 'required line number to stop in range',
-            target_file: 'required file in which line range is queried'
-            entry_beautified: 'required boolean'
-          )
-
-          all_repo_branches = #{self}.dump_all_repo_branches(
-            git_url: 'required git repo url'
-          )
-
-          #{self}.authors
-        }
-      end
-    end
-  end
-end