ronin 1.5.1 → 2.0.0.beta1

data/lib/ronin/license.rb

@@ -1,121 +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 software license and pre-defines many other common ones
-  # ({bsd}, {cc_by}, {cc_by_sa}, {cc_by_nd}, {cc_by_nc}, {cc_by_nc_sa},
-  # {cc_by_nc_nd}, {cc0}, {gpl2}, {gpl3}, {lgpl3} and {mit}).
-  #
-  class License
-
-    include Model
-    include Model::HasUniqueName
-
-    is :predefined
-
-    # Primary key
-    property :id, Serial
-
-    # Description of license
-    property :description, Text, :required => true
-
-    # URL of the License document
-    property :url, URI, :length => 256
-
-    # Berkeley Software Distribution License
-    predefine :bsd,
-              :name => 'BSD',
-              :description => 'Berkeley Software Distribution License',
-              :url => 'http://www.opensource.org/licenses/bsd-license.php'
-
-    # Creative Commons By-Attribution License
-    predefine :cc_by,
-              :name => 'CC by',
-              :description => 'Creative Commons Attribution v3.0 License',
-              :url => 'http://creativecommons.org/licenses/by/3.0/'
-
-    # Creative Commons By-Attribution Share-Alike License
-    predefine :cc_by_sa,
-              :name => 'CC by-sa',
-              :description => 'Creative Commons Attribution-Share Alike v3.0 License',
-              :url => 'http://creativecommons.org/licenses/by-sa/3.0/'
-
-    # Creative Commons By-Attribution No-Derivative Works License
-    predefine :cc_by_nd,
-              :name => 'CC by-nd',
-              :description => 'Creative Commons Attribution-No Derivative Works v3.0 License',
-              :url => 'http://creativecommons.org/licenses/by-nd/3.0/'
-
-    # Creative Commons By-Attribution Non-Commercial License
-    predefine :cc_by_nc,
-              :name => 'CC by-nc',
-              :description => 'Creative Commons Attribution-Noncommercial v3.0 License',
-              :url => 'http://creativecommons.org/licenses/by-nc/3.0/'
-
-    # Creative Commons By-Attribution Non-Commercial Share-Alike License
-    predefine :cc_by_nc_sa,
-              :name => 'CC by-nc-sa',
-              :description => 'Creative Commons Attribution-Noncommercial-Share Alike v3.0 License',
-              :url => 'http://creativecommons.org/licenses/by-nc-sa/3.0/'
-
-    # Creative Commons By-Attribution Non-Commercial No-Derivative Works
-    # License
-    predefine :cc_by_nc_nd,
-              :name => 'CC by-nc-nd',
-              :description => 'Creative Commons Attribution-Noncommercial-No Derivative Works v3.0 License',
-              :url => 'http://creativecommons.org/licenses/by-nc-nd/3.0/'
-
-    # Creative Commons Zero License
-    predefine :cc0,
-              :name => 'CC0',
-              :description => 'Creative Commons Zero License',
-              :url => 'http://creativecommons.org/licenses/zero/1.0/'
-
-    # General Public License, version 2
-    predefine :gpl2,
-              :name => 'GPL-2',
-              :description => 'GNU Public License v2.0',
-              :url => 'https://www.gnu.org/licenses/gpl-2.0.txt'
-
-    # General Public License, version 3
-    predefine :gpl3,
-              :name => 'GPL-3',
-              :description => 'GNU Public License v3.0',
-              :url => 'https://www.gnu.org/licenses/gpl-3.0.txt'
-
-    # Lesser General Public License, version 3
-    predefine :lgpl3,
-              :name => 'LGPL-3',
-              :description => 'GNU Lesser General Public License v3.0',
-              :url => 'https://www.gnu.org/licenses/lgpl-3.0.txt'
-
-    # The MIT "as-is" License
-    predefine :mit,
-              :name => 'MIT',
-              :description => 'The MIT Licence',
-              :url => 'http://www.opensource.org/licenses/mit-license.php'
-
-  end
-end

data/lib/ronin/mac_address.rb

@@ -1,111 +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/address'
-
-require 'strscan'
-
-module Ronin
-  #
-  # Represents MAC addresses that can be stored in the {Database}.
-  #
-  class MACAddress < Address
-
-    # The MAC address
-    property :address, String, :length => 17..17,
-                               :required => true,
-                               :unique => true,
-                               :format => /^#{Regexp::MAC}$/,
-                               :messages => {
-                                 :format => 'Must be a valid MAC address'
-                               }
-
-    # The IP Addresses the MAC Address hosts
-    has 0..n, :ip_address_mac_addresses, :model => 'IPAddressMACAddress'
-
-    # The IP Addresses associated with the MAC Address
-    has 0..n, :ip_addresses, :through => :ip_address_mac_addresses,
-                             :model => 'IPAddress'
-
-    #
-    # Extracts MAC addresses from the given text.
-    #
-    # @param [String] text
-    #   The text to parse.
-    #
-    # @yield [mac]
-    #   The given block will be passed each extracted MAC address.
-    #
-    # @yieldparam [MACAddress] mac
-    #   An extracted MAC Address
-    #
-    # @return [Array<MACAddress>]
-    #   If no block is given, an Array of MACAddress 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::MAC)
-        yield parse(scanner.matched)
-      end
-
-      return nil
-    end
-
-    #
-    # The IP Address that most recently used the MAC Address.
-    #
-    # @return [IpAddress]
-    #   The IP Address that most recently used the MAC Address.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def recent_ip_address
-      self.ip_address_mac_addresses.all(
-        :order => [:created_at.desc]
-      ).ip_addresses.first
-    end
-
-    #
-    # Converts the MAC address to an Integer.
-    #
-    # @return [Integer]
-    #   The network representation of the MAC address.
-    #
-    # @since 1.0.0
-    #
-    # @api public
-    #
-    def to_i
-      self.address.split(':').inject(0) do |bits,char|
-        bits = ((bits << 8) | char.hex)
-      end
-    end
-
-  end
-end

data/lib/ronin/model/has_authors.rb

@@ -1,111 +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/author'
-
-module Ronin
-  module Model
-    #
-    # Adds an `authors` relationship between a model and the {Author} model.
-    #
-    module HasAuthors
-      #
-      # Adds the `authors` relationship and {ClassMethods} to the model.
-      #
-      # @param [Class] base
-      #   The model.
-      #
-      # @api semipublic
-      #
-      def self.included(base)
-        base.send :include, Model, InstanceMethods
-        base.send :extend, ClassMethods
-
-        base.module_eval do
-          # The authors associated with the model.
-          has 0..n, :authors, Ronin::Author, :through => DataMapper::Resource
-
-          Ronin::Author.has 0..n, self.relationship_name,
-                                  :through => DataMapper::Resource,
-                                  :model => self
-        end
-      end
-
-      #
-      # Class methods that are added when {HasAuthors} is included into a
-      # model.
-      #
-      module ClassMethods
-        #
-        # Finds all resources associated with a given author.
-        #
-        # @param [String] name
-        #   The name of the author.
-        #
-        # @return [Array<Model>]
-        #   The resources written by the author.
-        #
-        # @api public
-        #
-        def written_by(name)
-          all('authors.name.like' => "%#{name}%")
-        end
-
-        #
-        # Finds all resources associated with a given organization.
-        #
-        # @param [String] name
-        #   The name of the organization.
-        #
-        # @return [Array<Model>]
-        #   The resources associated with the organization.
-        #
-        # @api public
-        #
-        def written_for(name)
-          all('authors.organization.like' => "%#{name}%")
-        end
-      end
-
-      #
-      # Instance methods that are added when {HasAuthors} is included into a
-      # model.
-      #
-      module InstanceMethods
-        #
-        # Adds a new author to the resource.
-        #
-        # @param [Hash] attributes
-        #   Additional attributes to create the new author.
-        #
-        # @example
-        #   author :name => 'Anonymous',
-        #          :email => 'anon@example.com',
-        #          :organization => 'Anonymous LLC'
-        #
-        # @api public
-        #
-        def author(attributes)
-          self.authors.new(attributes)
-        end
-      end
-    end
-  end
-end

data/lib/ronin/model/has_description.rb

@@ -1,73 +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/types/description'
-require 'ronin/model'
-
-module Ronin
-  module Model
-    #
-    # Adds a `description` property to a model.
-    #
-    module HasDescription
-      #
-      # Adds the `description` property and {ClassMethods} to the model.
-      #
-      # @param [Class] base
-      #   The model.
-      #
-      # @api semipublic
-      #
-      def self.included(base)
-        base.send :include, Model
-        base.send :extend, ClassMethods
-
-        base.module_eval do
-          # The description of the model
-          property :description, Model::Types::Description
-        end
-      end
-
-      #
-      # Class methods that are added when {HasDescription} is included into
-      # a model.
-      #
-      module ClassMethods
-        #
-        # Finds models with descriptions containing a given fragment of
-        # text.
-        #
-        # @param [String] fragment
-        #   The fragment of text to match descriptions with.
-        #
-        # @return [Array<Model>]
-        #   The found models.
-        #
-        # @example
-        #   Exploit.describing 'bypass'
-        #
-        # @api public
-        #
-        def describing(fragment)
-          all(:description.like => "%#{fragment}%")
-        end
-      end
-    end
-  end
-end

data/lib/ronin/model/has_license.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/license'
-
-module Ronin
-  module Model
-    #
-    # Adds a `license` relationship between a model and the {License} model.
-    #
-    module HasLicense
-      #
-      # Adds the `license` relationship and {ClassMethods} to the model.
-      #
-      # @param [Class] base
-      #   The model.
-      #
-      # @api semipublic
-      #
-      def self.included(base)
-        base.send :include, Model, InstanceMethods
-        base.send :extend, ClassMethods
-
-        base.module_eval do
-          # The license
-          belongs_to :license, Ronin::License, :required => false
-
-          Ronin::License.has 0..n, self.relationship_name, :model => self
-        end
-      end
-
-      #
-      # Class methods that are added when {HasLicense} is included into a
-      # model.
-      #
-      module ClassMethods
-        #
-        # Finds all models associated with a given license.
-        #
-        # @param [License, Symbol, #to_s] license
-        #   The license which models are associated with.
-        #
-        # @return [Array<Model>]
-        #   The models associated with a given license.
-        #
-        # @example Query using a predefined {License} resource.
-        #   LicensedModel.licensed_under(License.mit)
-        #   # => [#<Ronin::LicensedModel: ...>, ...]
-        #
-        # @example Query using the name of a predefined {License}.
-        #   LicensedModel.licensed_under(:cc_by_nc)
-        #   # => [#<Ronin::LicensedModel: ...>, ...]
-        #
-        # @example Query using the name of a {License}.
-        #   LicensedModel.licensed_under('GPL-2')
-        #   # => [#<Ronin::LicensedModel: ...>, ...]
-        #
-        # @since 1.0.0
-        #
-        # @api public
-        #
-        def licensed_under(license)
-          conditions = case license
-                       when License
-                         {:license => license}
-                       when Symbol
-                         {:license => License.predefined_resource(license)}
-                       else
-                         {'license.name' => license.to_s}
-                       end
-
-          all(conditions)
-        end
-      end
-
-      #
-      # Instance methods that are added when {HasLicense} is included into a
-      # model.
-      #
-      module InstanceMethods
-        #
-        # Sets the license of the model.
-        #
-        # @param [Symbol, String] name
-        #   The name of the license to use.
-        #
-        # @return [License]
-        #   The new license of the model.
-        #
-        # @example
-        #   licensed_under :mit
-        #
-        # @since 1.3.0
-        #
-        # @api public
-        #
-        def licensed_under(name)
-          self.license = Ronin::License.predefined_resource(name)
-        end
-
-        #
-        # @deprecated `license!` was deprecated in favor of {#licensed_under}.
-        #
-        # @since 1.0.0
-        #
-        def license!(name)
-          licensed_under(name)
-        end
-      end
-    end
-  end
-end

data/lib/ronin/model/has_name.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 'ronin/model'
-
-module Ronin
-  module Model
-    #
-    # Adds a `name` property to a model.
-    #
-    module HasName
-      #
-      # Adds the `name` property and {ClassMethods} to the model.
-      #
-      # @param [Class] base
-      #   The model.
-      #
-      # @api semipublic
-      #
-      def self.included(base)
-        base.send :include, Model, InstanceMethods
-        base.send :extend, ClassMethods
-
-        base.module_eval do
-          # The name of the model
-          property :name, String, :required => true, :index => true
-        end
-      end
-
-      #
-      # Class methods that are added when {HasName} is included into a
-      # model.
-      #
-      module ClassMethods
-        #
-        # Finds models with names containing a given fragment of text.
-        #
-        # @param [String] fragment
-        #   The fragment of text to search for within the names of models.
-        #
-        # @return [Array<Model>]
-        #   The found models.
-        #
-        # @example
-        #   Exploit.named 'ProFTP'
-        #
-        # @api public
-        #
-        def named(fragment)
-          all(:name.like => "%#{fragment}%")
-        end
-      end
-
-      #
-      # Instance methods that are added when {HasName} is included into a
-      # model.
-      #
-      module InstanceMethods
-        #
-        # Converts the named resource into a String.
-        #
-        # @return [String]
-        #   The name of the resource.
-        #
-        # @since 1.0.0
-        #
-        # @api public
-        #
-        def to_s
-          self.name.to_s
-        end
-      end
-    end
-  end
-end

data/lib/ronin/model/has_title.rb

@@ -1,71 +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
-  module Model
-    #
-    # Adds a `title` property to a model.
-    #
-    module HasTitle
-      #
-      # Adds the `title` property and {ClassMethods} to the model.
-      #
-      # @param [Class] base
-      #   The model.
-      #
-      # @api semipublic
-      #
-      def self.included(base)
-        base.send :include, Model
-        base.send :extend, ClassMethods
-
-        base.module_eval do
-          # The title of the model
-          property :title, String
-        end
-      end
-
-      #
-      # Class methods that are added when {HasTitle} are included into a
-      # model.
-      #
-      module ClassMethods
-        #
-        # Finds models with titles containing a given fragment of text.
-        #
-        # @param [String] fragment
-        #   The fragment of text to match titles with.
-        #
-        # @return [Array<Model>]
-        #   The found models.
-        #
-        # @example
-        #   Vuln.titled 'bypass'
-        #
-        # @api public
-        #
-        def titled(fragment)
-          all(:title.like => "%#{fragment}%")
-        end
-      end
-    end
-  end
-end