pwn 0.5.509 → 0.5.510

data/lib/pwn/plugins/detect_os.rb

@@ -0,0 +1,71 @@
+# 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

@@ -0,0 +1,141 @@
+# 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

@@ -0,0 +1,93 @@
+# 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

@@ -0,0 +1,204 @@
+# 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

@@ -0,0 +1,159 @@
+# 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