ronin 1.5.1 → 2.0.0.beta1

data/lib/ronin/email_address.rb

@@ -1,257 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-require 'ronin/extensions/regexp'
-require 'ronin/model'
-require 'ronin/model/importable'
-require 'ronin/user_name'
-require 'ronin/host_name'
-
-require 'uri/mailto'
-require 'dm-timestamps'
-
-module Ronin
-  #
-  # Represents email addresses that can be stored in the {Database}.
-  #
-  class EmailAddress
-
-    include Model
-
-    # The primary key of the email address.
-    property :id, Serial
-
-    # The user-name component of the email address.
-    belongs_to :user_name
-
-    # The host-name component of the email address.
-    belongs_to :host_name
-
-    # Any IP addresses associated with the host name.
-    has 0..n, :ip_addresses, :through => :host_name,
-                             :model => 'IPAddress'
-
-    # Any web credentials that are associated with the email address.
-    has 0..n, :credentials
-
-    # Tracks when the email address was created at.
-    timestamps :created_at
-
-    # Validates the uniqueness of the user-name and the host-name.
-    validates_uniqueness_of :user_name, :scope => [:host_name]
-
-    #
-    # Extracts email addresses from the given text.
-    #
-    # @param [String] text
-    #   The text to parse.
-    #
-    # @yield [email]
-    #   The given block will be passed each extracted email address.
-    #
-    # @yieldparam [EmailAddress] email
-    #   An extracted host-name.
-    #
-    # @return [Array<EmailAddress>]
-    #   If no block is given, an Array of email address will be returned.
-    #
-    # @see 1.3.0
-    #
-    # @api public
-    #
-    def self.extract(text)
-      return enum_for(__method__,text).to_a unless block_given?
-
-      scanner = StringScanner.new(text)
-
-      while scanner.skip_until(Regexp::EMAIL_ADDR)
-        yield parse(scanner.matched)
-      end
-
-      return nil
-    end
-
-    #
-    # Searches for email addresses associated with the given host names.
-    #
-    # @param [Array<String>, String] names
-    #   The host name(s) to search for.
-    #
-    # @return [Array<EmailAddress>]
-    #   The matching email addresses.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.with_hosts(names)
-      all('host_name.address' => names)
-    end
-
-    #
-    # Searches for email addresses associated with the given IP address(es).
-    #
-    # @param [Array<String>, String] ips
-    #   The IP address(es) to search for.
-    #
-    # @return [Array<EmailAddress>]
-    #   The matching email addresses.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.with_ips(ips)
-      all('ip_addresses.address' => ips)
-    end
-
-    #
-    # Searches for email addresses associated with the given user names.
-    #
-    # @param [Array<String>, String] names
-    #   The user name(s) to search for.
-    #
-    # @return [Array<EmailAddress>]
-    #   The matching email addresses.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.with_users(names)
-      all('user_name.name' => names)
-    end
-
-    #
-    # Parses an email address.
-    #
-    # @param [String] email
-    #   The email address to parse.
-    #
-    # @return [EmailAddress]
-    #   A new or previously saved email address resource.
-    #
-    # @raise [RuntimeError]
-    #   The email address did not have a user name or a host name.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.parse(email)
-      user, host = email.split('@',2)
-
-      user.strip!
-
-      if user.empty?
-        raise("email address #{email.dump} must have a user name")
-      end
-
-      host.strip!
-
-      if host.empty?
-        raise("email address #{email.dump} must have a host name")
-      end
-
-      return first_or_new(
-        :user_name => UserName.first_or_new(:name => user),
-        :host_name => HostName.first_or_new(:address => host)
-      )
-    end
-
-    #
-    # Creates a new Email Address.
-    #
-    # @param [URI::MailTo, #to_s] email
-    #   The URI or String to create the Email Address from.
-    #
-    # @return [EmailAddress]
-    #   The new Email Address.
-    #
-    # @since 1.4.0
-    #
-    # @api public
-    #
-    def self.from(email)
-      email = case email
-              when URI::MailTo then email.to
-              else                  email.to_s
-              end
-
-      return parse(email)
-    end
-
-    #
-    # The user of the email address.
-    #
-    # @return [String]
-    #   The user name.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def user
-      self.user_name.name if self.user_name
-    end
-
-    #
-    # The host of the email address.
-    #
-    # @return [String]
-    #   The host name.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def host
-      self.host_name.address if self.host_name
-    end
-
-    #
-    # Converts the email address into a String.
-    #
-    # @return [String]
-    #   The raw email address.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def to_s
-      "#{self.user_name}@#{self.host_name}"
-    end
-
-    #
-    # Inspects the email address.
-    #
-    # @return [String]
-    #   The inspected email address.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def inspect
-      "#<#{self.class}: #{self}>"
-    end
-
-  end
-end

data/lib/ronin/environment.rb

@@ -1,30 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-#
-# Loads all extensions to core Ruby classes.
-#
-require 'ronin/ronin'
-require 'ronin/support'
-
-#
-# Includes the Ronin namespace and additional helper methods.
-#
-include Ronin
-include Ronin::Support

data/lib/ronin/exceptions/duplicate_repository.rb

@@ -1,23 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-module Ronin
-  class DuplicateRepository < StandardError
-  end
-end

data/lib/ronin/exceptions/repository_not_found.rb

@@ -1,23 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-module Ronin
-  class RepositoryNotFound < StandardError
-  end
-end

data/lib/ronin/exceptions.rb

@@ -1,21 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-require 'ronin/exceptions/duplicate_repository'
-require 'ronin/exceptions/repository_not_found'

data/lib/ronin/host_name.rb

@@ -1,271 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-require 'ronin/extensions/regexp'
-require 'ronin/extensions/resolv'
-require 'ronin/model/importable'
-require 'ronin/address'
-require 'ronin/ip_address'
-
-require 'uri/generic'
-require 'strscan'
-require 'resolv'
-
-module Ronin
-  #
-  # Represents host names that can be stored in the {Database}.
-  #
-  class HostName < Address
-
-    include Model::Importable
-
-    # The address of the host name
-    property :address, String, :length => 256,
-                               :required => true,
-                               :unique => true,
-                               :format => /^#{Regexp::HOST_NAME}$/,
-                               :messages => {
-                                 :format => 'Must be a valid host-name'
-                               }
-
-    # The IP Address associations
-    has 0..n, :host_name_ip_addresses, :model => 'HostNameIPAddress'
-
-    # The IP Addresses that host the host name
-    has 0..n, :ip_addresses, :through => :host_name_ip_addresses,
-                             :model => 'IPAddress'
-
-    # Open ports of the host
-    has 0..n, :open_ports, :through => :ip_addresses
-
-    # Ports of the host
-    has 0..n, :ports, :through => :ip_addresses
-
-    # The email addresses that are associated with the host-name.
-    has 0..n, :email_addresses
-
-    # URLs that point to this host name
-    has 0..n, :urls, :model => 'URL'
-
-    #
-    # Extracts host-names from the given text.
-    #
-    # @param [String] text
-    #   The text to parse.
-    #
-    # @yield [host]
-    #   The given block will be passed each extracted host-name.
-    #
-    # @yieldparam [HostName] host
-    #   An extracted host-name.
-    #
-    # @return [Array<HostName>]
-    #   If no block is given, an Array of host-names will be returned.
-    #
-    # @see 1.3.0
-    #
-    # @api public
-    #
-    def self.extract(text)
-      return enum_for(__method__,text).to_a unless block_given?
-
-      scanner = StringScanner.new(text)
-
-      while scanner.skip_until(Regexp::HOST_NAME)
-        yield parse(scanner.matched)
-      end
-
-      return nil
-    end
-
-    #
-    # Searches for host names associated with the given IP address(es).
-    #
-    # @param [Array<String>, String] ips
-    #   The IP address(es) to search for.
-    #
-    # @return [Array<HostName>]
-    #   The matching host names.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.with_ips(ips)
-      all('ip_addresses.address' => ips)
-    end
-
-    #
-    # Searches for host names with the given open port(s).
-    #
-    # @param [Array<Integer>, Integer] numbers
-    #   The open port(s) to search for.
-    #
-    # @return [Array<HostName>]
-    #   The matching host names.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.with_ports(numbers)
-      all('ports.number' => numbers)
-    end
-
-    #
-    # Searches for all host names under the Top-Level Domain (TLD).
-    #
-    # @param [String] name
-    #   The Top-Level Domain (TLD).
-    #
-    # @return [Array<HostName>]
-    #   The matching host names.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.tld(name)
-      all(:address.like => "%.#{name}")
-    end
-
-    #
-    # Searches for all host names sharing a common domain name.
-    #
-    # @param [String] name
-    #   The common domain name to search for.
-    #
-    # @return [Array<HostName>]
-    #   The matching host names.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.domain(name)
-      all(:address.like => "#{name}.%") |
-      all(:address.like => "%.#{name}.%")
-    end
-
-    #
-    # Looks up all host names associated with an IP address.
-    #
-    # @param [IPAddr, String] addr
-    #   The IP address to lookup.
-    #
-    # @param [String] nameserver
-    #   The optional nameserver to query.
-    #
-    # @return [Array<HostName>]
-    #   The host names associated with the IP address.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.lookup(addr,nameserver=nil)
-      addr = addr.to_s
-      ip = IPAddress.first_or_new(:address => addr)
-
-      resolver = Resolv.resolver(nameserver)
-      hosts = begin
-                resolver.getnames(addr)
-              rescue
-                []
-              end
-
-      hosts.map! do |name|
-        HostName.first_or_create(
-          :address => name,
-          :ip_addresses => [ip]
-        )
-      end
-
-      return hosts
-    end
-
-    alias name address
-
-    #
-    # Looks up all IP Addresses for the host name.
-    #
-    # @param [String] nameserver
-    #   The optional nameserver to query.
-    #
-    # @return [Array<IPAddress>]
-    #   The IP Addresses for the host name.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def lookup!(nameserver=nil)
-      resolver = Resolv.resolver(nameserver)
-      ips = begin
-              resolver.getaddresses(self.address)
-            rescue
-              []
-            end
-
-      ips.map! do |addr|
-        IPAddress.first_or_create(
-          :address => addr,
-          :host_names => [self]
-        )
-      end
-
-      return ips
-    end
-
-    #
-    # The IP Address that was most recently used by the host name.
-    #
-    # @return [IpAddress]
-    #   The IP Address that most recently used by the host name.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def recent_ip_address
-      self.host_name_ip_addresses.all(
-        :order => [:created_at.desc]
-      ).ip_addresses.first
-    end
-
-    #
-    # Determines when the host was last scanned.
-    #
-    # @return [Time, nil]
-    #   The time the host was last scanned at.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def last_scanned_at
-      last_scanned_url = self.urls.first(
-        :order => [:last_scanned_at.desc]
-      )
-
-      return last_scanned_url.last_scanned_at if last_scanned_url
-    end
-
-  end
-end

data/lib/ronin/host_name_ip_address.rb

@@ -1,45 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# 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/>.
-#
-
-require 'ronin/model'
-
-require 'dm-timestamps'
-
-module Ronin
-  #
-  # Associates a {HostName} with an {IPAddress}.
-  #
-  class HostNameIPAddress
-
-    include Model
-
-    # The primary-key of the join model.
-    property :id, Serial
-
-    # The host name pointing to the IP Address
-    belongs_to :host_name
-
-    # The IP Address
-    belongs_to :ip_address, :model => 'IPAddress'
-
-    # Tracks when a IP Address is associated with a host name
-    timestamps :created_at
-
-  end
-end