pwn 0.5.708 → 0.5.710

data/lib/pwn/plugins/git.rb

@@ -132,27 +132,32 @@ module PWN
       # 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'
+        puts "USAGE:
+          # Run gen html diff and return its result
+          #{self}.gen_html_diff(
+            repo: 'required - required git repo name',
+            branch: 'required - required git repo branch (e.g. master, develop, etc)',
+            since: 'optional - 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'
+          # Run dump all repo branches and return its result
+          #{self}.dump_all_repo_branches(
+            git_url: 'required - required git repo url'
           )
 
-          all_repo_branches = #{self}.dump_all_repo_branches(
-            git_url: 'required git repo url'
+          # Run get author and return its result
+          #{self}.get_author(
+            repo_root: 'optional - repo root value consumed by #get_author',
+            from_line: 'optional - from line value consumed by #get_author',
+            to_line: 'optional - to line value consumed by #get_author',
+            target_file: 'optional - target file value consumed by #get_author',
+            entry_beautified: 'optional - entry beautified value consumed by #get_author'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
-        }
+        "
+        constants.sort
       end
     end
   end

data/lib/pwn/plugins/github.rb

@@ -235,6 +235,7 @@ module PWN
         gh_bin = ENV['PATH'].to_s.split(File::PATH_SEPARATOR)
                             .map { |d| File.join(d, 'gh') }
                             .find { |f| File.executable?(f) }
+        # Run api and return its result
         raise "ERROR: gh CLI not found on PATH - use #{self}.api(path:) instead, or install gh (https://cli.github.com)" unless gh_bin
 
         token = resolve_token(opts)
@@ -259,36 +260,58 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          response_json = #{self}.download_all_gists(
-            username: 'optional - username of gists to download (default PWN::Env[:plugins][:github][:username])',
+          # Run download all gists and return its result
+          #{self}.download_all_gists(
+            username: 'optional - username of gists to backup (default PWN::Env[:plugins][:github][:username])',
             target_dir: 'required - target directory to save respective gists'
           )
 
-          runs = #{self}.workflow_runs(
-            owner: 'optional - default PWN::Env[:plugins][:github][:username]',
+          # Run workflow runs and return its result
+          #{self}.workflow_runs(
+            owner: 'required - repo owner (default PWN::Env[:plugins][:github][:username])',
             repo: 'required - repo name',
-            workflow: 'optional - e.g. install-matrix.yml',
-            params: 'optional - {branch:, status:, per_page:}'
+            workflow: 'optional - workflow file name or id (e.g. install-matrix.yml). Omit for all runs.',
+            params: 'optional - {branch:, status:, per_page:, page:}',
+            token: 'optional - token value consumed by #workflow_runs'
           )
 
-          jobs = #{self}.workflow_run_jobs(
-            owner: 'optional', repo: 'required', run_id: 'required'
+          # Run workflow run jobs and return its result
+          #{self}.workflow_run_jobs(
+            owner: 'required - repo owner (default PWN::Env[:plugins][:github][:username])',
+            repo: 'required - repo name',
+            run_id: 'required - workflow run id',
+            params: 'optional - params value consumed by #workflow_run_jobs',
+            token: 'optional - token value consumed by #workflow_run_jobs'
           )
 
-          log = #{self}.job_log(
-            owner: 'optional', repo: 'required', job_id: 'required'
+          # Run job log and return its result
+          #{self}.job_log(
+            owner: 'required - repo owner (default PWN::Env[:plugins][:github][:username])',
+            repo: 'required - repo name',
+            job_id: 'required - job id from workflow_run_jobs',
+            token: 'optional - token value consumed by #job_log'
           )
 
-          json = #{self}.api(
-            path: 'required - e.g. repos/0dayinc/pwn/releases/latest',
-            method: 'optional - :get|:post|:put|:patch|:delete',
-            params: 'optional', body: 'optional', raw: 'optional'
+          # Run api and return its result
+          #{self}.api(
+            path: 'required - REST path relative to https://api.github.com (e.g. repos/0dayinc/pwn/releases/latest)',
+            method: 'optional - :get|:post|:put|:patch|:delete (default :get)',
+            params: 'optional - query params Hash',
+            body: 'optional - request body Hash/Array/String for POST/PUT/PATCH',
+            token: 'optional - PAT (default PWN::Env[:plugins][:github][:personal_access_token])',
+            raw: 'optional - return raw RestClient::Response instead of parsed JSON (default false)'
           )
 
-          #{self}.gh(cmd: 'run view <run_id> -R <owner>/<repo> --log-failed')
+          # Thin wrapper around the `gh` CLI with GH_TOKEN injected from PWN::Env so
+          #{self}.gh(
+            cmd: 'required - gh subcommand string, e.g. run list -R 0dayinc/pwn -L 5 --json databaseId,status',
+            token: 'optional - PAT (default PWN::Env[:plugins][:github][:personal_access_token])'
+          )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/plugins/google_workspace.rb

@@ -876,51 +876,194 @@ module PWN
       end
 
       public_class_method def self.help
-        puts <<~USAGE
-          USAGE:
-            # OAuth (Desktop client from Google Cloud Console)
-            # authorize the printed URL; refresh/bearer persist to Env + pwn.yaml
-            #{self}.obtain_oauth_auth_url(services: 'email,calendar')
-            #{self}.obtain_oauth_auth_url(wait: false)  # URL only; no listener
-            #{self}.exchange_oauth_code(code: 'optional paste fallback')
-            #{self}.authenticated?
-            #{self}.revoke
-
-            # Gmail
-            #{self}.gmail_search(query: 'is:unread', max: 10)
-            #{self}.gmail_get(id: 'MESSAGE_ID')
-            #{self}.gmail_send(to: 'a@b.com', subject: 'Hi', body: '...')
-            #{self}.gmail_reply(id: 'MESSAGE_ID', body: 'Thanks')
-            #{self}.gmail_labels
-            #{self}.gmail_modify(id: 'MESSAGE_ID', add_labels: ['STARRED'], remove_labels: ['UNREAD'])
-
-            # Calendar
-            #{self}.calendar_list(start: '2026-03-01T00:00:00Z')
-            #{self}.calendar_create(summary: 'Standup', start: '2026-03-01T10:00:00-06:00', end: '2026-03-01T10:30:00-06:00')
-            #{self}.calendar_update(id: 'EVENT_ID', summary: 'Standup (moved)')
-            #{self}.calendar_delete(id: 'EVENT_ID')
-
-            # Drive
-            #{self}.drive_search(query: 'quarterly report')
-            #{self}.drive_get(id: 'FILE_ID')
-            #{self}.drive_upload(path: '/tmp/report.pdf')
-            #{self}.drive_download(id: 'FILE_ID', output: '/tmp/out.pdf')
-            #{self}.drive_create_folder(name: 'Reports')
-            #{self}.drive_share(id: 'FILE_ID', email: 'a@b.com', role: 'reader')
-            #{self}.drive_delete(id: 'FILE_ID')
-
-            # Docs / Sheets
-            #{self}.docs_create(title: 'Notes', body: 'Hello')
-            #{self}.docs_get(id: 'DOC_ID')
-            #{self}.docs_append(id: 'DOC_ID', text: ' more')
-            #{self}.sheets_create(title: 'Budget')
-            #{self}.sheets_get(id: 'SHEET_ID', range: 'Sheet1!A1:D10')
-            #{self}.sheets_update(id: 'SHEET_ID', range: 'Sheet1!A1', values: [['Name']])
-            #{self}.sheets_append(id: 'SHEET_ID', range: 'Sheet1!A:C', values: [['a', 'b', 'c']])
-
-            Config: PWN::Env[:plugins][:google_workspace][:oauth]
-            #{self}.authors
-        USAGE
+        puts "USAGE:
+          # Run scopes and return its result
+          #{self}.scopes(
+            scope: 'optional - scope value consumed by #scopes',
+            services: 'optional - services value consumed by #scopes'
+          )
+
+          # Run parse oauth code and return its result
+          #{self}.parse_oauth_code(
+            code: 'optional - code value consumed by #parse_oauth_code'
+          )
+
+          # Run obtain oauth auth url and return its result
+          #{self}.obtain_oauth_auth_url(
+            wait: 'optional - wait value consumed by #obtain_oauth_auth_url',
+            timeout: 'optional - seconds to wait before giving up',
+            probe: 'optional - probe value consumed by #obtain_oauth_auth_url'
+          )
+
+          # Run exchange oauth code and return its result
+          #{self}.exchange_oauth_code(
+            code: 'required - code value consumed by #exchange_oauth_code',
+            code_verifier: 'optional - code verifier value consumed by #exchange_oauth_code (defaults to pending[:verifier])'
+          )
+
+          # Run refresh oauth bearer token and return its result
+          #{self}.refresh_oauth_bearer_token(
+            refresh_token: 'required - refresh token value consumed by #refresh_oauth_bearer_token (defaults to c[:refresh_token])',
+            client_id: 'required - client id value consumed by #refresh_oauth_bearer_token (defaults to c[:client_id])',
+            client_secret: 'required - client secret value consumed by #refresh_oauth_bearer_token (defaults to c[:client_secret])'
+          )
+
+          # Run bearer token and return its result
+          #{self}.bearer_token
+
+          # Run authenticated and return its result
+          #{self}.authenticated?
+
+          # Run revoke and return its result
+          #{self}.revoke
+
+          # ── Gmail ──────────────────────────────────────────────────────────
+          #{self}.gmail_search(
+            query: 'optional - search query string',
+            max: 'optional - max value consumed by #gmail_search'
+          )
+
+          # Run gmail get and return its result
+          #{self}.gmail_get(
+            id: 'required - id value consumed by #gmail_get',
+            format: 'optional - format value consumed by #gmail_get (defaults to full)'
+          )
+
+          # Run gmail send and return its result
+          #{self}.gmail_send(
+            to: 'required - to value consumed by #gmail_send'
+          )
+
+          # Run gmail reply and return its result
+          #{self}.gmail_reply(
+            id: 'required - id value consumed by #gmail_reply'
+          )
+
+          # Run gmail labels and return its result
+          #{self}.gmail_labels
+
+          # Run gmail modify and return its result
+          #{self}.gmail_modify(
+            id: 'required - id value consumed by #gmail_modify',
+            add_labels: 'optional - add labels value consumed by #gmail_modify',
+            add: 'required - add value consumed by #gmail_modify',
+            remove_labels: 'optional - remove labels value consumed by #gmail_modify',
+            remove: 'required - remove value consumed by #gmail_modify'
+          )
+
+          # ── Calendar ───────────────────────────────────────────────────────
+          #{self}.calendar_list(
+            calendar_id: 'optional - calendar id value consumed by #calendar_list',
+            start: 'optional - start value consumed by #calendar_list',
+            end: 'optional - end value consumed by #calendar_list',
+            max: 'optional - max value consumed by #calendar_list'
+          )
+
+          # Run calendar create and return its result
+          #{self}.calendar_create(
+            calendar_id: 'optional - calendar id value consumed by #calendar_create'
+          )
+
+          # Run calendar update and return its result
+          #{self}.calendar_update(
+            id: 'required - id value consumed by #calendar_update',
+            calendar_id: 'optional - calendar id value consumed by #calendar_update'
+          )
+
+          # Run calendar delete and return its result
+          #{self}.calendar_delete(
+            id: 'required - id value consumed by #calendar_delete',
+            calendar_id: 'optional - calendar id value consumed by #calendar_delete'
+          )
+
+          # ── Drive ──────────────────────────────────────────────────────────
+          #{self}.drive_search(
+            query: 'optional - search query string',
+            raw_query: 'optional - raw query value consumed by #drive_search',
+            max: 'optional - max value consumed by #drive_search'
+          )
+
+          # Run drive get and return its result
+          #{self}.drive_get(
+            id: 'required - id value consumed by #drive_get'
+          )
+
+          # Run drive upload and return its result
+          #{self}.drive_upload(
+            path: 'required - filesystem path to read or write',
+            name: 'required - binary or identifier name',
+            parent: 'optional - parent value consumed by #drive_upload',
+            mime: 'optional - mime value consumed by #drive_upload'
+          )
+
+          # Run drive download and return its result
+          #{self}.drive_download(
+            id: 'required - id value consumed by #drive_download',
+            export_mime: 'optional - export mime value consumed by #drive_download (defaults to EXPORT_MIME[meta[:mimeType])',
+            output: 'optional - output value consumed by #drive_download'
+          )
+
+          # Run drive create folder and return its result
+          #{self}.drive_create_folder(
+            name: 'required - binary or identifier name',
+            parent: 'optional - parent value consumed by #drive_create_folder'
+          )
+
+          # Run drive share and return its result
+          #{self}.drive_share(
+            id: 'required - id value consumed by #drive_share',
+            role: 'optional - role value consumed by #drive_share',
+            type: 'optional - type value consumed by #drive_share',
+            email: 'optional - email value consumed by #drive_share',
+            domain: 'optional - FQDN to query (e.g. example.com)',
+            notify: 'optional - notify value consumed by #drive_share'
+          )
+
+          # Run drive delete and return its result
+          #{self}.drive_delete(
+            id: 'required - id value consumed by #drive_delete',
+            permanent: 'optional - permanent value consumed by #drive_delete'
+          )
+
+          # ── Docs ───────────────────────────────────────────────────────────
+          #{self}.docs_get(
+            id: 'required - id value consumed by #docs_get'
+          )
+
+          # Run docs create and return its result
+          #{self}.docs_create(
+            title: 'required - title value consumed by #docs_create',
+            body: 'optional - body value consumed by #docs_create'
+          )
+
+          # Run docs append and return its result
+          #{self}.docs_append(
+            id: 'required - id value consumed by #docs_append',
+            text: 'optional - text value consumed by #docs_append'
+          )
+
+          # ── Sheets ─────────────────────────────────────────────────────────
+          #{self}.sheets_create(
+            title: 'required - title value consumed by #sheets_create',
+            sheet_name: 'optional - sheet name value consumed by #sheets_create'
+          )
+
+          # Run sheets get and return its result
+          #{self}.sheets_get(
+            id: 'required - id value consumed by #sheets_get',
+            range: 'required - range value consumed by #sheets_get'
+          )
+
+          # Run sheets update and return its result
+          #{self}.sheets_update
+
+          # Run sheets append and return its result
+          #{self}.sheets_append
+
+          # Print the AUTHOR(S) string for this module.
+          #{self}.authors
+        "
+        constants.sort
       end
     end
   end

data/lib/pwn/plugins/hacker_one.rb

@@ -658,49 +658,173 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          h1_obj = #{self}.login(
-            username: 'optional - default PWN::Env[:plugins][:hackerone][:username]',
-            api_key: 'optional - default PWN::Env[:plugins][:hackerone][:api_key]'
+          # Run login and return its result
+          #{self}.login(
+            username: 'optional - username (default PWN::Env[:plugins][:hackerone][:username])',
+            api_key: 'optional - api token (default PWN::Env; will prompt if still nil)',
+            token: 'optional - alias for api_key'
           )
 
-          reports = #{self}.get_me_reports(h1_obj: h1_obj)
-          report  = #{self}.get_report(id: 12345)
-          report  = #{self}.create_report(
-            team_handle: 'security',
-            title: 'Example',
-            vulnerability_information: 'Details...'
+          # Run api and return its result
+          #{self}.api(
+            path: 'required - path relative to /v1/hackers (e.g. me/reports)',
+            method: 'optional - :get|:post|:put|:patch|:delete (default :get)',
+            params: 'optional - query params Hash',
+            body: 'optional - request body Hash/Array/String (defaults to opts[:http_body])',
+            username: 'optional - username value consumed by #api',
+            api_key: 'optional - api key value consumed by #api',
+            h1_obj: 'optional - session from #login (supplies username/api_key)',
+            raw: 'optional - return raw response (default false)',
+            http_method: 'optional - http method value consumed by #api (defaults to :get)',
+            http_body: 'optional - http body value consumed by #api'
           )
 
-          balance  = #{self}.get_balance
-          earnings = #{self}.get_earnings
-          payouts  = #{self}.get_payouts
-
-          programs = #{self}.get_programs
-          program  = #{self}.get_program(handle: 'security')
-          scopes   = #{self}.get_structured_scopes(handle: 'security')
-          excl     = #{self}.get_scope_exclusions(handle: 'security')
-          weak     = #{self}.get_weaknesses(handle: 'security')
-
-          items = #{self}.get_hacktivity
-
-          intents = #{self}.get_report_intents
-          intent  = #{self}.get_report_intent(id: 1)
-          intent  = #{self}.create_report_intent(body: { data: { type: 'report-intent', attributes: {} } })
-          intent  = #{self}.update_report_intent(id: 1, body: { data: { type: 'report-intent', attributes: {} } })
-          #{self}.submit_report_intent(id: 1)
-          #{self}.delete_report_intent(id: 1)
-          atts = #{self}.get_report_intent_attachments(report_intent_id: 1)
-          #{self}.delete_report_intent_attachment(report_intent_id: 1, id: 2)
-
-          json = #{self}.api(
-            path: 'me/reports',
-            method: :get,
-            params: { page: { number: 1 } }
+          # ---- Reports -------------------------------------------------------
+          #{self}.get_me_reports(
+            params: 'optional - query params Hash (e.g. page/filter)',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
           )
 
-          #{self}.logout(h1_obj: h1_obj)
+          # Run get report and return its result
+          #{self}.get_report(
+            id: 'required - report id',
+            username: 'optional - optional, api_key: optional, h1_obj: optional',
+            params: 'optional - params value consumed by #get_report'
+          )
+
+          # Run create report and return its result
+          #{self}.create_report(
+            team_handle: 'required - program handle',
+            title: 'required - report title',
+            vulnerability_information: 'required - detailed description',
+            impact: 'optional - impact text',
+            severity_rating: 'optional - none|low|medium|high|critical',
+            weakness_id: 'optional - weakness id integer',
+            structured_scope_id: 'optional - structured scope id value consumed by #create_report',
+            body: 'optional - full JSON:API body Hash (overrides attribute kwargs)',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # ---- Payments ------------------------------------------------------
+          #{self}.get_balance(
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get earnings and return its result
+          #{self}.get_earnings(
+            params: 'optional - query params Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get payouts and return its result
+          #{self}.get_payouts(
+            params: 'optional - query params Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # ---- Programs -------------------------------------------------------
+          #{self}.get_programs(
+            params: 'optional - query params Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get program and return its result
+          #{self}.get_program(
+            handle: 'required - program handle',
+            username: 'optional - optional, api_key: optional, h1_obj: optional',
+            params: 'optional - params value consumed by #get_program'
+          )
+
+          # Run get structured scopes and return its result
+          #{self}.get_structured_scopes(
+            handle: 'required - program handle',
+            params: 'optional - params value consumed by #get_structured_scopes',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get scope exclusions and return its result
+          #{self}.get_scope_exclusions(
+            handle: 'required - program handle',
+            params: 'optional - params value consumed by #get_scope_exclusions',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get weaknesses and return its result
+          #{self}.get_weaknesses(
+            handle: 'required - program handle',
+            params: 'optional - params value consumed by #get_weaknesses',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # ---- Hacktivity -----------------------------------------------------
+          #{self}.get_hacktivity(
+            params: 'optional - query params Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # ---- Report Intents ------------------------------------------------
+          #{self}.get_report_intents(
+            params: 'optional - params value consumed by #get_report_intents',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get report intent and return its result
+          #{self}.get_report_intent(
+            id: 'required - report intent id',
+            username: 'optional - optional, api_key: optional, h1_obj: optional',
+            params: 'optional - params value consumed by #get_report_intent'
+          )
+
+          # Run create report intent and return its result
+          #{self}.create_report_intent(
+            body: 'required - full JSON:API body Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run update report intent and return its result
+          #{self}.update_report_intent(
+            id: 'required - report intent id',
+            body: 'required - full JSON:API body Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run delete report intent and return its result
+          #{self}.delete_report_intent(
+            id: 'required - report intent id',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run submit report intent and return its result
+          #{self}.submit_report_intent(
+            id: 'required - report intent id',
+            body: 'optional - JSON:API body Hash',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Run get report intent attachments and return its result
+          #{self}.get_report_intent_attachments(
+            report_intent_id: 'required - report intent id value consumed by #get_report_intent_attachments (defaults to opts[:id])',
+            username: 'optional - optional, api_key: optional, h1_obj: optional',
+            id: 'required - id value consumed by #get_report_intent_attachments',
+            params: 'optional - params value consumed by #get_report_intent_attachments'
+          )
+
+          # Run delete report intent attachment and return its result
+          #{self}.delete_report_intent_attachment(
+            report_intent_id: 'required - report intent id value consumed by #delete_report_intent_attachment',
+            id: 'required - attachment id',
+            username: 'optional - optional, api_key: optional, h1_obj: optional'
+          )
+
+          # Clears the session hash in-place (no server-side session to destroy)
+          #{self}.logout(
+            h1_obj: 'required - required h1_obj returned from #login method'
+          )
+
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/plugins/hunter.rb

@@ -142,18 +142,21 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          search_results = #{self}.query(
-            api_key: 'required hunter api key',
+          # Run a search using the open session.
+          #{self}.search(
+            api_key: 'required - required hunter api key',
             query: 'required - hunter search query',
             start_time: 'required - start date for the search (format is yyyy-mm-dd)',
             end_time: 'required - end date for the search (format is yyyy-mm-dd)',
             start_page: 'optional - starting page number for pagination (default is 1)',
             page_size: 'optional - number of results per page (default is 10)',
-            fields: 'optional - comma-separated list of fields 'product,transport_protocol,protocol,banner,country,province,city,asn,org,web,updated_at' (default is nil)'
+            fields: 'optional - comma-separated list of fields product,transport_protocol,protocol,banner,country,province,city,asn,org,web,updated_at (default is nil)'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end

data/lib/pwn/plugins/ip_info.rb

@@ -235,29 +235,34 @@ module PWN
 
       public_class_method def self.help
         puts "USAGE:
-          is_rfc1918 = #{self}.check_rfc1918(
+          # Run check rfc1918 and return its result
+          #{self}.check_rfc1918(
             ip: 'required - IP to check'
           )
 
-          ip_info_struc = #{self}.get(
+          # Run get and return its result
+          #{self}.get(
             target: 'required - IP or Host to lookup',
             proxy: 'optional - use a proxy',
-            tls_port: 'optional port to check cert for Domain Name (default: 443). Will not execute if proxy parameter is set.',
+            tls_port: 'optional - optional port to check cert for Domain Name (default: 443). Will not execute if proxy parameter is set.',
             skip_api: 'optional - skip the API call',
             dns_server: 'optional - DNS server to use for lookup (default: your default DNS server)'
           )
 
+          # Run bruteforce subdomains and return its result
           #{self}.bruteforce_subdomains(
             parent_domain: 'required - Parent Domain to brute force',
             dictionary: 'required - Dictionary to use for subdomain brute force',
             max_threads: 'optional - Maximum number of threads to use (default: 9)',
             proxy: 'optional - use a proxy',
-            tls_port: 'optional port to check cert for Domain Name (default: 443). Will not execute if proxy parameter is set.',
+            tls_port: 'optional - optional port to check cert for Domain Name (default: 443). Will not execute if proxy parameter is set.',
             results_file: 'optional - File to write results to (default: /tmp/parent_domain-timestamp-pwn_bruteforce_subdomains.txt)'
           )
 
+          # Print the AUTHOR(S) string for this module.
           #{self}.authors
         "
+        constants.sort
       end
     end
   end