active-triples 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e1dcbe5917c46ab351078d1c6e7b2be54d66c68f
+  data.tar.gz: 5cc8dfc6dfbba4a833566f568d395a15ba79c535
+SHA512:
+  metadata.gz: 17d3134eb50d437947dada9a3eadd4b298968c2fef571e25796de38f4b6de48b3eef9935fcfd9c0a5cd9089570ddd4f4fdcd40a9e1a499d5521026e1d8de020b
+  data.tar.gz: 6beee86d363f0791be42dbd5507a6dad99fa3e7ceb2beedacd39d704ee63ade58dba85fec512d0f5d25fdbf60088844b7aaeb9b3917a70ef697d020193782c9f

data/.gitignore

@@ -0,0 +1,6 @@
+.bundle/
+log/*.log
+pkg/
+Gemfile.lock
+tmp/*
+.sass-cache

data/.travis.yml

@@ -0,0 +1,12 @@
+anguage: ruby
+bundler_args: --without debug
+script: "bundle exec rspec spec"
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+  - 2.1.1
+  - jruby-19mode
+matrix:
+  allow_failures:
+      - rvm: jruby-19mode

data/AUTHORS

@@ -0,0 +1,2 @@
+Tom Johnson (thomas.johnson@oregonstate.edu)
+Trey Terrell

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org/>

data/README.md

@@ -0,0 +1,38 @@
+ActiveTriples
+==============
+
+[![Build Status](https://travis-ci.org/no-reply/ActiveTriples.png?branch=master)](https://travis-ci.org/no-reply/ActiveTriples)
+
+Modeling RDF graphs in Ruby.
+
+How to Use
+-----------
+
+```ruby
+class Thing < ActiveTriples::Resource
+  configure :type => RDF::OWL.Thing, :base_uri => 'http://example.org/things#'
+  property :title, :predicate => RDF::DC.title
+  property :description, :predicate => RDF::DC.description
+  property :creator, :predicate => RDF::DC.creator, :class_name => 'Person'
+end
+
+obj = Thing.new('123')
+obj.title = 'Resource'
+obj.description = 'A resource in an RDF graph.'
+
+obj.dump :ntriples
+# => "<http://example.org/things#123> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#Thing> .\n<http://example.org/things#123> <http://purl.org/dc/terms/title> \"Resource\" .\n<http://example.org/things#123> <http://purl.org/dc/terms/description> \"A resource in an RDF graph.\" .\n"
+
+class Person < ActiveTriples::Resource
+  configure :type => RDF::FOAF.Person, :base_uri => 'http://example.org/people#'
+  property :name, :predicate => RDF::FOAF.name
+end
+
+obj.creator = Person.new
+obj.creator
+# => [#<Person:0x3fbe84ac9234(default)>]
+
+obj.creator.first.name = 'Herman Melville'
+obj.dump :ntriples
+# => "<http://example.org/things#123> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#Thing> .\n<http://example.org/things#123> <http://purl.org/dc/terms/title> \"Resource\" .\n<http://example.org/things#123> <http://purl.org/dc/terms/description> \"A resource in an RDF graph.\" .\n<http://example.org/things#123> <http://purl.org/dc/terms/creator> _:g70087502237940 .\n_:g70087502237940 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .\n"
+```

data/active-triples.gemspec

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "active_triples/version"
+
+Gem::Specification.new do |s|
+  s.name        = "active-triples"
+  s.version     = ActiveTriples::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Tom Johnson", "Trey Terrell"]
+  s.homepage    = 'https://github.com/no-reply/ActiveTriples'
+  s.email       = 'thomas.johnson@oregonstate.edu'  
+  s.summary     = %q{RDF graphs in ActiveModel wrappers.}
+  s.description = %q{ActiveTriples provides tools for modeling RDF as discrete resources.}
+  s.license     = "Public Domain"
+  s.required_ruby_version     = '>= 1.9.3'
+  
+  s.add_dependency('rdf', '~> 1.1')
+  s.add_dependency('linkeddata', '~> 1.1')
+  s.add_dependency('activemodel')
+  s.add_dependency('deprecation', '~> 0.1')
+  s.add_dependency('activesupport')
+
+  s.add_development_dependency('rdoc')
+  s.add_development_dependency('rspec')
+  s.add_development_dependency('webmock')
+  s.add_development_dependency('nokogiri')
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+end

data/lib/active_triples.rb

@@ -0,0 +1,29 @@
+require 'rdf'
+require 'active_triples/version'
+
+module ActiveTriples
+  autoload :Resource,         'active_triples/resource'
+  autoload :List,             'active_triples/list'
+  autoload :Term,             'active_triples/term'  
+  autoload :Indexing,         'active_triples/indexing'
+  autoload :Configurable,     'active_triples/configurable'
+  autoload :Properties,       'active_triples/properties'
+  autoload :Repositories,     'active_triples/repositories'
+  autoload :NodeConfig,       'active_triples/node_config'  
+  autoload :NestedAttributes, 'active_triples/nested_attributes'
+
+  def self.class_from_string(class_name, container_class=Kernel)
+    container_class = container_class.name if container_class.is_a? Module
+    container_parts = container_class.split('::')
+    (container_parts + class_name.split('::')).flatten.inject(Kernel) do |mod, class_name|
+      if mod == Kernel
+        Object.const_get(class_name)
+      elsif mod.const_defined? class_name.to_sym
+        mod.const_get(class_name)
+      else
+        container_parts.pop
+        class_from_string(class_name, container_parts.join('::'))
+      end
+    end
+  end
+end

data/lib/active_triples/configurable.rb

@@ -0,0 +1,61 @@
+require 'deprecation'
+
+module ActiveTriples
+  ##
+  # Module to include configurable class-wide properties common to
+  # Resource and RDFDatastream. It does its work at the class level,
+  # and is meant to be extended.
+  #
+  # Define properties at the class level with:
+  #
+  #    configure base_uri: "http://oregondigital.org/resource/", repository: :parent
+  # Available properties are base_uri, rdf_label, type, and repository
+  module Configurable
+    extend Deprecation
+
+    def base_uri
+      nil
+    end
+
+    def rdf_label
+      nil
+    end
+
+    def type
+      nil
+    end
+
+    def rdf_type(value)
+      Deprecation.warn Configurable, "rdf_type is deprecated and will be removed in active-fedora 8.0.0. Use configure type: instead.", caller
+      configure type: value
+    end
+
+    def repository
+      :parent
+    end
+
+    # API method for configuring class properties an RDF Resource may need.
+    # This is an alternative to overriding the methods extended with this module.
+    def configure(options = {})
+      {
+        base_uri: options[:base_uri],
+        rdf_label: options[:rdf_label],
+        type: options[:type],
+        repository: options[:repository]
+      }.each do |name, value|
+        if value
+          value = self.send("transform_#{name}", value) if self.respond_to?("transform_#{name}")
+          define_singleton_method(name) do
+            value
+          end
+        end
+      end
+    end
+
+    def transform_type(value)
+      RDF::URI.new(value).tap do |value|
+        Resource.type_registry[value] = self
+      end
+    end
+  end
+end

data/lib/active_triples/indexing.rb

@@ -0,0 +1,76 @@
+module ActiveFedora
+  module Rdf
+    module Indexing
+      extend Deprecation
+      extend ActiveSupport::Concern
+
+      # In active_fedora 8, we can get the prefix part from Datastream.prefix
+      def apply_prefix(name)
+        "#{dsid.underscore}__#{name}"
+      end
+
+      def prefix(name)
+        Deprecation.warn Indexing, "prefix is deprecated. Use apply_prefix instead. In active-fedora 8, the prefix method will just return the prefix to be applied, and will not do the applying.  This will enable conformity between OmDatastream and RdfDatastream"
+        apply_prefix(name)
+      end
+
+      def to_solr(solr_doc = Hash.new) # :nodoc:
+        fields.each do |field_key, field_info|
+          values = resource.get_values(field_key)
+          Array(values).each do |val|
+            if val.kind_of? RDF::URI
+              val = val.to_s 
+            elsif val.kind_of? Rdf::Resource
+              val = val.solrize
+            end
+            self.class.create_and_insert_terms(apply_prefix(field_key), val, field_info[:behaviors], solr_doc)
+          end
+        end
+        solr_doc
+      end
+
+      # Gives the primary solr name for a column. If there is more than one indexer on the field definition, it gives the first 
+      def primary_solr_name(field)
+        config = self.class.config_for_term_or_uri(field)
+        return nil unless config # punt on index names for deep nodes!
+        if behaviors = config.behaviors
+          behaviors.each do |behavior|
+            result = ActiveFedora::SolrService.solr_name(apply_prefix(field), behavior, type: config.type)
+            return result if Solrizer::DefaultDescriptors.send(behavior).evaluate_suffix(:text).stored?
+          end
+          raise RuntimeError "no stored fields were found"
+        end
+      end
+
+      module ClassMethods
+        def prefix(dsid, name)
+          Deprecation.warn Indexing, "prefix is deprecated and will be removed in active-fedora 8.0.0.", caller
+          "#{dsid.underscore}__#{name}".to_sym
+        end
+
+        # Gives the datatype for a column.
+        def type(field)
+          config_for_term_or_uri(field).type
+        end
+      end
+      
+      private
+        # returns a Hash, e.g.: {field => {:values => [], :type => :something, :behaviors => []}, ...}
+        def fields
+          field_map = {}.with_indifferent_access
+
+          self.class.properties.each do |name, config|
+            type = config[:type]
+            behaviors = config[:behaviors]
+            next unless type and behaviors
+            next if config[:class_name] && config[:class_name] < ActiveFedora::Base
+            resource.query(:subject => rdf_subject, :predicate => config[:predicate]).each_statement do |statement|
+              field_map[name] ||= {:values => [], :type => type, :behaviors => behaviors}
+              field_map[name][:values] << statement.object.to_s
+            end
+          end
+          field_map
+        end
+    end
+  end
+end

data/lib/active_triples/list.rb

@@ -0,0 +1,155 @@
+module ActiveTriples
+  ##
+  # An implementation of RDF::List intregrated with ActiveTriples.
+  #
+  # A thoughtful reflection period is encouraged before using the
+  # rdf:List concept in your data. The community may pursue other
+  # options for ordered sets.
+  class List < RDF::List
+    include ActiveTriples::NestedAttributes
+    extend Configurable
+    extend Properties
+
+    delegate :rdf_subject, :mark_for_destruction, :marked_for_destruction?, :set_value, :get_values, :parent, :dump, :attributes=, to: :resource
+    alias_method :to_ary, :to_a
+
+    class << self
+      def from_uri(uri, vals)
+        list = ListResource.from_uri(uri, vals)
+        self.new(list.rdf_subject, list)
+      end
+    end
+
+    def resource
+      graph
+    end
+
+    def initialize(*args)
+      super
+      parent = graph.parent if graph.respond_to? :parent
+      @graph = ListResource.new(subject) << graph unless graph.kind_of? Resource
+      graph << parent if parent
+      graph.list = self
+      graph.singleton_class.properties = self.class.properties
+      graph.singleton_class.properties.keys.each do |property|
+        graph.singleton_class.send(:register_property, property)
+      end
+      graph.insert RDF::Statement.new(subject, RDF.type, RDF.List)
+      graph.reload
+    end
+
+    def []=(idx, value)
+      raise IndexError "index #{idx} too small for array: minimum 0" if idx < 0
+
+      if idx >= length
+        (idx - length).times do
+          self << RDF::OWL.Nothing
+        end
+        return self << value
+      end
+      each_subject.with_index do |v, i|
+        next unless i == idx
+        resource.set_value(v, RDF.first, value)
+      end
+    end
+
+    ##
+    # Override to return AF::Rdf::Resources as values, where
+    # appropriate.
+    def each(&block)
+      return super unless block_given?
+
+      super do |value|
+        block.call(node_from_value(value))
+      end
+    end
+
+    ##
+    # Do these like #each.
+    def first
+      node_from_value(super)
+    end
+
+    def shift
+      node_from_value(super)
+    end
+
+    ##
+    # Find an AF::Rdf::Resource from the value returned by RDF::List
+    def node_from_value(value)
+      if value.kind_of? RDF::Resource
+        type_uri = resource.query([value, RDF.type, nil]).to_a.first.try(:object)
+        klass = ActiveTriples::Resource.type_registry[type_uri]
+        klass ||= Resource
+        return klass.from_uri(value,resource)
+      end
+      value
+    end
+
+    ##
+    # This class is the graph/Resource that backs the List and
+    # supplies integration with the rest of ActiveTriples
+    class ListResource < Resource
+      attr_reader :list
+
+      def list=(list)
+        @list ||= list
+      end
+
+      def attributes=(values)
+        raise ArgumentError, "values must be a Hash, you provided #{values.class}" unless values.kind_of? Hash
+        values.with_indifferent_access.each do |key, value|
+          if self.singleton_class.properties.keys.map{ |k| "#{k}_attributes"}.include?(key)
+            klass = properties[key[0..-12]]['class_name']
+            klass = ActiveTriples.class_from_string(klass, final_parent.class) if klass.is_a? String
+            value.is_a?(Hash) ? attributes_hash_to_list(values[key], klass) : attributes_to_list(value, klass)
+            values.delete key
+          end
+        end
+        persist!
+        super
+      end
+
+      private
+        def attributes_to_list(value, klass)
+          value.each do |entry|
+            item = klass.new()
+            item.attributes = entry
+            list << item
+          end
+        end
+
+        def attributes_hash_to_list(value, klass)
+          value.each do |counter, attr|
+            item = klass.new()
+            item.attributes = attr if attr
+            list[counter.to_i] = item
+          end
+        end
+    end
+
+    ##
+    # Monkey patch to allow lists to have subject URIs.
+    # Overrides RDF::List to prevent URI subjects
+    # from being replaced with nodes.
+    #
+    # @NOTE Lists built this way will return false for #valid?
+    def <<(value)
+      value = case value
+        when nil         then RDF.nil
+        when RDF::Value  then value
+        when Array       then RDF::List.new(nil, graph, value)
+        else value
+      end
+
+      if empty?
+        resource.set_value(RDF.first, value)
+        resource.insert([subject, RDF.rest, RDF.nil])
+        resource << value if value.kind_of? Resource
+        return self
+      end
+      super
+      resource << value if value.kind_of? Resource
+    end
+  end
+end