gearbox 0.1.0 → 0.1.10

data/Gemfile

@@ -1,8 +1,10 @@
 source 'http://rubygems.org'
 
 gem 'linkeddata'
-gem 'rspec'
-gem 'uuid'
+gem 'sparql'
+gem 'equivalent-xml'
+gem 'activemodel'
+gem "pry"
 
 if RUBY_PLATFORM =~ /darwin/i
   gem 'autotest-fsevent'
@@ -18,4 +20,4 @@ group :development do
   gem 'guard-markdown'
   gem "ruby-debug19"
   gem 'guard-minitest', :git => 'git://github.com/aspiers/guard-minitest.git'
-end
+end

data/Rakefile

@@ -21,6 +21,7 @@ Jeweler::Tasks.new do |gem|
   gem.description = %Q{A SPARQL-driven modeling toolset for semantic models.}
   gem.email = "davidlamontrichards@gmail.com"
   gem.authors = ["David Richards"]
+  gem.executables = %w(gearbox)
   # dependencies defined in Gemfile
 end
 Jeweler::RubygemsDotOrgTasks.new

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.10

data/bin/gearbox

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby -wKU
+require 'yaml'
+
+version = File.read(File.join(File.dirname(__FILE__), %w(.. VERSION)))
+gearbox = File.join(File.dirname(__FILE__), %w(.. lib gearbox))
+utilities = File.join(File.dirname(__FILE__), %w(.. lib pry_utilities))
+libs =  " -r #{gearbox} -r #{utilities}"
+puts "Loading Gearbox version: #{version}"
+exec "pry #{libs}"

data/gearbox.gemspec

@@ -0,0 +1,134 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "gearbox"
+  s.version = "0.1.10"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["David Richards"]
+  s.date = "2012-04-03"
+  s.description = "A SPARQL-driven modeling toolset for semantic models."
+  s.email = "davidlamontrichards@gmail.com"
+  s.executables = ["gearbox"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.html",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.html",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bin/gearbox",
+    "gearbox.gemspec",
+    "lib/gearbox.rb",
+    "lib/gearbox/attribute.rb",
+    "lib/gearbox/attribute_collection.rb",
+    "lib/gearbox/mixins/active_model_implementation.rb",
+    "lib/gearbox/mixins/ad_hoc_properties.rb",
+    "lib/gearbox/mixins/resource.rb",
+    "lib/gearbox/mixins/semantic_accessors.rb",
+    "lib/gearbox/mixins/subject_methods.rb",
+    "lib/gearbox/rdf_collection.rb",
+    "lib/gearbox/type.rb",
+    "lib/gearbox/types.rb",
+    "lib/gearbox/types/any.rb",
+    "lib/gearbox/types/boolean.rb",
+    "lib/gearbox/types/date.rb",
+    "lib/gearbox/types/decimal.rb",
+    "lib/gearbox/types/float.rb",
+    "lib/gearbox/types/integer.rb",
+    "lib/gearbox/types/native.rb",
+    "lib/gearbox/types/string.rb",
+    "lib/gearbox/types/uri.rb",
+    "lib/gearbox/vocabulary.rb",
+    "lib/pry_utilities.rb",
+    "scratch/4s.rb",
+    "scratch/DEVELOPMENT_NOTES.md",
+    "scratch/actionable.md",
+    "scratch/ccrdf.html-rdfa.nq",
+    "scratch/foo.rb",
+    "scratch/index.rdf",
+    "scratch/j2.rb",
+    "scratch/junk.rb",
+    "scratch/out.rb",
+    "spec/gearbox/attribute_collection_spec.rb",
+    "spec/gearbox/attribute_spec.rb",
+    "spec/gearbox/mixins/active_model_implementation_spec.rb",
+    "spec/gearbox/mixins/ad_hoc_properties_spec.rb",
+    "spec/gearbox/mixins/resource_spec.rb",
+    "spec/gearbox/mixins/semantic_accessors_spec.rb",
+    "spec/gearbox/mixins/subject_methods_spec.rb",
+    "spec/gearbox/rdf_collection_spec.rb",
+    "spec/gearbox_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/davidrichards/gearbox"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.18"
+  s.summary = "Flexible semantic models."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<linkeddata>, [">= 0"])
+      s.add_runtime_dependency(%q<sparql>, [">= 0"])
+      s.add_runtime_dependency(%q<equivalent-xml>, [">= 0"])
+      s.add_runtime_dependency(%q<activemodel>, [">= 0"])
+      s.add_runtime_dependency(%q<pry>, [">= 0"])
+      s.add_runtime_dependency(%q<autotest-fsevent>, [">= 0"])
+      s.add_runtime_dependency(%q<autotest-growl>, [">= 0"])
+      s.add_development_dependency(%q<minitest>, [">= 0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<guard-markdown>, [">= 0"])
+      s.add_development_dependency(%q<ruby-debug19>, [">= 0"])
+      s.add_development_dependency(%q<guard-minitest>, [">= 0"])
+    else
+      s.add_dependency(%q<linkeddata>, [">= 0"])
+      s.add_dependency(%q<sparql>, [">= 0"])
+      s.add_dependency(%q<equivalent-xml>, [">= 0"])
+      s.add_dependency(%q<activemodel>, [">= 0"])
+      s.add_dependency(%q<pry>, [">= 0"])
+      s.add_dependency(%q<autotest-fsevent>, [">= 0"])
+      s.add_dependency(%q<autotest-growl>, [">= 0"])
+      s.add_dependency(%q<minitest>, [">= 0"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<guard-markdown>, [">= 0"])
+      s.add_dependency(%q<ruby-debug19>, [">= 0"])
+      s.add_dependency(%q<guard-minitest>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<linkeddata>, [">= 0"])
+    s.add_dependency(%q<sparql>, [">= 0"])
+    s.add_dependency(%q<equivalent-xml>, [">= 0"])
+    s.add_dependency(%q<activemodel>, [">= 0"])
+    s.add_dependency(%q<pry>, [">= 0"])
+    s.add_dependency(%q<autotest-fsevent>, [">= 0"])
+    s.add_dependency(%q<autotest-growl>, [">= 0"])
+    s.add_dependency(%q<minitest>, [">= 0"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<guard-markdown>, [">= 0"])
+    s.add_dependency(%q<ruby-debug19>, [">= 0"])
+    s.add_dependency(%q<guard-minitest>, [">= 0"])
+  end
+end
+

data/lib/gearbox.rb

@@ -1,12 +1,112 @@
 # ================
 # = Dependencies =
 # ================
-require 'uuid'
 require 'linkeddata'
 require 'ostruct'
+require 'active_model'
 
 module Gearbox
   
+  # =======================
+  # = Settings from Spira =
+  # =======================
+  ##
+  # The list of repositories available for Gearbox resources
+  #
+  # @see http://rdf.rubyforge.org/RDF/Repository.html
+  # @return [Hash{Symbol => RDF::Repository}]
+  # @private
+  def repositories
+    settings[:repositories] ||= {}
+  end
+  module_function :repositories
+
+  ##
+  # The list of all property types available for Gearbox resources
+  # 
+  # @see Gearbox::Types
+  # @return [Hash{Symbol => Gearbox::Type}]
+  def types
+    settings[:types] ||= {}
+  end
+  module_function :types
+
+  ##
+  # A thread-local hash for storing settings.  Used by Resource classes.
+  #
+  # @see Gearbox::Resource
+  # @see Gearbox.repositories
+  # @see Gearbox.types
+  def settings
+    Thread.current[:gearbox] ||= {}
+  end
+  module_function :settings
+
+  ##
+  # Add a repository to Gearbox's list of repositories.
+  #
+  # @overload add_repository(name, repo)
+  #     @param [Symbol] name The name of this repository
+  #     @param [RDF::Repository] repo An RDF::Repository
+  # @overload add_repository(name, klass, *args)
+  #     @param [Symbol] name The name of this repository
+  #     @param [RDF::Repository, Class] repo A Class that inherits from RDF::Repository
+  #     @param [*Object] The list of arguments to instantiate the class
+  # @example Adding an ntriples file as a repository
+  #     Gearbox.add_repository(:default, RDF::Repository.load('http://datagraph.org/jhacker/foaf.nt'))
+  # @example Adding an empty repository to be instantiated on use
+  #     Gearbox.add_repository(:default, RDF::Repository)
+  # @return [Void]
+  # @see RDF::Repository
+  def add_repository(name, klass, *args)
+    repositories[name] = case klass
+      when Class
+        promise { klass.new(*args) }
+      else
+        klass
+     end
+     if (name == :default) && settings[:repositories][name].nil?
+        warn "WARNING: Adding nil default repository"
+     end
+  end
+  alias_method :add_repository!, :add_repository
+  module_function :add_repository, :add_repository!
+
+  ##
+  # The RDF::Repository for the named repository
+  #
+  # @param [Symbol] name The name of the repository
+  # @return [RDF::Repository]
+  # @see RDF::Repository
+  def repository(name)
+    repositories[name]
+  end
+  module_function :repository
+
+  ##
+  # Clear all repositories from Gearbox's knowledge.  Use it if you want, but
+  # it's really here for testing.
+  #
+  # @return [Void]
+  # @private
+  def clear_repositories!
+    settings[:repositories] = {}
+  end
+  module_function :clear_repositories!
+
+  ##
+  # Alias a property type to another.  This allows a range of options to be
+  # specified for a property type which all reference one Gearbox::Type
+  #
+  # @param [Any] new The new symbol or reference
+  # @param [Any] original The type the new symbol should refer to
+  # @return [Void]
+  # @private
+  def type_alias(new, original)
+    types[new] = original 
+  end
+  module_function :type_alias
+  
   # ========================
   # = Helper Utility: path =
   # ========================
@@ -20,21 +120,40 @@ module Gearbox
   # =======================
   # = Loading the Library =
   # =======================
+  require path('type')
+  require path('types')
+  autoload :Attribute, path('attribute')
   autoload :AttributeCollection, path('attribute_collection')
   autoload :RDFCollection, path('rdf_collection')
 
   autoload :AdHocProperties, path('mixins/ad_hoc_properties')
+  autoload :ActiveModelImplementation, path('mixins/active_model_implementation')
+  autoload :AttributeMethods, path('mixins/attribute_methods')
   autoload :Resource, path('mixins/resource')
   autoload :SemanticAccessors, path('mixins/semantic_accessors')
+  autoload :SubjectMethods, path('mixins/subject_methods')
   
+end
+
+module Example
+  # ========================
+  # = Helper Utility: path =
+  # ========================
+  # @private
+  def path(path)
+    File.expand_path("../examples/#{path}", __FILE__)
+  end
+  private :path
+  module_function :path
+
   # ============
   # = Examples =
   # ============
   
   # Will separate these after things get to a solid 0.1 state.
-  autoload :Audience, path('../examples/audience')
-  autoload :Person, path('../examples/person')
-  autoload :Reference, path('../examples/reference')
-  autoload :Theme, path('../examples/theme')
+  autoload :Audience, path('audience')
+  autoload :Person, path('person')
+  autoload :Reference, path('reference')
+  autoload :Theme, path('theme')
   
 end

data/lib/gearbox/attribute.rb

@@ -0,0 +1,128 @@
+module Gearbox
+
+  class Attribute
+    
+    # Options to figure out: more index options, routing, triple pattern
+    attr_accessor :predicate, :reverse, :index, :name, :repository, :value, :language, :datatype
+    attr_reader :subject_decorator
+    
+    def initialize(opts={})
+      set(opts.delete(:value) || :_value_not_set)
+      assert_defaults
+      extract_from_statement(opts) if opts.has_key?(:statement)
+      assert_options(opts)
+    end
+    
+    def subject_decorator=(value=nil, &block)
+      @subject_decorator = block_given? ? block : value
+    end
+    
+    # TODO: I'm a little quesy about the relationship between the model class, the model, and the attribute.
+    # I'm going to have to rebuild the model DSL and see how this stuff gets built.
+    def subject
+      return nil unless subject_decorator
+      if subject_decorator.respond_to?(:call)
+        subject_decorator.call()
+      elsif respond_to?(subject_decorator)
+        self.send(subject_decorator)
+      else
+        nil
+      end
+    end
+    
+    def to_value
+      # Skipping the serialization steps for a moment.
+      @value
+    end
+    alias :get :to_value
+    
+    def literal(opts={:value => :_value_not_set})
+      value = opts.delete(:value)
+      value = to_value if value == :_value_not_set
+      opts = {:language => self.language, :datatype => self.datatype}.merge(opts)
+      value = case opts[:datatype]
+      when :boolean
+        RDF::Literal::Boolean.new(value)
+      when :date
+        RDF::Literal::Date.new(value)
+      when :date_time
+        RDF::Literal::DateTime.new(value)
+      when :decimal
+        RDF::Literal::Decimal.new(value)
+      when :double
+        RDF::Literal::Double.new(value)
+      when :time
+        RDF::Literal::Time.new(value)
+      when :token
+        RDF::Literal::Token.new(value)
+      when :xml
+        RDF::Literal::XML.new(value)
+      else
+        value
+      end
+        
+      RDF::Literal.new(value, opts)
+    end
+    
+    def set(value=:_value_not_set, opts={})
+      opts = {:value => value}.merge(opts)
+      @value = literal(opts).object
+    end
+
+    def to_rdf(model, opts={})
+      opts[:value] = :_value_not_set unless opts.has_key?(:value)
+      opts = {
+        :reverse => self.reverse, 
+        :predicate => self.predicate, 
+        :value => self.literal(opts)
+      }.merge(opts)
+      
+      subject = self.subject
+      subject ||= model.subject
+      subject = RDF::URI.new(subject)
+      predicate = opts[:predicate]
+      object = opts[:value]
+      
+      return opts[:reverse] ? RDF::Statement(object, predicate, subject)
+                     : RDF::Statement(subject, predicate, object)
+    end
+    
+    private
+    
+      def assert_defaults
+        self.index = false
+        self.reverse = false
+      end
+      
+      def assert_options(opts)
+        opts.each do |accessor, value|
+          send("#{accessor}=", value) if respond_to?("#{accessor}=")
+        end
+      end
+      
+      def extract_from_statement(opts)
+        statement = opts[:statement]
+        object = statement.object
+
+        self.reverse = can_infer_reverse_from_model?(opts[:model], object)
+        object = statement.subject if self.reverse
+
+        self.predicate = statement.predicate
+        self.set extract_from_literal(object)
+      end
+      
+      def extract_from_literal(literal)
+        return literal unless literal.is_a?(RDF::Literal)
+        self.language = literal.language
+        self.datatype = literal.datatype
+        literal.object 
+      end
+      
+      def can_infer_reverse_from_model?(model, object)
+        return false unless model
+        model.subject.to_s == object.to_s
+      end
+  end
+  
+end
+