ronin-support 1.0.0 → 1.0.2

data/lib/ronin/support/network/asn/record.rb

@@ -20,6 +20,9 @@ module Ronin
   module Support
     module Network
       module ASN
+        #
+        # Represents an individual ASN record.
+        #
         class Record
 
           # The ASN number.

data/lib/ronin/support/network/asn/record_set.rb

@@ -22,6 +22,9 @@ module Ronin
   module Support
     module Network
       module ASN
+        #
+        # A sub-set of ASN records.
+        #
         class RecordSet
 
           include Enumerable

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

@@ -27,6 +27,83 @@ module Ronin
       #
       # Handles Autonomous System Numbers (ASN).
       #
+      # ## Example
+      #
+      # Query the ASN record for a given IP address:
+      #
+      #     Network::ASN.query('4.2.2.1')
+      #     # =>
+      #     # #<Ronin::Support::Network::ASN::DNSRecord:0x00007f34424f4ac0
+      #     #  @country_code="US",
+      #     #  @name=nil,
+      #     #  @number=3356,
+      #     #  @range=#<Ronin::Support::Network::IPRange::CIDR: 4.0.0.0/9>>
+      #
+      # Query all ASN records for the given ISP name:
+      #
+      #     Network::ASN.list.name('LEVEL3').to_a
+      #     # => [#<Ronin::Support::Network::ASN::Record:0x00007f344164ed18
+      #     #      @country_code="US",
+      #     #      @name="LEVEL3",
+      #     #      @number=3356,
+      #     #      @range=#<Ronin::Support::Network::IPRange::Range: 4.0.0.0 - 4.23.87.255>>,
+      #     #     #<Ronin::Support::Network::ASN::Record:0x00007f344164d828
+      #     #      @country_code="US",
+      #     #      @name="LEVEL3",
+      #     #      @number=3356,
+      #     #      @range=#<Ronin::Support::Network::IPRange::Range: 4.23.90.0 - 4.23.91.255>>,
+      #     #     ...]
+      #
+      # Query all IPv6 ASN records for a given company:
+      #
+      #     Network::ASN.list.name('GOOGLE').ipv6
+      #     # =>
+      #     # [#<Ronin::Support::Network::ASN::Record:0x00007fc45b411500
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:: - 2001:4860:1024:ffff:ffff:ffff:ffff:ffff>>,
+      #     #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b428d68
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:1026:: - 2001:4860:4804:ffff:ffff:ffff:ffff:ffff>>,
+      #     #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b44be08
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4806:: - 2001:4860:4864:ffff:ffff:ffff:ffff:ffff>>,
+      #     #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b4562e0
+      #     #   @country_code="US",
+      #     #   @name="GOOGLE",
+      #     #   @number=15169,
+      #     #   @range=
+      #     #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4865:: - 2001:4860:ffff:ffff:ffff:ffff:ffff:ffff>>]
+      #
+      # Return all ASN numbers for a country:
+      #
+      #     Network::ASN.list.country('NZ').numbers
+      #     # => #<Set:
+      #     #     {45177,
+      #     #      55759,
+      #     #      55850,
+      #     #      9500,
+      #     #      ...}>
+      #
+      # Return all ASN names for a country:
+      #
+      #     Network::ASN.list.country_code('NZ').names
+      #     # Network::ASN.list.country('NZ').names
+      #     # =>
+      #     # #<Set:
+      #     #  {"DEVOLI-AS-AP Devoli",
+      #     #   "MFAT-NET-NZ 195 Lambton Quay",
+      #     #   "MERCURYNZ-AS-AP Mercury NZ Limited",
+      #     #   ...}>
+      #
       # @api public
       #
       # @since 1.0.0
@@ -45,6 +122,15 @@ module Ronin
         #   Performs rDNS queries using `*.nmap.asn.cymru.com` for IPv4
         #   addresses and `*.nmap6.asn.cymru.com` for IPv6 addresses.
         #
+        # @example
+        #   Network::ASN.query('4.2.2.1')
+        #   # =>
+        #   # #<Ronin::Support::Network::ASN::DNSRecord:0x00007f34424f4ac0
+        #   #  @country_code="US",
+        #   #  @name=nil,
+        #   #  @number=3356,
+        #   #  @range=#<Ronin::Support::Network::IPRange::CIDR: 4.0.0.0/9>>
+        #
         def self.query(ip)
           ip = IPAddr.new(ip) unless ip.kind_of?(IPAddr)
 
@@ -62,8 +148,9 @@ module Ronin
             return nil
           end
 
-          asn, cidr_range, country_code, *rest = string.split(' | ',5)
-          asn = asn.to_i
+          asn, cidr_range, country_code, *_rest = string.split(' | ',5)
+
+          asn        = asn.to_i
           cidr_range = IPRange::CIDR.new(cidr_range)
 
           return DNSRecord.new(asn,cidr_range,country_code)
@@ -76,11 +163,85 @@ module Ronin
         # @return [List]
         #   The loaded list file.
         #
+        # @note
+        #   The first access of {list} will take a while, as the entire ASN
+        #   list will need to be downloaded and parsed.
+        #
+        # @example Query the ASN record for the given IP address:
+        #   Network::ASN.list.ip('4.2.2.1')
+        #   # =>
+        #   # #<Ronin::Support::Network::ASN::Record:0x00007fc46207f818
+        #   #  @country_code="US",
+        #   #  @name="LEVEL3",
+        #   #  @number=3356,
+        #   #  @range=#<Ronin::Support::Network::IPRange::Range: 4.0.0.0 - 4.23.87.255>>
+        #
+        # @example Query all ASN records for the given ISP name:
+        #   Network::ASN.list.name('LEVEL3').to_a
+        #   # => [#<Ronin::Support::Network::ASN::Record:0x00007f344164ed18
+        #   #      @country_code="US",
+        #   #      @name="LEVEL3",
+        #   #      @number=3356,
+        #   #      @range=#<Ronin::Support::Network::IPRange::Range: 4.0.0.0 - 4.23.87.255>>,
+        #   #     #<Ronin::Support::Network::ASN::Record:0x00007f344164d828
+        #   #      @country_code="US",
+        #   #      @name="LEVEL3",
+        #   #      @number=3356,
+        #   #      @range=#<Ronin::Support::Network::IPRange::Range: 4.23.90.0 - 4.23.91.255>>,
+        #   #     ...]
+        #
+        # @example Query all IPv6 ASN records for a given company:
+        #   Network::ASN.list.name('GOOGLE').ipv6
+        #   # =>
+        #   # [#<Ronin::Support::Network::ASN::Record:0x00007fc45b411500
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:: - 2001:4860:1024:ffff:ffff:ffff:ffff:ffff>>,
+        #   #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b428d68
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:1026:: - 2001:4860:4804:ffff:ffff:ffff:ffff:ffff>>,
+        #   #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b44be08
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4806:: - 2001:4860:4864:ffff:ffff:ffff:ffff:ffff>>,
+        #   #  #<Ronin::Support::Network::ASN::Record:0x00007fc45b4562e0
+        #   #   @country_code="US",
+        #   #   @name="GOOGLE",
+        #   #   @number=15169,
+        #   #   @range=
+        #   #    #<Ronin::Support::Network::IPRange::Range: 2001:4860:4865:: - 2001:4860:ffff:ffff:ffff:ffff:ffff:ffff>>]
+        #
+        # @example Return all ASN numbers for a country:
+        #   Network::ASN.list.country('NZ').numbers
+        #   # => #<Set:
+        #   #     {45177,
+        #   #      55759,
+        #   #      55850,
+        #   #      9500,
+        #   #      ...}>
+        #
+        # @example Return all ASN names for a country:
+        #   Network::ASN.list.country_code('NZ').names
+        #   # Network::ASN.list.country('NZ').names
+        #   # =>
+        #   # #<Set:
+        #   #  {"DEVOLI-AS-AP Devoli",
+        #   #   "MFAT-NET-NZ 195 Lambton Quay",
+        #   #   "MERCURYNZ-AS-AP Mercury NZ Limited",
+        #   #   ...}>
+        #
         def self.list
-          @list ||= (
-            List.update
-            List.load_file
-          )
+          @list ||= begin
+                      List.update
+                      List.load_file
+                    end
         end
       end
     end

data/lib/ronin/support/network/dns/mixin.rb

@@ -25,6 +25,8 @@ module Ronin
         #
         # Provides helper methods for performing DNS queries.
         #
+        # @api public
+        #
         module Mixin
           #
           # Sets the DNS nameservers to query.
@@ -79,8 +81,6 @@ module Ronin
           # @return [Resolv, Resolv::DNS]
           #   The DNS Resolver.
           #
-          # @api public
-          #
           def dns_resolver(nameservers: nil, nameserver: nil)
             if nameserver
               Network::DNS.resolver(nameserver: nameserver)
@@ -111,8 +111,6 @@ module Ronin
           # @return [String, nil]
           #   The address of the hostname.
           #
-          # @api public
-          #
           def dns_get_address(host,**kwargs)
             dns_resolver(**kwargs).get_address(host.to_s)
           end
@@ -137,8 +135,6 @@ module Ronin
           # @return [Array<String>]
           #   The addresses of the hostname.
           #
-          # @api public
-          #
           def dns_get_addresses(host,**kwargs)
             dns_resolver(**kwargs).get_addresses(host.to_s)
           end
@@ -161,8 +157,6 @@ module Ronin
           # @return [String, nil]
           #   The hostname of the address.
           #
-          # @api public
-          #
           def dns_get_name(ip,**kwargs)
             dns_resolver(**kwargs).get_name(ip.to_s)
           end
@@ -187,8 +181,6 @@ module Ronin
           # @return [Array<String>]
           #   The hostnames of the address.
           #
-          # @api public
-          #
           def dns_get_names(ip,**kwargs)
             dns_resolver(**kwargs).get_names(ip.to_s)
           end

data/lib/ronin/support/network/dns/resolver.rb

@@ -90,6 +90,7 @@ module Ronin
             begin
               @resolver.getaddress(host).to_s
             rescue Resolv::ResolvError
+              # ignore any Resolv failures
             end
           end
 
@@ -123,6 +124,7 @@ module Ronin
           def get_name(ip)
             @resolver.getname(ip).to_s
           rescue Resolv::ResolvError
+            # ignore any Resolv failures
           end
 
           #
@@ -189,6 +191,7 @@ module Ronin
             begin
               @resolver.getresource(name,record_class)
             rescue Resolv::ResolvError
+              # ignore any Resolv failures
             end
           end
 

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

@@ -33,31 +33,31 @@ module Ronin
       #     # => #<Ronin::Support::Network::IP: 192.30.255.113>
       #     domain.mailservers
       #     # => ["aspmx.l.google.com",
-      #           "alt3.aspmx.l.google.com",
-      #           "alt4.aspmx.l.google.com",
-      #           "alt1.aspmx.l.google.com",
-      #           "alt2.aspmx.l.google.com"]
+      #     #     "alt3.aspmx.l.google.com",
+      #     #     "alt4.aspmx.l.google.com",
+      #     #     "alt1.aspmx.l.google.com",
+      #     #     "alt2.aspmx.l.google.com"]
       #     domain.nameservers
       #     # => ["dns1.p08.nsone.net",
-      #           "dns2.p08.nsone.net",
-      #           "dns3.p08.nsone.net",
-      #           "dns4.p08.nsone.net",
-      #           "ns-1283.awsdns-32.org",
-      #           "ns-1707.awsdns-21.co.uk",
-      #           "ns-421.awsdns-52.com",
-      #           "ns-520.awsdns-01.net"]
+      #     #     "dns2.p08.nsone.net",
+      #     #     "dns3.p08.nsone.net",
+      #     #     "dns4.p08.nsone.net",
+      #     #     "ns-1283.awsdns-32.org",
+      #     #     "ns-1707.awsdns-21.co.uk",
+      #     #     "ns-421.awsdns-52.com",
+      #     #     "ns-520.awsdns-01.net"]
       #     domain.txt_strings
       #     # => ["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",
-      #           "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
-      #           "MS=ms44452932",
-      #           "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
-      #           "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
-      #           "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
-      #           "MS=ms58704441",
-      #           "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
-      #           "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
-      #           "apple-domain-verification=RyQhdzTl6Z6x8ZP4"]
+      #     #     "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",
+      #     #     "MS=6BF03E6AF5CB689E315FB6199603BABF2C88D805",
+      #     #     "MS=ms44452932",
+      #     #     "atlassian-domain-verification=jjgw98AKv2aeoYFxiL/VFaoyPkn3undEssTRuMg6C/3Fp/iqhkV4HVV7WjYlVeF8",
+      #     #     "stripe-verification=f88ef17321660a01bab1660454192e014defa29ba7b8de9633c69d6b4912217f",
+      #     #     "google-site-verification=UTM-3akMgubp6tQtgEuAkYNYLyYAvpTnnSrDMWoDR3o",
+      #     #     "MS=ms58704441",
+      #     #     "docusign=087098e3-3d46-47b7-9b4e-8a23028154cd",
+      #     #     "adobe-idp-site-verification=b92c9e999aef825edc36e0a3d847d2dbad5b2fc0e05c79ddd7a16139b48ecf4b",
+      #     #     "apple-domain-verification=RyQhdzTl6Z6x8ZP4"]
       #
       # @api public
       #

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

@@ -232,8 +232,6 @@ module Ronin
           return new(name: name, **parse_address(address))
         end
 
-        private
-
         #
         # Parses the address portion of an email address.
         #
@@ -326,8 +324,6 @@ module Ronin
           return {domain: domain, address: address}
         end
 
-        public
-
         # Email address de-obfuscation rules.
         DEOBFUSCATIONS = {
           /\s+@\s+/                 => '@',
@@ -425,7 +421,7 @@ module Ronin
 
         # Email address obfuscation rules.
         OBFUSCATIONS = [
-          [/\@/, {'@' => ' @ '  }],
+          [/\@/, {'@' => ' @ '   }],
           [/\@/, {'@' => ' AT '  }],
           [/\@/, {'@' => ' at '  }],
           [/\@/, {'@' => '[AT]'  }],

data/lib/ronin/support/network/esmtp/mixin.rb

@@ -104,6 +104,7 @@ module Ronin
               end
             else
               smtp = smtp_connect(host,**kwargs)
+
               smtp.esmtp = true
               return smtp
             end

data/lib/ronin/support/network/ftp/mixin.rb

@@ -86,8 +86,8 @@ module Ronin
                                 account:  nil,
                                 passive:  true)
             host = DNS::IDN.to_ascii(host)
+            ftp  = Net::FTP.new
 
-            ftp = Net::FTP.new
             ftp.connect(host,port)
             ftp.login(user,password,account)
             ftp.passive = passive

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/uri/http.rb

@@ -33,6 +33,10 @@ module URI
     # @return [Integer]
     #   The HTTP Response Status.
     #
+    # @example
+    #   URI('http://github.com/').status
+    #   # => 301
+    #
     # @see Ronin::Support::Network::HTTP.response_status
     #
     # @since 0.3.0
@@ -53,6 +57,10 @@ module URI
     #
     # @see Ronin::Support::Network::HTTP.ok?
     #
+    # @example
+    #   URI('https://example.com/').ok?
+    #   # => true
+    #
     # @since 0.3.0
     #
     def ok?(**kwargs)

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'