ronin 1.1.0 → 1.2.0

data/lib/ronin/class_methods.rb

@@ -1,49 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  #
-  # Class methods that are included when {Ronin} is included.
-  #
-  module ClassMethods
-    #
-    # Catches missing constants and searches the {Ronin} namespace.
-    #
-    # @param [Symbol] name
-    #   The constant name.
-    #
-    # @return [Object]
-    #   The found constant.
-    #
-    # @raise [NameError]
-    #   The constant could not be found within {Ronin}.
-    #
-    # @since 1.0.0
-    #
-    # @api semipublic
-    #
-    def const_missing(name)
-      begin
-        Ronin.send(:const_missing,name)
-      rescue NameError
-        super(name)
-      end
-    end
-  end
-end

data/lib/ronin/model/class_methods.rb

@@ -1,58 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/support/inflector'
-
-module Ronin
-  module Model
-    #
-    # Class methods that are added when {Model} is included into a class.
-    #
-    module ClassMethods
-      #
-      # The default name to use when defining relationships with the
-      # model.
-      #
-      # @return [Symbol]
-      #   The name to use in relationships.
-      #
-      # @since 1.0.0
-      #
-      # @api semipublic
-      #
-      def relationship_name
-        name = Support::Inflector.underscore(self.name.split('::').last)
-
-        return Support::Inflector.pluralize(name).to_sym
-      end
-
-      #
-      # Loads and initialize the resources.
-      #
-      # @api private
-      #
-      def load(records,query)
-        resources = super(records,query)
-        resources.each { |resource| resource.send :initialize }
-
-        return resources
-      end
-    end
-  end
-end

data/lib/ronin/model/has_authors/class_methods.rb

@@ -1,60 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  module Model
-    module HasAuthors
-      #
-      # 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
-    end
-  end
-end

data/lib/ronin/model/has_authors/has_authors.rb

@@ -1,70 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/model/has_authors/class_methods'
-require 'ronin/model/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
-        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
-
-      #
-      # 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

data/lib/ronin/model/has_description/class_methods.rb

@@ -1,49 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  module Model
-    module HasDescription
-      #
-      # 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_description/has_description.rb

@@ -1,49 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/model/has_description/class_methods'
-require 'ronin/model/types/description'
-require 'ronin/model/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
-    end
-  end
-end

data/lib/ronin/model/has_license/class_methods.rb

@@ -1,68 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  module Model
-    module HasLicense
-      #
-      # 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, String] 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)
-          query = case license
-                  when License
-                    {:license => license}
-                  when Symbol
-                    {:license => License.predefined_resource(license)}
-                  else
-                    {'license.name' => license.to_s}
-                  end
-
-          all(query)
-        end
-      end
-    end
-  end
-end

data/lib/ronin/model/has_license/has_license.rb

@@ -1,71 +0,0 @@
-#
-# Copyright (c) 2006-2011 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 <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/model/has_license/class_methods'
-require 'ronin/model/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
-        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
-
-      #
-      # 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
-      #   license! :mit
-      #
-      # @since 1.0.0
-      #
-      # @api public
-      #
-      def license!(name)
-        self.license = Ronin::License.predefined_resource(name)
-      end
-    end
-  end
-end