ronin 1.5.1 → 2.0.0.beta1

data/lib/ronin/arch.rb

@@ -1,136 +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 'ronin/model/has_unique_name'
-
-require 'dm-is-predefined'
-
-module Ronin
-  #
-  # Represents a Computer Architecture and predefines many other common
-  # architectures ({x86}, {x86_64}, {ia64}, {ppc}, {ppc64}, {sparc},
-  # {sparc64}, {mips} and {arm}).
-  #
-  class Arch
-
-    include Model
-    include Model::HasUniqueName
-
-    is :predefined
-
-    # Primary key
-    property :id, Serial
-
-    # Endianness of the architecture
-    property :endian, String, :set => ['little', 'big'], :required => true
-
-    # Address length of the architecture
-    property :address_length, Integer, :required => true
-
-    #
-    # Defines a new pre-defined Arch.
-    #
-    # @param [Symbol, String] name
-    #   The name of the architecture.
-    #
-    # @param [Hash] options
-    #   Additional options.
-    #
-    # @option options [Symbol, String] :endian
-    #   The endianness of the architecture.
-    #
-    # @option options [Integer] :address_length
-    #   The address-length of the architecture.
-    #
-    # @example Defining a pre-defined Arch
-    #   Arch.predefine :alpha, :endian => :big, :address_length => 8
-    #
-    # @example Retrieving a pre-defined Arch
-    #   Arch.alpha
-    #
-    # @api private
-    #
-    def self.predefine(name,options={})
-      super(name,{:name => name}.merge(options))
-    end
-
-    # The x86 Architecture
-    predefine :x86, :endian => :little, :address_length => 4
-
-    # Alias to {x86}.
-    predefine :i386, :name => 'x86',
-                     :endian => :little,
-                     :address_length => 4
-
-    # Alias to {x86}.
-    predefine :i486, :name => 'x86',
-                     :endian => :little,
-                     :address_length => 4
-
-    # Alias to {x86}.
-    predefine :i686, :name => 'x86',
-                     :endian => :little,
-                     :address_length => 4
-
-    # Alias to {x86}.
-    predefine :i986, :name => 'x86',
-                     :endian => :little,
-                     :address_length => 4
-
-    # The x86_64 Architecture
-    predefine :x86_64, :name => 'x86-64',
-                       :endian => :little,
-                       :address_length => 8
-
-    # The ia64 Architecture
-    predefine :ia64, :endian => :little, :address_length => 8
-
-    # The 32-bit PowerPC Architecture
-    predefine :ppc, :endian => :big, :address_length => 4
-
-    # The 64-bit PowerPC Architecture
-    predefine :ppc64, :endian => :big, :address_length => 8
-
-    # The 32-bit SPARC Architecture
-    predefine :sparc, :endian => :big, :address_length => 4
-
-    # The 64-bit SPARC Architecture
-    predefine :sparc64, :endian => :big, :address_length => 8
-
-    # The MIPS (little endian) Architecture
-    predefine :mips_le, :endian => :little, :address_length => 4
-
-    # The MIPS (big endian) Architecture
-    predefine :mips_be, :endian => :big, :address_length => 4
-
-    # Alias to {mips_be}.
-    predefine :mips, :name => 'mips_be', :endian => :big, :address_length => 4
-
-    # The ARM (little endian) Architecture
-    predefine :arm_le, :endian => :little, :address_length => 4
-
-    # The ARM (big endian) Architecture
-    predefine :arm_be, :endian => :big, :address_length => 4
-
-    # Alias to {arm_be}.
-    predefine :arm, :name => 'arn_be', :endian => :big, :address_length => 4
-
-  end
-end

data/lib/ronin/author.rb

@@ -1,66 +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 'ronin/model/has_name'
-
-module Ronin
-  #
-  # Represents an author and any information about them or the organization
-  # which they belong to.
-  #
-  class Author
-
-    include Model
-    include Model::HasName
-
-    # Primary key of the author
-    property :id, Serial
-
-    # Author's associated group
-    property :organization, String
-
-    # Author's PGP signature
-    property :pgp_signature, Text
-
-    # Author's email
-    property :email, String
-
-    # Author's site
-    property :site, URI, :length => 256
-
-    # Author's biography
-    property :biography, Text
-
-    #
-    # Converts the author to a String.
-    #
-    # @return [String]
-    #   The name of the author.
-    #
-    # @api public
-    #
-    def to_s
-      if self.email then "#{self.name} <#{self.email}>"
-      else               super
-      end
-    end
-
-  end
-end

data/lib/ronin/auto_load.rb

@@ -1,91 +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 'open_namespace'
-require 'dm-core'
-
-module Ronin
-  #
-  # When included into other namespaces, it allows for auto-loading Classes
-  # or Modules via {ClassMethods#const_missing}.
-  #
-  # @api semipublic
-  #
-  # @since 1.1.0
-  #
-  module AutoLoad
-    def self.included(base)
-      base.send :include, OpenNamespace
-      base.send :extend, ClassMethods
-    end
-
-    module ClassMethods
-      #
-      # Requires the file that should contain the constant.
-      #
-      # @param [String, Symbol] name
-      #   The name of the constant.
-      #
-      # @return [Class, Module, nil]
-      #   The loaded constant.
-      #
-      # @since 1.5.0
-      #
-      # @api public
-      #
-      def require_const(name)
-        const = super(name)
-
-        if (const && const < DataMapper::Resource)
-          DataMapper.finalize
-        end
-
-        return const
-      end
-
-      #
-      # Transparently auto-loads Classes and Modules from their respective
-      # files using [OpenNamespace](http://rubydoc.info/gems/open_namespace).
-      #
-      # @param [String, Symbol] name
-      #   The name of the Class or Module to auto-load.
-      #
-      # @return [Class, Module]
-      #   The loaded Class or Module.
-      #
-      # @raise [NameError]
-      #   The Class or Module could not be found.
-      #
-      # @since 1.1.0
-      #
-      # @api public
-      #
-      def const_missing(name)
-        const = super(name)
-
-        # if the loaded Class is a DataMapper Resource, re-finalize
-        if const < DataMapper::Resource
-          DataMapper.finalize
-        end
-
-        return const
-      end
-    end
-  end
-end

data/lib/ronin/bootstrap.rb

@@ -1,27 +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 the Ronin configuration and sets up the Database.
-#
-require 'ronin/config'
-require 'ronin/database'
-
-Ronin::Config.load
-Ronin::Database.setup

data/lib/ronin/campaign.rb

@@ -1,129 +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 'ronin/model/has_unique_name'
-require 'ronin/model/has_description'
-require 'ronin/address'
-require 'ronin/target'
-
-require 'dm-timestamps'
-
-module Ronin
-  #
-  # Represents a grouping of targeted {Address}es.
-  #
-  class Campaign
-
-    include Model
-    include Model::HasUniqueName
-    include Model::HasDescription
-
-    # Primary key of the campaign
-    property :id, Serial
-
-    # Defines the `created_at` and `updated_at` timestamps
-    timestamps :at
-
-    # The targets of the campaign
-    has 0..n, :targets
-
-    # The addresses being targeted in the campaign
-    has 0..n, :addresses, :through => :targets
-
-    # The organization the campaign covers
-    has 0..n, :organizations, :through => :targets
-
-    #
-    # Searches for all campaigns targeting an {Address}.
-    #
-    # @param [Array<String>, String] addr
-    #   The address(es) to search for.
-    #
-    # @return [Array<Campaign>]
-    #   The campaigns that target the given address.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.targeting(addr)
-      all('addresses.address' => addr)
-    end
-
-    #
-    # Searches for all campaigns targeting an {Organization}.
-    #
-    # @param [Array<String>, String] names
-    #   The organization name(s) to search for.
-    #
-    # @return [Array<Campaign>]
-    #   The campaigns that target the specified organizations.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.targeting_orgs(names)
-      all('organizations.name' => names)
-    end
-
-    #
-    # Determines if an address is targeted by the campaign.
-    #
-    # @param [Address] address
-    #   The address.
-    #
-    # @return [Boolean]
-    #   Specifies whether the address is targeted.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def targets?(address)
-      self.addresses.include?(address)
-    end
-
-    #
-    # Adds an address to the campaign.
-    #
-    # @param [String] addr
-    #   The address that will be targeted.
-    #
-    # @return [Target]
-    #   The new target of the campaign.
-    #
-    # @raise [RuntimeError]
-    #   The given address could not be found.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def target!(addr)
-      unless (address = Address.first(:address => addr))
-        raise("unknown address #{addr.dump}")
-      end
-
-      return Target.first_or_create(:campaign => self, :address => address)
-    end
-
-  end
-end

data/lib/ronin/credential.rb

@@ -1,119 +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'
-
-module Ronin
-  #
-  # Represents Credentials used to access services or websites.
-  #
-  class Credential
-
-    include Model
-
-    # Primary key of the credential
-    property :id, Serial
-
-    # User name of the credential
-    belongs_to :user_name
-
-    # The optional email address associated with the Credential
-    belongs_to :email_address, :required => false
-
-    # Password of the credential
-    belongs_to :password
-
-    #
-    # Searches for all credentials for a specific user.
-    #
-    # @param [String] name
-    #   The name of the user.
-    #
-    # @return [Array<Credential>]
-    #   The credentials for the user.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.for_user(name)
-      all('user_name.name' => name)
-    end
-
-    #
-    # Searches for all credentials with a common password.
-    #
-    # @param [String] password
-    #   The password to search for.
-    #
-    # @return [Array<Credential>]
-    #   The credentials with the common password.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def self.with_password(password)
-      all('password.clear_text' => password)
-    end
-
-    #
-    # The user the credential belongs to.
-    #
-    # @return [String]
-    #   The user name.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def user
-      self.user_name.name if self.user_name
-    end
-
-    #
-    # The clear-text password of the credential.
-    #
-    # @return [String]
-    #   The clear-text password.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def clear_text
-      self.password.clear_text if self.password
-    end
-
-    #
-    # Converts the credentials to a String.
-    #
-    # @return [String]
-    #   The user name and the password.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def to_s
-      "#{self.user_name}:#{self.password}"
-    end
-
-  end
-end