ronin 1.5.1 → 2.0.0.beta1

data/Gemfile

@@ -1,60 +1,73 @@
 source 'https://rubygems.org'
 
-DM_URI     = 'https://github.com/datamapper'
-DM_VERSION = '~> 1.2'
-DO_VERSION = '~> 0.10.3'
-RONIN_URI  = 'https://github.com/ronin-rb'
-
 gemspec
 
 gem 'jruby-openssl',	'~> 0.7', platforms: :jruby
 
-# DataMapper dependencies
-# gem 'data_objects',       DO_VERSION, git: "#{DM_URI}/do.git"
-# gem 'do_sqlite3',         DO_VERSION, git: "#{DM_URI}/do.git"
-# gem 'dm-do-adapter',      DM_VERSION, git: "#{DM_URI}/dm-do-adapter.git"
-# gem 'dm-sqlite-adapter',  DM_VERSION, git: "#{DM_URI}/dm-sqlite-adapter.git"
-# gem 'dm-core',            DM_VERSION, git: "#{DM_URI}/dm-core.git"
-# gem 'dm-types',           DM_VERSION, git: "#{DM_URI}/dm-types.git"
-# gem 'dm-migrations',      DM_VERSION, git: "#{DM_URI}/dm-migrations.git"
-# gem 'dm-validations',     DM_VERSION, git: "#{DM_URI}/dm-validations.git"
-# gem 'dm-serializer',      DM_VERSION, git: "#{DM_URI}/dm-serializer.git"
-# gem 'dm-aggregates',      DM_VERSION, git: "#{DM_URI}/dm-aggregates.git"
-# gem 'dm-timestamps',      DM_VERSION, git: "#{DM_URI}/dm-timestamps.git"
+gem 'net-telnet', '~> 0.1', group: :net
+if RUBY_VERSION >= '3.1.0'
+  gem 'net-ftp',    '~> 0.1', group: :net, platform: :mri
+  gem 'net-smtp',   '~> 0.1', group: :net, platform: :mri
+  gem 'net-pop',    '~> 0.1', group: :net, platform: :mri
+  gem 'net-imap',   '~> 0.1', group: :net, platform: :mri
+end
+
+# gem 'command_kit', '~> 0.4', github: 'postmodern/command_kit.rb',
+#                              branch: '0.4.0'
+
+group :database do
+  gem 'sqlite3', '~> 1.0', platform: :mri
+  gem 'activerecord-jdbcsqlite3-adapter', '~> 70.0.pre', platform: :jruby
+end
 
 # Library dependencies
-# gem 'ronin-support',	'~> 0.5', git: "#{RONIN_URI}/ronin-support.git",
-#                                 branch: 'main'
+# gem 'ronin-support',	       '~> 1.0', github: "ronin-rb/ronin-support",
+#                                        branch: 'main'
+# gem 'ronin-core',            '~> 0.1', github: "ronin-rb/ronin-core",
+#                                        branch: 'main'
+# gem 'ronin-repos',           '~> 0.1', github: "ronin-rb/ronin-repos",
+#                                        branch: 'main'
+# gem 'ronin-db',              '~> 0.1', github: "ronin-rb/ronin-db",
+#                                        branch: 'main'
+# gem 'ronin-db-activerecord', '~> 0.1', github: "ronin-rb/ronin-db-activerecord",
+#                                        branch: 'main'
+# gem 'ronin-fuzzer',          '~> 0.1', github: "ronin-rb/ronin-fuzzer",
+#                                        branch: 'main'
+# gem 'ronin-post_ex',         '~> 0.1', github: "ronin-rb/ronin-post_ex",
+#                                        branch: 'main'
+# gem 'ronin-code-asm',        '~> 1.0', github: "ronin-rb/ronin-code-asm",
+#                                        branch: 'main'
+# gem 'ronin-code-sql',        '~> 2.0', github: "ronin-rb/ronin-code-sql",
+#                                        branch: 'main'
+# gem 'ronin-payloads',        '~> 0.1', github: "ronin-rb/ronin-payloads",
+#                                        branch: 'main'
+# gem 'ronin-exploits',        '~> 1.0', github: "ronin-rb/ronin-exploits",
+#                                        branch: 'main'
+# gem 'ronin-vulns',           '~> 0.1', github: "ronin-rb/ronin-vulns",
+#                                        branch: 'main'
+# gem 'ronin-web-server',	     '~> 0.1', github: "ronin-rb/ronin-web-server",
+#                                        branch: 'main'
+# gem 'ronin-web-spider',	     '~> 0.1', github: "ronin-rb/ronin-web-spider",
+#                                        branch: 'main'
+# gem 'ronin-web-user_agents', '~> 0.1', github: "ronin-rb/ronin-web-user_agents",
+#                                        branch: 'main'
+# gem 'ronin-web',             '~> 1.0', github: "ronin-rb/ronin-web",
+#                                        branch: 'main'
 
 group :development do
   gem 'rake'
-  gem 'rubygems-tasks', '~> 0.1'
-  gem 'rspec',          '~> 3.0'
+  gem 'rubygems-tasks',  '~> 0.1'
+  gem 'rspec',           '~> 3.0'
+  gem 'simplecov',       '~> 0.20'
 
-  gem 'kramdown',      '~> 2.0'
-  gem 'kramdown-man',  '~> 0.1'
+  gem 'kramdown',        '~> 2.0'
+  gem 'kramdown-man',    '~> 0.1'
 
-  gem 'ruby-graphviz',  '~> 0.9.10'
-  gem 'dm-visualizer',  '~> 0.2.0'
-end
+  gem 'redcarpet',       platform: :mri
+  gem 'yard',            '~> 0.9'
+  gem 'yard-spellcheck', require: false
 
-#
-# To enable additional DataMapper adapters for development work or for
-# testing purposes, simple set the ADAPTER or ADAPTERS environment
-# variable:
-#
-#     export ADAPTER="postgres"
-#     bundle install
-#
-#     ./bin/ronin --database postgres://ronin@localhost/ronin
-#
-require 'set'
-
-DM_ADAPTERS = Set['postgres', 'mysql', 'oracle', 'sqlserver']
-
-adapters = (ENV['ADAPTER'] || ENV['ADAPTERS']).to_s
-adapters = Set.new(adapters.to_s.tr(',',' ').split)
-
-(DM_ADAPTERS & adapters).each do |adapter|
-  gem "dm-#{adapter}-adapter", DM_VERSION #, git: "#{DM_URI}/dm-#{adapter}-adapter.git"
+  gem 'dead_end',        require: false
+  gem 'sord',            require: false, platform: :mri
+  gem 'stackprof',       require: false, platform: :mri
 end

data/README.md

@@ -6,175 +6,163 @@
 * [Website](https://ronin-rb.dev)
 * [Source](https://github.com/ronin-rb/ronin)
 * [Issues](https://github.com/ronin-rb/ronin/issues)
-* [Documentation](https://ronin-rb.github.com/docs/ronin/frames)
-* [Slack](https://ronin-rb.slack.com) |
-  [Discord](https://discord.gg/6WAb3PsVX9) |
+* [Documentation](https://ronin-rb.dev/docs/ronin/frames)
+* [Discord](https://discord.gg/6WAb3PsVX9) |
   [Twitter](https://twitter.com/ronin_rb) |
-  [IRC](https://ronin-rb.dev/irc/)
+  [Mastodon](https://infosec.exchange/@ronin_rb)
 
 ## Description
 
-Ronin is a [Ruby] platform for vulnerability research and [exploit development].
-Ronin allows for the rapid development and distribution of code,
-[Exploits][example-exploit], [Payloads][example-payload],
-[Scanners][example-scanner], etc, via [Repositories].
-
-### Console
-
-Ronin provides users with a powerful Ruby Console, pre-loaded with powerful
-convenience methods. In the Console one can work with data and automate
-complex tasks, with greater ease than the command-line.
-
-    >> File.read('data').base64_decode
-
-### Database
-
-Ronin ships with a preconfigured Database, that one can interact with from Ruby,
-without having to write any SQL.
-
-    >> HostName.tld('eu').urls.with_query_param('id')
-
-### Repositories
-
-Ronin provides a Repository system, allowing users to organize and share
-miscallaneous Data, Code, [Exploits][example-exploit],
-[Payloads][example-payload], [Scanners][example-scanner], etc.
-
-    $ ronin install git://github.com/user/myexploits.git
-
-### Libraries
-
-Ronin provides libraries with additional functionality, such as
-[Exploitation][ronin-exploits] and [Scanning][ronin-scanners]:
-
-    $ gem install ronin-exploits
-
-## Features
-
-* Supports installing/updating/uninstalling of Repositories.
-  * Supports installing Repositories from various media types:
-    * [Subversion (SVN)][svn]
-    * [Mercurial (Hg)][hg]
-    * [Git][git]
-    * Rsync
-* Provides a Database using [DataMapper] with:
-  * {Ronin::Author}
-  * {Ronin::License}
-  * {Ronin::Arch}
-  * {Ronin::OS}
-  * {Ronin::Software}
-  * {Ronin::Vendor}
-  * {Ronin::Address}
-    * {Ronin::MACAddress}
-    * {Ronin::IPAddress}
-    * {Ronin::HostName}
-  * {Ronin::Port}
-    * {Ronin::TCPPort}
-    * {Ronin::UDPPort}
-  * {Ronin::Service}
-  * {Ronin::OpenPort}
-  * {Ronin::OSGuess}
-  * {Ronin::UserName}
-  * {Ronin::URL}
-  * {Ronin::EmailAddress}
-  * {Ronin::Credential}
-    * {Ronin::ServiceCredential}
-    * {Ronin::WebCredential}
-  * {Ronin::Organization}
-  * {Ronin::Campaign}
-  * {Ronin::Target}
-* Caches exploits, payloads, scanners, etc stored within Repositories
-  into the Database.
-* Convenience methods provided by [ronin-support].
-* Provides a customized Ruby Console using [Ripl][ripl] with:
-  * Syntax highlighting.
-  * Tab completion.
-  * Auto indentation.
-  * Pretty Printing (`pp`).
-  * `print_info`, `print_error`, `print_warning` and `print_debug`
-    output helper methods with color-output.
-  * Inline commands (`!nmap -v -sT victim.com`)
-* Provides an extensible command-line interface.
+[Ronin][ronin-rb] is a [Ruby] toolkit for security research and development.
 
-## Synopsis
-
-Start the Ronin console:
-
-    $ ronin
-
-Run a Ruby script in Ronin:
-
-    $ ronin exec script.rb
-
-View available commands:
-
-    $ ronin help
-
-View a man-page for a command:
-
-    $ ronin help wordlist
+### Who is Ronin for?
 
-Install a Repository:
+* CTF players
+* Bug bounty hunters
+* Security Researchers
+* Security Engineers
+* Developers
+* Students
 
-    $ ronin install svn://example.com/path/to/repo
+### What does Ronin provide?
 
-List installed Repositories:
+* A toolkit of useful commands.
+* A fully-loaded Ruby REPL.
+* An ecosystem of high-quality security related Ruby libraries, API, and
+  commands.
 
-    $ ronin repos
+### What can you do with Ronin?
 
-Update all installed Repositories:
+* Quickly process and query various data using the `ronin` commands.
+* Efficiently work with code and data in the `ronin irb` Ruby REPL.
+* Rapidly prototype Ruby scripts using [ronin-support] and other `ronin`
+  libraries.
+* Install 3rd-party [git] repositories of exploits, payloads, or other code,
+  using [ronin-repos].
+* Import and query data using the [ronin-db] database.
+* Fuzz data using [ronin-fuzzer].
+* Use common payloads or write your own using [ronin-payloads].
+* Write/run exploits using [ronin-exploits].
+* Scan for web vulnerabilities using [ronin-vulns].
 
-    $ ronin update
-
-Update a specific Repositories:
-
-    $ ronin update repo-name
-
-Uninstall a specific Repositories:
+## Synopsis
 
-    $ ronin uninstall repo-name
+```
+Usage: ronin [options] [COMMAND [ARGS...]]
+
+Options:
+    -h, --help                       Print help information
+
+Arguments:
+    [COMMAND]                        The command name to run
+    [ARGS ...]                       Additional arguments for the command
+
+Commands:
+    asn
+    banner-grab
+    bitflip
+    cert-dump
+    cert-gen
+    cert-grab
+    decode, dec
+    decrypt
+    dns
+    email-addr
+    encode, enc
+    encrypt
+    entropy
+    escape
+    extract
+    grep
+    help
+    hexdump
+    highlight
+    hmac
+    homoglyph
+    host
+    http
+    ip
+    iprange
+    irb
+    md5
+    netcat, nc
+    new
+    proxy
+    public-suffix-list
+    quote
+    rot
+    sha1
+    sha256
+    sha512
+    strings
+    tld-list
+    tips
+    typo
+    typosquat
+    unescape
+    unhexdump
+    unquote
+    url
+    xor
+
+Additional Ronin Commands:
+    $ ronin-repos
+    $ ronin-db
+    $ ronin-web
+    $ ronin-fuzzer
+    $ ronin-payloads
+    $ ronin-exploits
+    $ ronin-vulns
+```
+
+List ronin commands:
+
+```shell
+$ ronin help
+```
 
-List available Databases:
+View a man-page for a command:
 
-    $ ronin database
+```shell
+$ ronin help COMMAND
+```
 
-Add a new Database:
+Get a random tip on how to use `ronin`:
 
-    $ ronin database --add team --uri mysql://user:pass@vpn.example.com/db
+```shell
+$ ronin tips
+```
 
-Remove a Database:
+Open the Ronin Ruby REPL:
 
-    $ ronin database --remove team
+```shell
+$ ronin irb
+```
 
 ## Requirements
 
-* [Ruby] >= 1.8.7
-* [DataMapper]:
-  * [dm-sqlite-adapter] ~> 1.2
-    * [libsqlite3]
-  * [dm-core] ~> 1.2
-  * [dm-types] ~> 1.2
-  * [dm-migrations] ~> 1.2
-  * [dm-validations] ~> 1.2
-  * [dm-aggregates] ~> 1.2
-  * [dm-timestamps] ~> 1.2
-* [dm-is-predefined] ~> 0.4
-* [uri-query_params] ~> 0.6
+* [Ruby] >= 3.0.0
 * [open_namespace] ~> 0.4
-* [data_paths] ~> 0.3
-* [object_loader] ~> 1.0
-* [parameters] ~> 0.4
-* [pullr] ~> 0.1, >= 0.1.2
-* [ripl] ~> 0.3
-* [ripl-multi_line] ~> 0.2
-* [ripl-auto_indent] ~> 0.1
-* [ripl-short_errors] ~> 0.1
-* [ripl-color_result] ~> 0.3
-* [ronin-support] ~> 0.5
+* [rouge] ~> 3.0
+* [async-io] ~> 1.0
+* [wordlist] ~> 1.0
+* [ronin-support] ~> 1.0
+* [ronin-core] ~> 0.1
+* [ronin-repos] ~> 0.1
+* [ronin-db] ~> 0.1
+* [ronin-fuzzer] ~> 0.1
+* [ronin-web] ~> 1.0
+* [ronin-code-asm] ~> 1.0
+* [ronin-code-sql] ~> 2.0
+* [ronin-payloads] ~> 0.1
+* [ronin-exploits] ~> 1.0
+* [ronin-vulns] ~> 0.1
 
 ## Install
 
-    $ gem install ronin
+```shell
+$ gem install ronin
+```
 
 ## Development
 
@@ -189,9 +177,7 @@ Remove a Database:
 
 ## License
 
-Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-
-This file is part of ronin.
+Copyright (c) 2006-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 
 Ronin is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -206,40 +192,23 @@ GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with Ronin.  If not, see <https://www.gnu.org/licenses/>.
 
+[ronin-rb]: https://ronin-rb.dev/
 [Ruby]: https://www.ruby-lang.org
-[exploit development]: https://www.exploit-db.com
-[example-exploit]: https://github.com/ronin-rb/example-repo/blob/master/scripts/exploits/http/oracle/dav_bypass.rb
-[example-payload]: https://gist.github.com/1403961
-[example-scanner]: https://github.com/ronin-rb/example-repo/blob/master/scripts/scanners/oracle_dad_scanner.rb
-[Repositories]: https://github.com/ronin-rb/example-repo
+[open_namespace]: https://github.com/postmodern/open_namespace#readme
+[rouge]: https://github.com/rouge-ruby/rouge#readme
+[async-io]: https://github.com/socketry/async-io#readme
+[wordlist]: https://github.com/postmodern/wordlist.rb#readme
 
 [ronin-support]: https://github.com/ronin-rb/ronin-support#readme
+[ronin-repos]: https://github.com/ronin-rb/ronin-repos#readme
+[ronin-core]: https://github.com/ronin-rb/ronin-core#readme
+[ronin-db]: https://github.com/ronin-rb/ronin-db#readme
+[ronin-fuzzer]: https://github.com/ronin-rb/ronin-fuzzer#readme
+[ronin-web]: https://github.com/ronin-rb/ronin-web#readme
+[ronin-code-asm]: https://github.com/ronin-rb/ronin-code-asm#readme
+[ronin-code-sql]: https://github.com/ronin-rb/ronin-code-sql#readme
+[ronin-payloads]: https://github.com/ronin-rb/ronin-payloads#readme
 [ronin-exploits]: https://github.com/ronin-rb/ronin-exploits#readme
-[ronin-scanners]: https://github.com/ronin-rb/ronin-scanners#readme
+[ronin-vulns]: https://github.com/ronin-rb/ronin-vulns#readme
 
-[svn]: https://subversion.apache.org/
-[hg]: https://www.mercurial-scm.org/
 [git]: https://git-scm.com/
-
-[DataMapper]: http://datamapper.org
-[dm-sqlite-adapter]: https://github.com/datamapper/dm-sqlite-adapter#readme
-[libsqlite3]: https://sqlite.org/
-[dm-core]: https://github.com/datamapper/dm-core#readme
-[dm-types]: https://github.com/datamapper/dm-types#readme
-[dm-migrations]: https://github.com/datamapper/dm-migrations#readme
-[dm-validations]: https://github.com/datamapper/dm-validations#readme
-[dm-aggregates]: https://github.com/datamapper/dm-aggregates#readme
-[dm-timestamps]: https://github.com/datamapper/dm-timestamps#readme
-[dm-is-predefined]: https://github.com/postmodern/dm-is-predefined#readme
-[uri-query_params]: https://github.com/postmodern/uri-query_params#readme
-[open_namespace]: https://github.com/postmodern/open_namespace#readme
-[data_paths]: https://github.com/postmodern/data_paths#readme
-[object_loader]: https://github.com/postmodern/object_loader#readme
-[parameters]: https://github.com/postmodern/parameters#readme
-[pullr]: https://github.com/postmodern/pullr#readme
-[ripl]: https://github.com/cldwalker/ripl#readme
-[ripl-multi_line]: https://github.com/janlelis/ripl-multi_line#readme
-[ripl-auto_indent]: https://github.com/janlelis/ripl-auto_indent#readme
-[ripl-short_errors]: https://rubygems.org/gems/ripl-short_errors
-[ripl-color_result]: https://github.com/janlelis/ripl-color_result#readme
-[ronin-support]: https://github.com/ronin-rb/ronin-support#readme

data/Rakefile

@@ -19,65 +19,18 @@ end
 require 'rake'
 
 require 'rubygems/tasks'
-Gem::Tasks.new(:sign => {:checksum => true, :pgp => true}) do |tasks|
-  tasks.console.command = 'ripl'
-  tasks.console.options = %w[
-    -rripl/multi_line
-    -rripl/auto_indent
-    -rripl/color_result
-  ]
-end
+Gem::Tasks.new(sign: {checksum: true, pgp: true})
 
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new
-task :test => :spec
+task :test    => :spec
 task :default => :spec
 
-require 'dm-visualizer/rake/graphviz_task'
-DataMapper::Visualizer::Rake::GraphVizTask.new(
-  :include => %w[lib],
-  :require => %w[
-    ronin/arch
-    ronin/address
-    ronin/author
-    ronin/campaign
-    ronin/credential
-    ronin/email_address
-    ronin/host_name_ip_address
-    ronin/host_name
-    ronin/ip_address_mac_address
-    ronin/ip_address
-    ronin/license
-    ronin/mac_address
-    ronin/open_port
-    ronin/organization
-    ronin/os_guess
-    ronin/os
-    ronin/script/path
-    ronin/repository
-    ronin/port
-    ronin/service
-    ronin/service_credential
-    ronin/web_credential
-    ronin/software
-    ronin/vendor
-    ronin/target
-    ronin/tcp_port
-    ronin/udp_port
-    ronin/url_scheme
-    ronin/url_query_param_name
-    ronin/url_query_param
-    ronin/url
-    ronin/user_name
-    ronin/password
-  ]
-)
-
 require 'yard'
 YARD::Rake::YardocTask.new
 
 desc "Generates all documentation"
-task :docs => [:yard, 'dm:doc:graphviz']
+task :docs => [:yard]
 
 require 'kramdown/man/task'
 Kramdown::Man::Task.new

data/bin/ronin

@@ -15,6 +15,5 @@ if File.file?(File.join(root,'Gemfile.lock'))
   end
 end
 
-require 'ronin/ui/cli'
-
-Ronin::UI::CLI.start
+require 'ronin/cli'
+Ronin::CLI.start

data/data/new/project/.gitignore

@@ -0,0 +1,15 @@
+/Gemfile.lock
+/vendor/bundle
+/.bundle
+.DS_Store
+*.db
+*.log
+*.swp
+*~
+*.sqlite3
+*.db
+*.gz
+*.bz2
+*.xz
+*.tar
+*.zip

data/data/new/project/.ruby-version.erb

@@ -0,0 +1 @@
+<%= @ruby_version -%>

data/data/new/project/Dockerfile.erb

@@ -0,0 +1,9 @@
+FROM ruby:<%= @ruby_version -%>
+
+RUN apt-get update -qq -y && gem update bundler
+
+WORKDIR /app
+COPY . /app
+RUN bundle install
+
+CMD ["/app/<%= @project_name -%>.rb"]

data/data/new/project/Gemfile.erb

@@ -0,0 +1,16 @@
+source 'https://rubygems.org'
+
+<%- if options[:rakefile] -%>
+gem 'rake'
+
+<%- end -%>
+gem 'ronin-support',         '~> 1.0' #, github: 'ronin-rb/ronin-support'
+
+# gem 'ronin-code-asm',        '~> 0.3' #, github: 'ronin-rb/ronin-code-asm'
+# gem 'ronin-code-sql',        '~> 1.2' #, github: 'ronin-rb/ronin-code-sql'
+# gem 'ronin-db',              '~> 0.1' #, github: 'ronin-rb/ronin-db'
+# gem 'ronin-web-server',      '~> 0.1' #, github: 'ronin-rb/ronin-web-server'
+# gem 'ronin-web-spider',      '~> 0.1' #, github: 'ronin-rb/ronin-web-spider'
+# gem 'ronin-web-user_agents', '~> 0.1' #, github: 'ronin-rb/ronin-web-user_agents'
+# gem 'ronin-payloads',        '~> 0.1' #, github: 'ronin-rb/ronin-payloads'
+# gem 'ronin-exploits',        '~> 1.0' #, github: 'ronin-rb/ronin-exploits'

data/data/new/project/Rakefile

@@ -0,0 +1,43 @@
+require 'rake'
+
+#
+# Example rake tasks:
+#
+#     task :foo do
+#       # code here
+#     end
+#
+# Namespaces:
+#
+#     namespace :foo do
+#       task :bar do
+#         # code here
+#       end
+#
+#       # other tasks ...
+#     end
+#
+# Task depenencies:
+#
+#     task :bar => :foo
+#     task :bar => 'foo:bar'
+#
+# Arguments:
+#
+#     task :foo, [:arg1, :arg2] do |t,args|
+#       puts "arg1=#{args[:arg1]}"
+#       puts "arg2=#{args[:arg2]}"
+#     end
+#
+# File tasks:
+#
+#     file 'foo.txt' do
+#       File.open('foo.txt','w') do |file|
+#         # code here
+#       end
+#     end
+#
+# Directory tasks:
+#
+#     directory 'dir'
+#

data/data/new/project/project.rb.erb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'bundler'
+rescue LoadError => e
+  warn e.message
+  warn "Run `gem install bundler` to install Bundler"
+  exit -1
+end
+
+require 'ronin/support'
+include Ronin::Support
+
+# code goes here