ronin-web 0.3.0.pre2 → 1.0.0.beta1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.editorconfig +11 -0
- data/.github/workflows/ruby.yml +31 -0
- data/.gitignore +13 -0
- data/.mailmap +1 -0
- data/.ruby-version +1 -0
- data/COPYING.txt +3 -3
- data/ChangeLog.md +115 -67
- data/Gemfile +42 -37
- data/README.md +159 -144
- data/Rakefile +16 -7
- data/bin/ronin-web +10 -18
- data/data/new/nokogiri.rb.erb +12 -0
- data/data/new/server.rb.erb +22 -0
- data/data/new/spider.rb.erb +26 -0
- data/data/new/webapp/.gitignore +15 -0
- data/data/new/webapp/.ruby-version.erb +1 -0
- data/data/new/webapp/Dockerfile.erb +11 -0
- data/data/new/webapp/Gemfile +6 -0
- data/data/new/webapp/app.rb.erb +15 -0
- data/data/new/webapp/config.ru +4 -0
- data/data/new/webapp/docker-compose.yml.erb +9 -0
- data/gemspec.yml +32 -17
- data/lib/ronin/web/cli/command.rb +36 -0
- data/lib/ronin/web/cli/commands/diff.rb +106 -0
- data/lib/ronin/web/cli/commands/html.rb +174 -0
- data/lib/ronin/web/cli/commands/irb.rb +56 -0
- data/lib/ronin/web/cli/commands/new/nokogiri.rb +85 -0
- data/lib/ronin/web/cli/commands/new/server.rb +96 -0
- data/lib/ronin/web/cli/commands/new/spider.rb +315 -0
- data/lib/ronin/web/cli/commands/new/webapp.rb +123 -0
- data/lib/ronin/web/cli/commands/new.rb +64 -0
- data/lib/ronin/web/cli/commands/reverse_proxy.rb +215 -0
- data/lib/ronin/web/cli/commands/server.rb +155 -0
- data/lib/ronin/web/cli/commands/spider.rb +822 -0
- data/lib/ronin/web/cli/ruby_shell.rb +50 -0
- data/lib/ronin/web/cli.rb +44 -0
- data/lib/ronin/web/html.rb +85 -0
- data/lib/ronin/web/mechanize.rb +79 -0
- data/lib/ronin/web/root.rb +27 -0
- data/lib/ronin/web/version.rb +7 -10
- data/lib/ronin/web/xml.rb +85 -0
- data/lib/ronin/web.rb +372 -13
- data/man/ronin-web-diff.1 +41 -0
- data/man/ronin-web-diff.1.md +30 -0
- data/man/ronin-web-html.1 +89 -0
- data/man/ronin-web-html.1.md +66 -0
- data/man/ronin-web-irb.1 +31 -0
- data/man/ronin-web-irb.1.md +22 -0
- data/man/ronin-web-new-nokogiri.1 +41 -0
- data/man/ronin-web-new-nokogiri.1.md +30 -0
- data/man/ronin-web-new-server.1 +45 -0
- data/man/ronin-web-new-server.1.md +33 -0
- data/man/ronin-web-new-spider.1 +173 -0
- data/man/ronin-web-new-spider.1.md +129 -0
- data/man/ronin-web-new-webapp.1 +53 -0
- data/man/ronin-web-new-webapp.1.md +39 -0
- data/man/ronin-web-new.1 +59 -0
- data/man/ronin-web-new.1.md +44 -0
- data/man/ronin-web-reverse-proxy.1 +63 -0
- data/man/ronin-web-reverse-proxy.1.md +47 -0
- data/man/ronin-web-server.1 +59 -0
- data/man/ronin-web-server.1.md +43 -0
- data/man/ronin-web-spider.1 +225 -0
- data/man/ronin-web-spider.1.md +168 -0
- data/man/ronin-web.1 +41 -0
- data/man/ronin-web.1.md +30 -0
- data/ronin-web.gemspec +57 -11
- data/spec/cli/ruby_shell_spec.rb +14 -0
- data/spec/html_spec.rb +43 -0
- data/spec/mechanize_spec.rb +72 -0
- data/spec/spec_helper.rb +5 -3
- data/spec/web_spec.rb +97 -0
- data/spec/xml_spec.rb +42 -0
- metadata +237 -217
- data/.gemtest +0 -0
- data/lib/ronin/network/mixins/web.rb +0 -256
- data/lib/ronin/web/extensions/nokogiri/xml/attr.rb +0 -47
- data/lib/ronin/web/extensions/nokogiri/xml/document.rb +0 -48
- data/lib/ronin/web/extensions/nokogiri/xml/element.rb +0 -57
- data/lib/ronin/web/extensions/nokogiri/xml/node.rb +0 -86
- data/lib/ronin/web/extensions/nokogiri/xml/text.rb +0 -47
- data/lib/ronin/web/extensions/nokogiri/xml.rb +0 -27
- data/lib/ronin/web/extensions/nokogiri.rb +0 -23
- data/lib/ronin/web/extensions.rb +0 -23
- data/lib/ronin/web/middleware/base.rb +0 -144
- data/lib/ronin/web/middleware/directories.rb +0 -179
- data/lib/ronin/web/middleware/files.rb +0 -144
- data/lib/ronin/web/middleware/filters/campaign_filter.rb +0 -77
- data/lib/ronin/web/middleware/filters/ip_filter.rb +0 -73
- data/lib/ronin/web/middleware/filters/path_filter.rb +0 -73
- data/lib/ronin/web/middleware/filters/referer_filter.rb +0 -71
- data/lib/ronin/web/middleware/filters/user_agent_filter.rb +0 -71
- data/lib/ronin/web/middleware/filters/vhost_filter.rb +0 -71
- data/lib/ronin/web/middleware/filters.rb +0 -28
- data/lib/ronin/web/middleware/helpers.rb +0 -145
- data/lib/ronin/web/middleware/proxy.rb +0 -265
- data/lib/ronin/web/middleware/proxy_request.rb +0 -262
- data/lib/ronin/web/middleware/request.rb +0 -79
- data/lib/ronin/web/middleware/response.rb +0 -33
- data/lib/ronin/web/middleware/router.rb +0 -167
- data/lib/ronin/web/middleware/rule.rb +0 -103
- data/lib/ronin/web/middleware.rb +0 -27
- data/lib/ronin/web/proxy/app.rb +0 -32
- data/lib/ronin/web/proxy/base.rb +0 -46
- data/lib/ronin/web/proxy/web.rb +0 -46
- data/lib/ronin/web/proxy.rb +0 -25
- data/lib/ronin/web/server/app.rb +0 -32
- data/lib/ronin/web/server/base.rb +0 -461
- data/lib/ronin/web/server/web.rb +0 -66
- data/lib/ronin/web/server.rb +0 -25
- data/lib/ronin/web/spider.rb +0 -115
- data/lib/ronin/web/web.rb +0 -573
- data/spec/helpers/output.rb +0 -3
- data/spec/web/extensions/nokogiri_spec.rb +0 -38
- data/spec/web/helpers/rack_app.rb +0 -31
- data/spec/web/helpers/root/test1/index.html +0 -1
- data/spec/web/helpers/root/test1/test1.txt +0 -1
- data/spec/web/helpers/root/test1.txt +0 -1
- data/spec/web/helpers/root/test2/test2.txt +0 -1
- data/spec/web/helpers/root/test2.txt +0 -1
- data/spec/web/helpers/root/test3/test3.txt +0 -1
- data/spec/web/helpers/root/test3.txt +0 -1
- data/spec/web/helpers/root.rb +0 -15
- data/spec/web/middleware/directories_spec.rb +0 -86
- data/spec/web/middleware/files_spec.rb +0 -57
- data/spec/web/middleware/filters/campaign_filter_spec.rb +0 -30
- data/spec/web/middleware/filters/ip_filter_spec.rb +0 -25
- data/spec/web/middleware/filters/path_filter_spec.rb +0 -29
- data/spec/web/middleware/filters/referer_filter_spec.rb +0 -25
- data/spec/web/middleware/filters/user_agent_filter_spec.rb +0 -25
- data/spec/web/middleware/filters/vhost_filter_spec.rb +0 -23
- data/spec/web/middleware/proxy_spec.rb +0 -67
- data/spec/web/middleware/response_spec.rb +0 -20
- data/spec/web/middleware/router_spec.rb +0 -65
- data/spec/web/middleware/rule_spec.rb +0 -37
- data/spec/web/proxy/base_spec.rb +0 -8
- data/spec/web/server/base_spec.rb +0 -77
- data/spec/web/server/classes/public1/static1.txt +0 -1
- data/spec/web/server/classes/public2/static2.txt +0 -1
- data/spec/web/server/classes/sub_app.rb +0 -13
- data/spec/web/server/classes/test_app.rb +0 -20
- data/spec/web/web_spec.rb +0 -157
data/spec/html_spec.rb
ADDED
@@ -0,0 +1,43 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
require 'ronin/web/html'
|
3
|
+
|
4
|
+
describe Ronin::Web::HTML do
|
5
|
+
describe ".parse" do
|
6
|
+
let(:html) do
|
7
|
+
<<~HTML
|
8
|
+
<html>
|
9
|
+
<body>Hello</body>
|
10
|
+
</html>
|
11
|
+
HTML
|
12
|
+
end
|
13
|
+
|
14
|
+
it "must parse an HTML String and return a Nokogiri::HTML::Document" do
|
15
|
+
doc = subject.parse(html)
|
16
|
+
|
17
|
+
expect(doc).to be_kind_of(Nokogiri::HTML::Document)
|
18
|
+
expect(doc.at('body').inner_text).to eq("Hello")
|
19
|
+
end
|
20
|
+
|
21
|
+
context "when given a block" do
|
22
|
+
it "must yield the Nokogiri::HTML::Document object" do
|
23
|
+
expect { |b|
|
24
|
+
subject.parse(html,&b)
|
25
|
+
}.to yield_with_args(Nokogiri::HTML::Document)
|
26
|
+
end
|
27
|
+
end
|
28
|
+
end
|
29
|
+
|
30
|
+
describe ".build" do
|
31
|
+
it "must build an HTML document" do
|
32
|
+
doc = subject.build do
|
33
|
+
html {
|
34
|
+
body {
|
35
|
+
div { text("hello") }
|
36
|
+
}
|
37
|
+
}
|
38
|
+
end
|
39
|
+
|
40
|
+
expect(doc.to_html).to include("<html><body><div>hello</div></body></html>")
|
41
|
+
end
|
42
|
+
end
|
43
|
+
end
|
@@ -0,0 +1,72 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
require 'ronin/web/mechanize'
|
3
|
+
|
4
|
+
describe Ronin::Web::Mechanize do
|
5
|
+
describe "#initialize" do
|
6
|
+
context "when Ronin::Support::Network::HTTP.user_agent is set" do
|
7
|
+
let(:user_agent) { 'test' }
|
8
|
+
|
9
|
+
before { Ronin::Support::Network::HTTP.user_agent = user_agent }
|
10
|
+
|
11
|
+
it "should set #user_agent to Ronin::Support::Network::HTTP.user_agent" do
|
12
|
+
expect(subject.user_agent).to eq(user_agent)
|
13
|
+
end
|
14
|
+
|
15
|
+
after { Ronin::Support::Network::HTTP.user_agent = nil }
|
16
|
+
end
|
17
|
+
|
18
|
+
context "when the :user_agent option is given" do
|
19
|
+
context "and it's a String" do
|
20
|
+
let(:user_agent) { 'test2' }
|
21
|
+
|
22
|
+
subject { described_class.new(user_agent: user_agent) }
|
23
|
+
|
24
|
+
it "should set #user_agent to the custom User-Agent string" do
|
25
|
+
expect(subject.user_agent).to eq(user_agent)
|
26
|
+
end
|
27
|
+
end
|
28
|
+
|
29
|
+
context "and it's a Symbol" do
|
30
|
+
let(:user_agent) { :chrome_linux }
|
31
|
+
let(:expected_user_agent) do
|
32
|
+
Ronin::Support::Network::HTTP::UserAgents[user_agent]
|
33
|
+
end
|
34
|
+
|
35
|
+
subject { described_class.new(user_agent: user_agent) }
|
36
|
+
|
37
|
+
it "should set #user_agent to the custom User-Agent alias" do
|
38
|
+
expect(subject.user_agent).to eq(expected_user_agent)
|
39
|
+
end
|
40
|
+
end
|
41
|
+
end
|
42
|
+
|
43
|
+
let(:host) { '127.0.0.1' }
|
44
|
+
let(:port) { 8080 }
|
45
|
+
let(:proxy) { URI::HTTP.build(host: host, port: port) }
|
46
|
+
|
47
|
+
context "when Ronin::Support::Network::HTTP.proxy is set" do
|
48
|
+
before { Ronin::Support::Network::HTTP.proxy = proxy }
|
49
|
+
|
50
|
+
it "should set #proxy_addr and #proxy_port to Ronin::Support::Network::HTTP.proxy" do
|
51
|
+
expect(subject.proxy_addr).to eq(
|
52
|
+
Ronin::Support::Network::HTTP.proxy.host
|
53
|
+
)
|
54
|
+
|
55
|
+
expect(subject.proxy_port).to eq(
|
56
|
+
Ronin::Support::Network::HTTP.proxy.port
|
57
|
+
)
|
58
|
+
end
|
59
|
+
|
60
|
+
after { Ronin::Support::Network::HTTP.proxy = nil }
|
61
|
+
end
|
62
|
+
|
63
|
+
context "when the :proxy option is given" do
|
64
|
+
subject { described_class.new(proxy: proxy) }
|
65
|
+
|
66
|
+
it "should set #proxy_addr and #proxy_port to the custom proxy" do
|
67
|
+
expect(subject.proxy_addr).to eq(host)
|
68
|
+
expect(subject.proxy_port).to eq(port)
|
69
|
+
end
|
70
|
+
end
|
71
|
+
end
|
72
|
+
end
|
data/spec/spec_helper.rb
CHANGED
data/spec/web_spec.rb
ADDED
@@ -0,0 +1,97 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
require 'ronin/web'
|
3
|
+
|
4
|
+
describe Ronin::Web do
|
5
|
+
let(:url) { 'https://ronin-rb.dev/' }
|
6
|
+
let(:title) { 'Ronin' }
|
7
|
+
|
8
|
+
it "should have a VERSION constant" do
|
9
|
+
expect(subject.const_defined?('VERSION')).to eq(true)
|
10
|
+
end
|
11
|
+
|
12
|
+
describe ".html" do
|
13
|
+
it "should be able to parse HTML" do
|
14
|
+
doc = subject.html(%{
|
15
|
+
<html>
|
16
|
+
<body>Hello</body>
|
17
|
+
</html>
|
18
|
+
})
|
19
|
+
|
20
|
+
expect(doc.at('body').inner_text).to eq("Hello")
|
21
|
+
end
|
22
|
+
end
|
23
|
+
|
24
|
+
describe ".build_html" do
|
25
|
+
it "should be able to build HTML documents" do
|
26
|
+
doc = subject.build_html do
|
27
|
+
html {
|
28
|
+
body {
|
29
|
+
div { text("hello") }
|
30
|
+
}
|
31
|
+
}
|
32
|
+
end
|
33
|
+
|
34
|
+
expect(doc.to_html).to include("<html><body><div>hello</div></body></html>")
|
35
|
+
end
|
36
|
+
end
|
37
|
+
|
38
|
+
describe ".xml" do
|
39
|
+
it "should be able to parse XML" do
|
40
|
+
doc = subject.xml(%{
|
41
|
+
<?xml version="1.0"?>
|
42
|
+
<root>
|
43
|
+
<stuff>Hello</stuff>
|
44
|
+
</root>
|
45
|
+
})
|
46
|
+
|
47
|
+
expect(doc.at('stuff').inner_text).to eq("Hello")
|
48
|
+
end
|
49
|
+
end
|
50
|
+
|
51
|
+
describe ".build_xml" do
|
52
|
+
it "should be able to build XML documents" do
|
53
|
+
doc = subject.build_xml do
|
54
|
+
root {
|
55
|
+
stuff(name: 'bla') { text("hello") }
|
56
|
+
}
|
57
|
+
end
|
58
|
+
|
59
|
+
expect(doc.to_xml).to include("<root>\n <stuff name=\"bla\">hello</stuff>\n</root>")
|
60
|
+
end
|
61
|
+
end
|
62
|
+
|
63
|
+
describe ".open", :network do
|
64
|
+
it "should open URLs as temporary files" do
|
65
|
+
file = subject.open(url)
|
66
|
+
|
67
|
+
expect(file.read).to include(title)
|
68
|
+
end
|
69
|
+
end
|
70
|
+
|
71
|
+
describe ".agent" do
|
72
|
+
it "must return a #{described_class}::Mechanize object" do
|
73
|
+
expect(subject.agent).to be_kind_of(described_class::Mechanize)
|
74
|
+
end
|
75
|
+
|
76
|
+
it "must return the same object each time" do
|
77
|
+
expect(subject.agent).to be(subject.agent)
|
78
|
+
end
|
79
|
+
end
|
80
|
+
|
81
|
+
describe ".get", :network do
|
82
|
+
it "should be able to get Mechanize pages" do
|
83
|
+
page = subject.get(url)
|
84
|
+
|
85
|
+
expect(page.class).to eq(Mechanize::Page)
|
86
|
+
expect(page.at('title').inner_text).to include(title)
|
87
|
+
end
|
88
|
+
end
|
89
|
+
|
90
|
+
describe ".get_body", :network do
|
91
|
+
it "should be able to get the bodies of Mechanize pages" do
|
92
|
+
body = subject.get_body(url)
|
93
|
+
|
94
|
+
expect(body).to include(title)
|
95
|
+
end
|
96
|
+
end
|
97
|
+
end
|
data/spec/xml_spec.rb
ADDED
@@ -0,0 +1,42 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
require 'ronin/web/xml'
|
3
|
+
|
4
|
+
describe Ronin::Web::XML do
|
5
|
+
describe ".parse" do
|
6
|
+
let(:xml) do
|
7
|
+
<<~XML
|
8
|
+
<?xml version="1.0"?>
|
9
|
+
<root>
|
10
|
+
<stuff>Hello</stuff>
|
11
|
+
</root>
|
12
|
+
XML
|
13
|
+
end
|
14
|
+
|
15
|
+
it "must parse an XML String and return a Nokogiri::XML::Document" do
|
16
|
+
doc = subject.parse(xml)
|
17
|
+
|
18
|
+
expect(doc).to be_kind_of(Nokogiri::XML::Document)
|
19
|
+
expect(doc.at('stuff').inner_text).to eq("Hello")
|
20
|
+
end
|
21
|
+
|
22
|
+
context "when given a block" do
|
23
|
+
it "must yield the Nokogiri::XML::Document object" do
|
24
|
+
expect { |b|
|
25
|
+
subject.parse(xml,&b)
|
26
|
+
}.to yield_with_args(Nokogiri::XML::Document)
|
27
|
+
end
|
28
|
+
end
|
29
|
+
end
|
30
|
+
|
31
|
+
describe ".build" do
|
32
|
+
it "must build an XML document" do
|
33
|
+
doc = subject.build do
|
34
|
+
root {
|
35
|
+
stuff(name: 'bla') { text("hello") }
|
36
|
+
}
|
37
|
+
end
|
38
|
+
|
39
|
+
expect(doc.to_xml).to include("<root>\n <stuff name=\"bla\">hello</stuff>\n</root>")
|
40
|
+
end
|
41
|
+
end
|
42
|
+
end
|