ronin-support 1.0.0.beta3 → 1.0.1

data/lib/ronin/support/network/host.rb

@@ -29,7 +29,7 @@ module Ronin
       # Represents a host or host name.
       #
       # ## Examples
-      # 
+      #
       #     host = Host.new('www.example.com')
       #
       # Resolve parent domain:
@@ -69,36 +69,36 @@ module Ronin
       #     # => [#<Resolv::DNS::Resource::IN::MX:0x00007f7e50035658 @exchange=#<Resolv::DNS::Name: aspmx.l.google.com.>, @preference=1, @ttl=3600>, ...]
       #     host.get_mailservers
       #     # => ["alt1.aspmx.l.google.com",
-      #           "alt4.aspmx.l.google.com",
-      #           "alt3.aspmx.l.google.com",
-      #           "alt2.aspmx.l.google.com",
-      #           "aspmx.l.google.com"]
+      #     #     "alt4.aspmx.l.google.com",
+      #     #     "alt3.aspmx.l.google.com",
+      #     #     "alt2.aspmx.l.google.com",
+      #     #     "aspmx.l.google.com"]
       #     host.mailservers
       #     # => ["alt1.aspmx.l.google.com",
-      #           "alt4.aspmx.l.google.com",
-      #           "alt3.aspmx.l.google.com",
-      #           "alt2.aspmx.l.google.com",
-      #           "aspmx.l.google.com"]
+      #     #     "alt4.aspmx.l.google.com",
+      #     #     "alt3.aspmx.l.google.com",
+      #     #     "alt2.aspmx.l.google.com",
+      #     #     "aspmx.l.google.com"]
       #     host.get_ns_records
       #     # => [#<Resolv::DNS::Resource::IN::NS:0x00007f7e4f972258 @name=#<Resolv::DNS::Name: dns1.p08.nsone.net.>, @ttl=900>, ...]
       #     host.get_nameservers
       #     # => ["dns3.p08.nsone.net",
-      #           "ns-1707.awsdns-21.co.uk",
-      #           "dns2.p08.nsone.net",
-      #           "ns-1283.awsdns-32.org",
-      #           "dns4.p08.nsone.net",
-      #           "ns-421.awsdns-52.com",
-      #           "dns1.p08.nsone.net",
-      #           "ns-520.awsdns-01.net"]
+      #     #     "ns-1707.awsdns-21.co.uk",
+      #     #     "dns2.p08.nsone.net",
+      #     #     "ns-1283.awsdns-32.org",
+      #     #     "dns4.p08.nsone.net",
+      #     #     "ns-421.awsdns-52.com",
+      #     #     "dns1.p08.nsone.net",
+      #     #     "ns-520.awsdns-01.net"]
       #     host.nameservers
       #     # => ["dns3.p08.nsone.net",
-      #           "ns-1707.awsdns-21.co.uk",
-      #           "dns2.p08.nsone.net",
-      #           "ns-1283.awsdns-32.org",
-      #           "dns4.p08.nsone.net",
-      #           "ns-421.awsdns-52.com",
-      #           "dns1.p08.nsone.net",
-      #           "ns-520.awsdns-01.net"]
+      #     #     "ns-1707.awsdns-21.co.uk",
+      #     #     "dns2.p08.nsone.net",
+      #     #     "ns-1283.awsdns-32.org",
+      #     #     "dns4.p08.nsone.net",
+      #     #     "ns-421.awsdns-52.com",
+      #     #     "dns1.p08.nsone.net",
+      #     #     "ns-520.awsdns-01.net"]
       #     host.get_soa_record
       #     # => #<Resolv::DNS::Resource::IN::SOA:0x00007f7e4f63d0b0 @mname=#<Resolv::DNS::Name: ns-1707.awsdns-21.co.uk.>, @rname=#<Resolv::DNS::Name: awsdns-hostmaster.amazon.com.>, @serial=1, @refresh=7200, @retry=900, @expire=1209600, @minimum=86400, @ttl=880>
       #     host.soa_record
@@ -111,28 +111,28 @@ module Ronin
       #     # => [#<Resolv::DNS::Resource::IN::TXT:0x00007f7e4f67c648 @strings=[\"apple-domain-verification=RyQhdzTl6Z6x8ZP4\"], @ttl=2852>, ...]
       #     host.get_txt_strings
       #     # => ["apple-domain-verification=RyQhdzTl6Z6x8ZP4",
-      #           "MS=ms58704441",
-      #           "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
-      #           "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
-      #           "v=spf1 ip4:192.30.252.0/22 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:spf.protection.outlook.com include:mail.zendesk.com include:_spf.salesforce.com include:servers.mcsv.net ip4:166.78.69.169 ip4:1",
-      #           "66.78.69.170 ip4:166.78.71.131 ip4:167.89.101.2 ip4:167.89.101.192/28 ip4:192.254.112.60 ip4:192.254.112.98/31 ip4:192.254.113.10 ip4:192.254.113.101 ip4:192.254.114.176 ip4:62.253.227.114 ~all",
-      #           "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
-      #           "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
-      #           "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
-      #           "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
-      #           "MS=ms44452932"]
+      #     #     "MS=ms58704441",
+      #     #     "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
+      #     #     "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
+      #     #     "v=spf1 ip4:192.30.252.0/22 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:spf.protection.outlook.com include:mail.zendesk.com include:_spf.salesforce.com include:servers.mcsv.net ip4:166.78.69.169 ip4:1",
+      #     #     "66.78.69.170 ip4:166.78.71.131 ip4:167.89.101.2 ip4:167.89.101.192/28 ip4:192.254.112.60 ip4:192.254.112.98/31 ip4:192.254.113.10 ip4:192.254.113.101 ip4:192.254.114.176 ip4:62.253.227.114 ~all",
+      #     #     "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
+      #     #     "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
+      #     #     "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
+      #     #     "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
+      #     #     "MS=ms44452932"]
       #     host.txt_strings
       #     # => ["apple-domain-verification=RyQhdzTl6Z6x8ZP4",
-      #           "MS=ms58704441",
-      #           "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
-      #           "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
-      #           "v=spf1 ip4:192.30.252.0/22 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:spf.protection.outlook.com include:mail.zendesk.com include:_spf.salesforce.com include:servers.mcsv.net ip4:166.78.69.169 ip4:1",
-      #           "66.78.69.170 ip4:166.78.71.131 ip4:167.89.101.2 ip4:167.89.101.192/28 ip4:192.254.112.60 ip4:192.254.112.98/31 ip4:192.254.113.10 ip4:192.254.113.101 ip4:192.254.114.176 ip4:62.253.227.114 ~all",
-      #           "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
-      #           "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
-      #           "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
-      #           "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
-      #           "MS=ms44452932"]
+      #     #     "MS=ms58704441",
+      #     #     "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
+      #     #     "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
+      #     #     "v=spf1 ip4:192.30.252.0/22 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com include:spf.protection.outlook.com include:mail.zendesk.com include:_spf.salesforce.com include:servers.mcsv.net ip4:166.78.69.169 ip4:1",
+      #     #     "66.78.69.170 ip4:166.78.71.131 ip4:167.89.101.2 ip4:167.89.101.192/28 ip4:192.254.112.60 ip4:192.254.112.98/31 ip4:192.254.113.10 ip4:192.254.113.101 ip4:192.254.114.176 ip4:62.253.227.114 ~all",
+      #     #     "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
+      #     #     "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
+      #     #     "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
+      #     #     "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
+      #     #     "MS=ms44452932"]
       #
       # @api public
       #
@@ -165,6 +165,11 @@ module Ronin
         #
         # @return [Boolean]
         #
+        # @example
+        #   host = Network::Host.new("www.詹姆斯.com')
+        #   host.idn?
+        #   # => true
+        #
         def idn?
           @name !~ /\A[A-Za-z0-9._-]+\z/
         end
@@ -178,6 +183,11 @@ module Ronin
         #
         # @return [Boolean]
         #
+        # @example
+        #   host = Network::Host.new("www.xn--8ws00zhy3a.com")
+        #   host.punycode?
+        #   # => true
+        #
         def punycode?
           @name.include?('xn--')
         end
@@ -190,6 +200,11 @@ module Ronin
         # @return [Host]
         #   The new host containing the punycode version of the hostname.
         #
+        # @example
+        #   host = Network::Host.new("www.詹姆斯.com")
+        #   host.punycode
+        #   # => #<Ronin::Support::Network::Host: www.xn--8ws00zhy3a.com>
+        #
         def punycode
           self.class.new(DNS::IDN.to_ascii(@name))
         end
@@ -252,7 +267,7 @@ module Ronin
             domain, suffix = PublicSuffix.list.split(@name)
 
             if (last_dot = domain.rindex('.'))
-              domain = domain[(last_dot+1)..]
+              domain = domain[(last_dot + 1)..]
             end
 
             Domain.new("#{domain}.#{suffix}")
@@ -268,6 +283,11 @@ module Ronin
         # @return [Host]
         #   The new sub-domain.
         #
+        # @example
+        #   host = Network::Host.new('example.com')
+        #   host.subdomain('www')
+        #   # => #<Ronin::Support::Network::Host: www.example.com>
+        #
         def subdomain(subname)
           Host.new("#{subname}.#{@name}")
         end
@@ -290,8 +310,8 @@ module Ronin
         #   # => #<Ronin::Support::Network::Host: www.example.com>
         #
         def change_suffix(new_suffix)
-          name, suffix = PublicSuffix.list.split(@name)
-          new_suffix   = new_suffix.to_s
+          name, _suffix = PublicSuffix.list.split(@name)
+          new_suffix    = new_suffix.to_s
 
           if new_suffix.start_with?('.')
             return self.class.new("#{name}#{new_suffix}")
@@ -345,7 +365,7 @@ module Ronin
 
           PublicSuffix.list.each do |suffix|
             unless suffix.wildcard?
-              if (type == nil) || (suffix.type == type)
+              if type.nil? || (suffix.type == type)
                 yield change_suffix(suffix)
               end
             end
@@ -1416,6 +1436,14 @@ module Ronin
         #
         # @note This method will query `8.8.8.8` which supports `ANY` queries.
         #
+        # @example
+        #   host = Network::Host.new('www.example.com')
+        #   host.registered?
+        #   # => true
+        #   bad_host = Network::Host.new('foo.example.com')
+        #   bad_host.registered?
+        #   # => false
+        #
         def registered?
           !get_any_records(nameserver: '8.8.8.8').empty?
         end

data/lib/ronin/support/network/http/core_ext.rb

@@ -16,4 +16,4 @@
 # along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
-require 'ronin/support/network/http/core_ext/uri/http.rb'
+require 'ronin/support/network/http/core_ext/uri/http'