pwn 0.5.453 → 0.5.454

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f982dbb3d13b5265962550f36483fc05a2dede69703bcab6280220e3d9e5236a
-  data.tar.gz: d60195b0c4cc4da80e7bda578eb075068fba641199ca7e6a542f01bf894713d0
+  metadata.gz: aed16afd310606181c270f790e5d0ca4f01dc445079567529e6e97ca0af76a36
+  data.tar.gz: 0b8dbd25d99f28c387197b1277a5b38fdd2b4057630de4871dac0dff9d0fc3fd
 SHA512:
-  metadata.gz: 0ff8680a5ad5e6cfb9334c118d0f6e3c5075b838456e6506125f0bbb1e8be76aeba5e434207da773fdc938513b0ccc972e9e9536004c363bf6dddbb8ae8f0f24
-  data.tar.gz: 79383331c61866288d3121c6a79f66436b2c0ad63569f44a742467bf77885be15be16368a956bbccdb72778bf7ac0b7c0451dd875762e2f6f2a3f22c0e05ee37
+  metadata.gz: 8366e85a05f0ca4bac9f0e437475ebe1b940c0ba989fad3de6456c852f55bee610420bdcb62cebe8d8554f28e000fb40ffa2a0b75e59e6b389b5fb51a9518b5b
+  data.tar.gz: 4ba3401047fd228b509cf3c51392de3f32b4102cd229ee88d8b5dc244889a20b379f37db9eafcf754d5c0537b36218f7a9ba542eda0436df08fef193380d59ff

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-14 20:09:17 UTC using RuboCop version 1.81.1.
+# on 2025-10-16 16:52:19 UTC using RuboCop version 1.81.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -30,7 +30,7 @@ Lint/RedundantTypeConversion:
     - 'lib/pwn/plugins/jenkins.rb'
     - 'lib/pwn/plugins/repl.rb'
 
-# Offense count: 283
+# Offense count: 287
 # This cop supports safe autocorrection (--autocorrect).
 Lint/UselessAssignment:
   Enabled: false
@@ -101,11 +101,12 @@ Style/ExplicitBlockArgument:
   Exclude:
     - 'lib/pwn/plugins/nmap_it.rb'
 
-# Offense count: 1
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: MinBodyLength, AllowConsecutiveConditionals.
 Style/GuardClause:
   Exclude:
+    - 'lib/pwn/driver.rb'
     - 'lib/pwn/plugins/monkey_patch.rb'
 
 # Offense count: 1

data/Gemfile

@@ -19,7 +19,7 @@ gem 'barby', '0.7.0'
 gem 'base32', '0.3.4'
 gem 'bitcoin-ruby', '0.0.20'
 gem 'brakeman', '7.1.0'
-gem 'bson', '5.1.1'
+gem 'bson', '5.2.0'
 gem 'bundler', '>=2.7.2'
 gem 'bundler-audit', '0.9.2'
 gem 'bunny', '2.24.0'
@@ -100,7 +100,7 @@ gem 'uart', '1.0.0'
 gem 'watir', '7.3.0'
 gem 'waveform', '0.1.3'
 gem 'webrick', '1.9.1'
-gem 'whois', '6.0.2'
+gem 'whois', '6.0.3'
 gem 'whois-parser', '2.0.0'
 gem 'wicked_pdf', '2.8.2'
 gem 'yard', '0.9.37'

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.453]:001 >>> PWN.help
+pwn[v0.5.454]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.4.4@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.453]:001 >>> PWN.help
+pwn[v0.5.454]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.4.4@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.453]:001 >>> PWN.help
+pwn[v0.5.454]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/bin/pwn

@@ -3,24 +3,13 @@
 
 require 'pwn'
 
-opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
-  options.on('-YPATH', '--pwn-env=PATH', '<Optional - PWN YAML File>') do |p|
-    opts[:pwn_env_path] = p
-  end
-
-  options.on('-ZPATH', '--pwn-dec=PATH', '<Optional - Out-of-Band YAML File with :key && :iv>') do |d|
-    opts[:pwn_dec_path] = d
-  end
-end.parse!
+pwn_driver = PWN::Driver::Parser.new
+pwn_driver.auto_opts_help = false
+pwn_driver.parse!
 
 begin
   pwn_pid = Process.pid
-  PWN::Plugins::REPL.start(opts)
+  PWN::Plugins::REPL.start
 rescue StandardError => e
   raise e
 ensure

data/bin/pwn_android_war_dialer

@@ -5,11 +5,7 @@ require 'pwn'
 require 'waveform'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-fFROM', '--from=FROM', '<Required - Dial Range from (Beginning Number)>') do |f|
     opts[:from_num] = f
   end
@@ -43,11 +39,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 # Required Flag Variables
 from_num = opts[:from_num].to_s.scrub.strip.chomp.delete('(').delete(')').delete('-').delete('.').delete('+').to_i
 to_num = opts[:to_num].to_s.scrub.strip.chomp.delete('(').delete(')').delete('-').delete('.').delete('+').to_i

data/bin/pwn_aws_describe_resources

@@ -5,11 +5,7 @@ require 'aws-sdk'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-rREGION', '--region=REGION', '<Required - Region to Describe>') do |region|
     opts[:region] = region
   end
@@ -39,11 +35,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 logger = PWN::Plugins::PWNLogger.create
 
 if opts[:yaml]

data/bin/pwn_bdba_groups

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-cCONFIG', '--config=CONFIG', '<Required - Black Duck Binary Analysis YAML config>') do |c|
     opts[:config] = c
   end
@@ -34,11 +30,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 begin
   pwn_provider = 'ruby-gem'
   pwn_provider = ENV.fetch('PWN_PROVIDER') if ENV.keys.any? { |s| s == 'PWN_PROVIDER' }

data/bin/pwn_bdba_scan

@@ -5,11 +5,7 @@ require 'cgi'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-cCONFIG', '--config=CONFG', '<Required - Black Duck Binary Analysis YAML config>') do |g|
     opts[:config] = g
   end
@@ -51,11 +47,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 abort_total = 1
 begin
   pwn_provider = 'ruby-gem'

data/bin/pwn_burp_suite_pro_active_rest_api_scan

@@ -5,11 +5,7 @@ require 'pwn'
 require 'uri'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-tTARGET', '--target_url=TARGET', '<Required - Target URI to Scan>') do |t|
     opts[:target_url] = t
   end
@@ -63,11 +59,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 begin
   timestamp = Time.now.strftime('%Y-%m-%d_%H-%M-%S%Z')
   logger = PWN::Plugins::PWNLogger.create

data/bin/pwn_burp_suite_pro_active_scan

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-tTARGET', '--target_url=TARGET', '<Required - Target URI to Scan>') do |t|
     opts[:target_url] = t
   end
@@ -46,11 +42,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 begin
   logger = PWN::Plugins::PWNLogger.create
 

data/bin/pwn_char_base64_encoding

@@ -5,20 +5,11 @@ require 'base64'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-pSTRING', '--payload=STRING', '<Required - String to Encode>') do |p|
     opts[:payload] = p
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 payload = opts[:payload].to_s.scrub
 puts Base64.strict_encode64(payload)

data/bin/pwn_char_dec_encoding

@@ -4,20 +4,11 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-pSTRING', '--payload=STRING', '<Required - String to Encode>') do |p|
     opts[:payload] = p
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 payload = opts[:payload].to_s.scrub
 puts payload.unpack('C*')

data/bin/pwn_char_hex_escaped_encoding

@@ -4,21 +4,12 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-pSTRING', '--payload=STRING', '<Required - String to Encode>') do |p|
     opts[:payload] = p
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 payload = opts[:payload].to_s.scrub
 payload.each_char do |char|
   print "\\x#{char.to_s.unpack1('H*')}"

data/bin/pwn_char_html_entity_encoding

@@ -5,20 +5,11 @@ require 'cgi'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-pSTRING', '--payload=STRING', '<Required - String to Encode>') do |p|
     opts[:payload] = p
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 payload = opts[:payload].to_s.scrub
 puts CGI.escapeHTML(payload)

data/bin/pwn_char_unicode_escaped_encoding

@@ -4,20 +4,11 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-pSTRING', '--payload=STRING', '<Required - String to Encode>') do |p|
     opts[:payload] = p
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 payload = opts[:payload].to_s.scrub
 puts payload.unpack('U*').map { |i| "\\u#{i.to_s(16).rjust(4, '0')}" }.join

data/bin/pwn_char_url_encoding

@@ -5,20 +5,11 @@ require 'cgi'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-pSTRING', '--payload=STRING', '<Required - String to Encode>') do |p|
     opts[:payload] = p
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 payload = opts[:payload].to_s.scrub
 puts CGI.escape(payload)

data/bin/pwn_crt_sh

@@ -5,11 +5,7 @@ require 'nokogiri'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-tDOMAIN', '--target-domain=DOMAIN', '<Required - Target Domain>') do |t|
     opts[:target_domain] = t
   end
@@ -23,11 +19,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 begin
   target_domain = opts[:target_domain]
   raise 'No target domain provided' if target_domain.nil?

data/bin/pwn_defectdojo_engagement_create

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-uURL', '--url=URL', '<Required - DefectDojo URL>') do |u|
     opts[:url] = u
   end
@@ -94,11 +90,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 # Construct AuthN Args
 url = opts[:url]
 api_version = opts[:api_version]

data/bin/pwn_defectdojo_importscan

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-uURL', '--url=URL', '<Required - DefectDojo URL>') do |u|
     opts[:url] = u
   end
@@ -82,11 +78,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 # Construct AuthN Args
 url = opts[:url]
 api_version = opts[:api_version]

data/bin/pwn_defectdojo_reimportscan

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-uURL', '--url=URL', '<Required - DefectDojo URL>') do |u|
     opts[:url] = u
   end
@@ -74,11 +70,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 # Construct AuthN Args
 url = opts[:url]
 api_version = opts[:api_version]

data/bin/pwn_diff_csv_files_w_column_exclude

@@ -5,7 +5,7 @@ require 'csv'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
+PWN::Driver::Parser.new do |options|
   options.banner = "USAGE:
     #{File.basename($PROGRAM_NAME)} [opts]
     EXAMPLE w/ Tenable Nessus Results:
@@ -44,11 +44,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 def ommit_columns_by_index(opts = {})
   csv = opts[:csv]
   columns_index_arr = opts[:columns_index_arr]

data/bin/pwn_domain_reversewhois

@@ -6,11 +6,7 @@ require 'nokogiri'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-sRFILTER', '--registrant-filter=RFILTER', '<Required - Registrant Name or Email Address>') do |s|
     opts[:registrant_filter] = s
   end
@@ -24,11 +20,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 registrant_filter = opts[:registrant_filter].to_s.strip.chomp.scrub
 output_results = opts[:output_results].to_s.strip.chomp.scrub
 proxy = opts[:proxy].to_s.scrub.strip.chomp unless opts[:proxy].nil?

data/bin/pwn_fuzz_net_app_proto

@@ -5,11 +5,7 @@ require 'htmlentities'
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-dDIR', '--dir-path=DIR', '<Required - Report Output Directory>') do |d|
     opts[:dir_path] = d
   end
@@ -75,11 +71,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 pwn_provider = 'ruby-gem'
 # pwn_provider = ENV.fetch('PWN_PROVIDER') if ENV.keys.select { |s| s == 'PWN_PROVIDER' }.any?
 pwn_provider = ENV.fetch('PWN_PROVIDER') if ENV.keys.any? { |s| s == 'PWN_PROVIDER' }

data/bin/pwn_gqrx_scanner

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-aPROFILE', '--assume-profile=PROFILE', '<Required if "--target-freq" is Nil - Profile to assume for common radio protocols.  Use "--list-profiles" to display supported protocols (Defaults to nil)') do |p|
     opts[:profile] = p
   end
@@ -74,11 +70,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 begin
   pwn_provider = 'ruby-gem'
   pwn_provider = ENV.fetch('PWN_PROVIDER') if ENV.keys.any? { |s| s == 'PWN_PROVIDER' }

data/bin/pwn_jenkins_create_job

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-sIP', '--ip=IP', '<Required - Jenkins Server IP>') { |s| opts[:ip] = s }
 
   options.on('-dPORT', '--dest-port=PORT', '<Optional - Jenkins Server Port (Defaults to 8080)>') do |port|
@@ -32,11 +28,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 ip = opts[:ip].to_s.scrub
 port = opts[:port].to_i
 username = opts[:username]

data/bin/pwn_jenkins_create_view

@@ -4,11 +4,7 @@
 require 'pwn'
 
 opts = PWN::Env[:driver_opts]
-OptionParser.new do |options|
-  options.banner = "USAGE:
-    #{File.basename($PROGRAM_NAME)} [opts]
-  "
-
+PWN::Driver::Parser.new do |options|
   options.on('-sIP', '--ip=IP', '<Required - Jenkins Server IP>') { |s| opts[:ip] = s }
 
   options.on('-dPORT', '--dest-port=PORT', '<Optional - Jenkins Server Port (Defaults to 8080)>') do |port|
@@ -32,11 +28,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-if opts.empty?
-  puts `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
-
 ip = opts[:ip].to_s.scrub
 port = opts[:port].to_i
 username = opts[:username]