ronin 1.5.1 → 2.0.0.beta1

data/man/ronin-xor.1.md

@@ -0,0 +1,46 @@
+# ronin-xor 1 "May 2022" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin xor` [*options*] [*FILE* ...]
+
+## DESCRIPTION
+
+XORs each character of data with a key.
+
+## ARGUMENTS
+
+*FILE*
+  The optional file to read and process. If no *FILE* arguments are given,
+  input will be read from `stdin`.
+
+## OPTIONS
+
+`-f`, `--file` *FILE*
+  Optional file to process.
+
+`--string` *STRING*
+  Optional string to process.
+
+`-M`, `--multiline`
+  Process each line of input separately.
+
+`-n`, `--keep-newlines`
+  Preserves newlines at the end of each line.
+
+`-k`, `--key` *STRING*
+  The XOR key String.
+
+`-K`, `--key-file` *FILE*
+  The file to read the XOR key from.
+
+`-h`, `--help`
+  Print help information.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+ronin-encode(1), ronin-rot(1)

data/man/ronin.1

@@ -1,16 +1,16 @@
 .\" Generated by kramdown-man 0.1.8
 .\" https://github.com/postmodern/kramdown-man#readme
-.TH ronin 1 "April 2012" Ronin "User Manuals"
+.TH ronin 1 "May 2022" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
 .HP
-\fBronin\fR \[lB]\fICOMMAND\fP\[rB] \[lB]\fIoptions\fP\[rB]
+\fBronin\fR \[lB]\fIoptions\fP\[rB] \[lB]\fICOMMAND\fP \[lB]\.\.\.\[rB]\[rB]
 .LP
 .SH DESCRIPTION
 .LP
 .PP
-Runs a Ronin COMMAND or the starts Ronin Console\.
+Runs a Ronin \fICOMMAND\fP\.
 .LP
 .SH ARGUMENTS
 .LP
@@ -20,8 +20,27 @@ The Ronin command to execute\.
 .LP
 .SH OPTIONS
 .LP
-.PP
-Additional options for the COMMAND or the Ronin Console\.
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information
+.LP
+.SH COMMANDS
+.LP
+.TP
+\fIconsole\fP
+Starts ronin\[cq]s interactive ruby console\.
+.LP
+.TP
+\fIexec\fP
+Executes a script or binary from a ronin repo\.
+.LP
+.TP
+\fIhelp\fP
+Lists available commands or shows help about a specific command\.
+.LP
+.TP
+\fInet\-proxy\fP
+Starts a TCP\[sl]UDP intercept proxy\.
 .LP
 .SH AUTHOR
 .LP
@@ -33,4 +52,4 @@ Postmodern
 .SH SEE ALSO
 .LP
 .PP
-ronin\-console(1)
+ronin\-help(1)

data/man/ronin.1.md

@@ -1,12 +1,12 @@
-# ronin 1 "April 2012" Ronin "User Manuals"
+# ronin 1 "May 2022" Ronin "User Manuals"
 
 ## SYNOPSIS
 
-`ronin` [*COMMAND*] [*options*]
+`ronin` [*options*] [*COMMAND* [...]]
 
 ## DESCRIPTION
 
-Runs a Ronin COMMAND or the starts Ronin Console.
+Runs a Ronin *COMMAND*.
 
 ## ARGUMENTS
 
@@ -15,7 +15,22 @@ Runs a Ronin COMMAND or the starts Ronin Console.
 
 ## OPTIONS
 
-Additional options for the COMMAND or the Ronin Console.
+`-h`, `--help`
+  Print help information
+
+## COMMANDS
+
+*console*
+  Starts ronin's interactive ruby console.
+
+*exec*
+  Executes a script or binary from a ronin repo.
+
+*help*
+  Lists available commands or shows help about a specific command.
+
+*net-proxy*
+  Starts a TCP/UDP intercept proxy.
 
 ## AUTHOR
 
@@ -23,4 +38,4 @@ Postmodern <postmodern.mod3@gmail.com>
 
 ## SEE ALSO
 
-ronin-console(1)
+ronin-help(1)

data/ronin.gemspec

@@ -33,7 +33,7 @@ Gem::Specification.new do |gem|
   gem.default_executable = gem.executables.first if Gem::VERSION < '1.7.'
 
   gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
-  gem.test_files       = glob[gemspec['test_files'] || '{test/{**/}*_test.rb']
+  gem.test_files       = glob[gemspec['test_files'] || '{spec/{**/}*_spec.rb']
   gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
 
   gem.require_paths = Array(gemspec.fetch('require_paths') {

data/spec/cli/command_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+require 'ronin/cli/command'
+
+describe Ronin::CLI::Command do
+  it { expect(described_class).to be < Ronin::Core::CLI::Command }
+
+  it "must set .man_dir" do
+    expect(described_class.man_dir).to eq(File.join(Ronin::ROOT,'man'))
+  end
+end

data/spec/cli/commands/decode_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+require 'ronin/cli/commands/decode'
+
+describe Ronin::CLI::Commands::Decode do
+  describe "options" do
+    before { subject.parse_options(argv) }
+
+    describe "--base32" do
+      let(:argv) { %w[--base32] }
+
+      it "must require 'ronin/support/encoding/base32'" do
+        expect(require 'ronin/support/encoding/base32').to be(false)
+      end
+
+      it "must add :base32_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:base32_decode)
+      end
+    end
+
+    describe "--base64" do
+      let(:argv) { %w[--base64] }
+
+      it "must require 'ronin/support/encoding/base64'" do
+        expect(require 'ronin/support/encoding/base64').to be(false)
+      end
+
+      it "must add :base64_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:base64_decode)
+      end
+    end
+
+    describe "--c" do
+      let(:argv) { %w[--c] }
+
+      it "must require 'ronin/support/encoding/c'" do
+        expect(require 'ronin/support/encoding/c').to be(false)
+      end
+
+      it "must add :c_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:c_decode)
+      end
+    end
+
+    describe "--hex" do
+      let(:argv) { %w[--hex] }
+
+      it "must require 'ronin/support/encoding/hex'" do
+        expect(require 'ronin/support/encoding/hex').to be(false)
+      end
+
+      it "must add :hex_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:hex_decode)
+      end
+    end
+
+    describe "--html" do
+      let(:argv) { %w[--html] }
+
+      it "must require 'ronin/support/encoding/html'" do
+        expect(require 'ronin/support/encoding/html').to be(false)
+      end
+
+      it "must add :html_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:html_decode)
+      end
+    end
+
+    describe "--uri" do
+      let(:argv) { %w[--uri] }
+
+      it "must require 'ronin/support/encoding/uri'" do
+        expect(require 'ronin/support/encoding/uri').to be(false)
+      end
+
+      it "must add :uri_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:uri_decode)
+      end
+    end
+
+    describe "--http" do
+      let(:argv) { %w[--http] }
+
+      it "must require 'ronin/support/encoding/http'" do
+        expect(require 'ronin/support/encoding/http').to be(false)
+      end
+
+      it "must add :http_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:http_decode)
+      end
+    end
+
+    describe "--js" do
+      let(:argv) { %w[--js] }
+
+      it "must require 'ronin/support/encoding/js'" do
+        expect(require 'ronin/support/encoding/js').to be(false)
+      end
+
+      it "must add :js_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:js_decode)
+      end
+    end
+
+    describe "--shell" do
+      let(:argv) { %w[--shell] }
+
+      it "must require 'ronin/support/encoding/shell'" do
+        expect(require 'ronin/support/encoding/shell').to be(false)
+      end
+
+      it "must add :shell_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:shell_decode)
+      end
+    end
+
+    describe "--powershell" do
+      let(:argv) { %w[--powershell] }
+
+      it "must require 'ronin/support/encoding/powershell'" do
+        expect(require 'ronin/support/encoding/powershell').to be(false)
+      end
+
+      it "must add :powershell_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:powershell_decode)
+      end
+    end
+
+    describe "--ruby" do
+      let(:argv) { %w[--ruby] }
+
+      it "must require 'ronin/support/encoding/ruby'" do
+        expect(require 'ronin/support/encoding/ruby').to be(false)
+      end
+
+      it "must add :ruby_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:ruby_decode)
+      end
+    end
+
+    describe "--xml" do
+      let(:argv) { %w[--xml] }
+
+      it "must require 'ronin/support/encoding/xml'" do
+        expect(require 'ronin/support/encoding/xml').to be(false)
+      end
+
+      it "must add :xml_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:xml_decode)
+      end
+    end
+  end
+end

data/spec/cli/commands/encode_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+require 'ronin/cli/commands/encode'
+
+describe Ronin::CLI::Commands::Encode do
+  describe "options" do
+    before { subject.parse_options(argv) }
+
+    describe "--base32" do
+      let(:argv) { %w[--base32] }
+
+      it "must require 'ronin/support/encoding/base32'" do
+        expect(require 'ronin/support/encoding/base32').to be(false)
+      end
+
+      it "must add :base32_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:base32_encode)
+      end
+    end
+
+    describe "--base64" do
+      let(:argv) { %w[--base64] }
+
+      it "must require 'ronin/support/encoding/base64'" do
+        expect(require 'ronin/support/encoding/base64').to be(false)
+      end
+
+      it "must add :base64_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:base64_encode)
+      end
+    end
+
+    describe "--c" do
+      let(:argv) { %w[--c] }
+
+      it "must require 'ronin/support/encoding/c'" do
+        expect(require 'ronin/support/encoding/c').to be(false)
+      end
+
+      it "must add :c_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:c_encode)
+      end
+    end
+
+    describe "--hex" do
+      let(:argv) { %w[--hex] }
+
+      it "must require 'ronin/support/encoding/hex'" do
+        expect(require 'ronin/support/encoding/hex').to be(false)
+      end
+
+      it "must add :hex_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:hex_encode)
+      end
+    end
+
+    describe "--html" do
+      let(:argv) { %w[--html] }
+
+      it "must require 'ronin/support/encoding/html'" do
+        expect(require 'ronin/support/encoding/html').to be(false)
+      end
+
+      it "must add :html_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:html_encode)
+      end
+    end
+
+    describe "--uri" do
+      let(:argv) { %w[--uri] }
+
+      it "must require 'ronin/support/encoding/uri'" do
+        expect(require 'ronin/support/encoding/uri').to be(false)
+      end
+
+      it "must add :uri_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:uri_encode)
+      end
+    end
+
+    describe "--http" do
+      let(:argv) { %w[--http] }
+
+      it "must require 'ronin/support/encoding/http'" do
+        expect(require 'ronin/support/encoding/http').to be(false)
+      end
+
+      it "must add :http_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:http_encode)
+      end
+    end
+
+    describe "--js" do
+      let(:argv) { %w[--js] }
+
+      it "must require 'ronin/support/encoding/js'" do
+        expect(require 'ronin/support/encoding/js').to be(false)
+      end
+
+      it "must add :js_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:js_encode)
+      end
+    end
+
+    describe "--shell" do
+      let(:argv) { %w[--shell] }
+
+      it "must require 'ronin/support/encoding/shell'" do
+        expect(require 'ronin/support/encoding/shell').to be(false)
+      end
+
+      it "must add :shell_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:shell_encode)
+      end
+    end
+
+    describe "--powershell" do
+      let(:argv) { %w[--powershell] }
+
+      it "must require 'ronin/support/encoding/powershell'" do
+        expect(require 'ronin/support/encoding/powershell').to be(false)
+      end
+
+      it "must add :powershell_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:powershell_encode)
+      end
+    end
+
+    describe "--ruby" do
+      let(:argv) { %w[--ruby] }
+
+      it "must require 'ronin/support/encoding/ruby'" do
+        expect(require 'ronin/support/encoding/ruby').to be(false)
+      end
+
+      it "must add :ruby_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:ruby_encode)
+      end
+    end
+
+    describe "--xml" do
+      let(:argv) { %w[--xml] }
+
+      it "must require 'ronin/support/encoding/xml'" do
+        expect(require 'ronin/support/encoding/xml').to be(false)
+      end
+
+      it "must add :xml_encode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:xml_encode)
+      end
+    end
+  end
+end

data/spec/cli/commands/escape_spec.rb

@@ -0,0 +1,128 @@
+require 'spec_helper'
+require 'ronin/cli/commands/escape'
+
+describe Ronin::CLI::Commands::Escape do
+  describe "options" do
+    before { subject.parse_options(argv) }
+
+    describe "--c" do
+      let(:argv) { %w[--c] }
+
+      it "must require 'ronin/support/encoding/c'" do
+        expect(require 'ronin/support/encoding/c').to be(false)
+      end
+
+      it "must add :c_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:c_escape)
+      end
+    end
+
+    describe "--hex" do
+      let(:argv) { %w[--hex] }
+
+      it "must require 'ronin/support/encoding/hex'" do
+        expect(require 'ronin/support/encoding/hex').to be(false)
+      end
+
+      it "must add :hex_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:hex_escape)
+      end
+    end
+
+    describe "--html" do
+      let(:argv) { %w[--html] }
+
+      it "must require 'ronin/support/encoding/html'" do
+        expect(require 'ronin/support/encoding/html').to be(false)
+      end
+
+      it "must add :html_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:html_escape)
+      end
+    end
+
+    describe "--uri" do
+      let(:argv) { %w[--uri] }
+
+      it "must require 'ronin/support/encoding/uri'" do
+        expect(require 'ronin/support/encoding/uri').to be(false)
+      end
+
+      it "must add :uri_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:uri_escape)
+      end
+    end
+
+    describe "--http" do
+      let(:argv) { %w[--http] }
+
+      it "must require 'ronin/support/encoding/http'" do
+        expect(require 'ronin/support/encoding/http').to be(false)
+      end
+
+      it "must add :http_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:http_escape)
+      end
+    end
+
+    describe "--js" do
+      let(:argv) { %w[--js] }
+
+      it "must require 'ronin/support/encoding/js'" do
+        expect(require 'ronin/support/encoding/js').to be(false)
+      end
+
+      it "must add :js_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:js_escape)
+      end
+    end
+
+    describe "--shell" do
+      let(:argv) { %w[--shell] }
+
+      it "must require 'ronin/support/encoding/shell'" do
+        expect(require 'ronin/support/encoding/shell').to be(false)
+      end
+
+      it "must add :shell_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:shell_escape)
+      end
+    end
+
+    describe "--powershell" do
+      let(:argv) { %w[--powershell] }
+
+      it "must require 'ronin/support/encoding/powershell'" do
+        expect(require 'ronin/support/encoding/powershell').to be(false)
+      end
+
+      it "must add :powershell_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:powershell_escape)
+      end
+    end
+
+    describe "--xml" do
+      let(:argv) { %w[--xml] }
+
+      it "must require 'ronin/support/encoding/xml'" do
+        expect(require 'ronin/support/encoding/xml').to be(false)
+      end
+
+      it "must add :xml_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:xml_escape)
+      end
+    end
+
+    describe "--ruby" do
+      let(:argv) { %w[--ruby] }
+
+      it "must require 'ronin/support/encoding/ruby'" do
+        expect(require 'ronin/support/encoding/ruby').to be(false)
+      end
+
+      it "must add :ruby_escape to #method_calls" do
+        expect(subject.method_calls.last).to eq(:ruby_escape)
+      end
+    end
+  end
+end

data/spec/cli/commands/quote_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+require 'ronin/cli/commands/quote'
+
+describe Ronin::CLI::Commands::Quote do
+  describe "options" do
+    before { subject.parse_options(argv) }
+
+    describe "--c" do
+      let(:argv) { %w[--c] }
+
+      it "must require 'ronin/support/encoding/c'" do
+        expect(require 'ronin/support/encoding/c').to be(false)
+      end
+
+      it "must add :c_string to #method_calls" do
+        expect(subject.method_calls.last).to eq(:c_string)
+      end
+    end
+
+    describe "--hex" do
+      let(:argv) { %w[--hex] }
+
+      it "must require 'ronin/support/encoding/hex'" do
+        expect(require 'ronin/support/encoding/hex').to be(false)
+      end
+
+      it "must add :hex_string to #method_calls" do
+        expect(subject.method_calls.last).to eq(:hex_string)
+      end
+    end
+
+    describe "--js" do
+      let(:argv) { %w[--js] }
+
+      it "must require 'ronin/support/encoding/js'" do
+        expect(require 'ronin/support/encoding/js').to be(false)
+      end
+
+      it "must add :js_string to #method_calls" do
+        expect(subject.method_calls.last).to eq(:js_string)
+      end
+    end
+
+    describe "--shell" do
+      let(:argv) { %w[--shell] }
+
+      it "must require 'ronin/support/encoding/shell'" do
+        expect(require 'ronin/support/encoding/shell').to be(false)
+      end
+
+      it "must add :shell_string to #method_calls" do
+        expect(subject.method_calls.last).to eq(:shell_string)
+      end
+    end
+
+    describe "--powershell" do
+      let(:argv) { %w[--powershell] }
+
+      it "must require 'ronin/support/encoding/powershell'" do
+        expect(require 'ronin/support/encoding/powershell').to be(false)
+      end
+
+      it "must add :powershell_string to #method_calls" do
+        expect(subject.method_calls.last).to eq(:powershell_string)
+      end
+    end
+
+    describe "--ruby" do
+      let(:argv) { %w[--ruby] }
+
+      it "must add :ruby_string to #method_calls" do
+        expect(subject.method_calls.last).to eq(:ruby_string)
+      end
+    end
+  end
+end