reddy 0.1.0

data/HACKNOTES

@@ -0,0 +1,2 @@
+AboutEachPrefix:
+if we actually wanted to handle aboutEachPrefix attributes (we should get confirmation as to how often they are used), then the approach to doing so would be pretty simple - put them in a temporary array, then when processing a file has *finished* apply them all.

data/History.txt

@@ -0,0 +1,3 @@
+=== 0.1.0 / 2008-12-02
+
+* First public alpha. RDF/XML parsing works but is not fully spec or test compliant. There is much work to be done.

data/Manifest.txt

@@ -0,0 +1,80 @@
+HACKNOTES
+History.txt
+lib
+lib/reddy
+lib/reddy/libxml_hacks.rb
+lib/reddy/rexml_hacks.rb
+lib/reddy/n3_grammar.treetop
+lib/reddy/uriref.rb
+lib/reddy/rdfxmlparser.rb
+lib/reddy/n3parser.rb
+lib/reddy/exceptions
+lib/reddy/exceptions/about_each_exception.rb
+lib/reddy/exceptions/uri_relative_exception.rb
+lib/reddy/namespace.rb
+lib/reddy/graph.rb
+lib/reddy/bnode.rb
+lib/reddy/triple.rb
+lib/reddy/rdfaparser.rb
+lib/reddy/literal.rb
+lib/reddy.rb
+Manifest.txt
+Rakefile
+README.rdoc
+README.txt
+reddy.gemspec
+spec
+spec/uriref_spec.rb
+spec/rdfa_parser_spec.rb
+spec/n3parser_spec.rb
+spec/graph_spec.rb
+spec/literal_spec.rb
+spec/bnode_spec.rb
+spec/triple_spec.rb
+spec/parser_spec.rb
+spec/rexml_hacks_spec.rb
+spec/namespaces_spec.rb
+tasks
+test
+test/xml.rdf
+test/n3_tests
+test/n3_tests/misc
+test/n3_tests/misc/on_now-01.nt
+test/n3_tests/misc/on_now-01.n3
+test/n3_tests/n3p
+test/n3_tests/n3p/simple-07.nt
+test/n3_tests/n3p/simple-05.n3
+test/n3_tests/n3p/simple-06.n3
+test/n3_tests/n3p/simple-07.n3
+test/n3_tests/n3p/simple-06.nt
+test/n3_tests/n3p/simple-02.nt
+test/n3_tests/n3p/simple-04.nt
+test/n3_tests/n3p/simple-02.n3
+test/n3_tests/n3p/simple-03.nt
+test/n3_tests/n3p/simple-01.nt
+test/n3_tests/n3p/simple-01.n3
+test/n3_tests/n3p/simple-04.n3
+test/n3_tests/n3p/simple-03.n3
+test/n3_tests/n3p/simple-05.nt
+test/n3_tests/lcsh
+test/n3_tests/lcsh/sh85082139.nt
+test/n3_tests/lcsh/sh85118553.nt
+test/n3_tests/lcsh/sh85118553.n3
+test/n3_tests/lcsh/sh85062913.n3
+test/n3_tests/lcsh/sh85082139.n3
+test/n3_tests/lcsh/sh85062913.nt
+test/perf_test
+test/perf_test/tommorris.rdf
+test/perf_test/test.rb
+test/rdf_tests
+test/rdf_tests/xml-literal-mixed.rdf
+test/rdf_tests/xml-literal-mixed.nt
+test/rdf_tests/tm_001.nt
+test/rdf_tests/cc197bad-dc9c-440d-a5b5-d52ba2e14234.rdf
+test/rdf_tests/tm_001.rdf
+test/rdf_tests/cc197bad-dc9c-440d-a5b5-d52ba2e14234.nt
+test/test_helper.rb
+test/test_uris.rb
+test/test_reddy.rb
+test/longtests_spec.rb
+test/ruby_fundamentals.spec.rb

data/README.rdoc

@@ -0,0 +1,48 @@
+= reddy
+
+* FIX (url)
+
+== DESCRIPTION:
+
+FIX (describe your package)
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+  FIX (code sample of usage)
+
+== REQUIREMENTS:
+
+* FIX (list of requirements)
+
+== INSTALL:
+
+* FIX (sudo gem install, anything else)
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIXME full name
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.txt

@@ -0,0 +1,62 @@
+= reddy
+
+* http://github.com/tommorris/reddy
+
+== DESCRIPTION:
+
+Reddy is an RDF library for Ruby.
+
+== FEATURES/PROBLEMS:
+
+* RDF/XML parser is beginning to parse tests.
+* N3 parser
+* Working on an RDFa parser - for now, please use a web service (etc.) to process
+* No serializer except N-Triples
+
+== SYNOPSIS:
+
+A simple RDF library for Ruby has been necessary for some time.
+
+== REQUIREMENTS:
+
+* Addressable
+* Treetop
+* Whatlanguage
+* libxml-ruby
+* facets
+
+== INSTALL:
+
+* (sudo gem install reddy)
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Tom Morris and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.
+
+== FEEDBACK
+
+* tom@tommorris.org
+* github.com/tommorris/reddy
+* tommorris.lighthouseapp.com for bug reports
+* public-rdf-ruby mailing list on w3.org

data/Rakefile

@@ -0,0 +1,67 @@
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require 'spec/rake/spectask'
+require File.dirname(__FILE__) + '/lib/reddy'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('reddy', Reddy::VERSION) do |p|
+  p.developer('Tom Morris', 'tom@tommorris.org')
+  p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.rubyforge_name       = p.name # TODO this is default value
+  p.extra_deps		 = [
+      ['addressable', '>= 2.0.0'],
+      ['treetop', '>= 1.2.4'],
+      ['libxml-ruby', '>= 0.8.3'],
+      ['whatlanguage', '>= 1.0.0']
+  ]
+  p.extra_dev_deps = [
+      ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+  
+  p.clean_globs |= %w[**/.DS_Store .git tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+#task :default => [:spec, :features]
+
+desc "Pushes to git"
+task :push do
+  sh "git push --all"
+  sh "growlnotify -m \"Updates pushed\" \"Git\""
+end
+
+task :spec do
+  sh "spec --colour spec"
+end
+
+desc "Turns spec results into HTML and publish to web (Tom only!)"
+task :spec_html do
+  sh "spec --format html:reddy_new_spec.html spec"
+  sh "scp reddy_new_spec.html bbcityco@bbcity.co.uk:www/tom/files/rena_new_spec.html"
+  sh "rm reddy_new_spec.html"
+end
+
+desc "Turns spec results into local HTML"
+task :spec_local do
+  sh "spec --format html:reddy_new_spec.html spec/"
+#  sh "open reddy_new_spec.html"
+end
+
+desc "Run specs through RCov"
+Spec::Rake::SpecTask.new('coverage') do |t|
+  t.spec_files = FileList['spec']
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'spec,test,\/Library\/Ruby\/Gems\/1.8\/gems']
+end
+
+desc "Runs specs on JRuby"
+task :jspec do
+  sh "jruby -S `whereis spec` --colour spec"
+end
+# vim: syntax=Ruby

data/lib/reddy.rb

@@ -0,0 +1,8 @@
+#$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+$:.unshift(File.dirname('reddy'))
+Dir.glob(File.join(File.dirname(__FILE__), 'reddy/**.rb')).each { |f| require f }
+
+module Reddy
+  VERSION = '0.1.0'
+end

data/lib/reddy/bnode.rb

@@ -0,0 +1,70 @@
+module Reddy
+  class BNode
+    attr_accessor :identifier
+    def initialize(identifier = nil)
+      if identifier != nil && self.valid_id?(identifier) != false
+        @identifier = identifier
+      else
+        @identifier = "bn" + self.hash.to_i.abs.to_s
+	# perhaps this needs to be slightly cleverer - check whether it's negative, and if it is, append an extra bit on the end aaaaaas distinction. TODO
+      end
+    end
+
+    def eql? (other)
+      other.is_a?(self.class) && other.identifier == self.identifier
+    end
+
+    alias_method :==, :eql?
+
+    ## 
+    # Exports the BNode in N-Triples form.
+    #
+    # ==== Example
+    #   b = BNode.new; b.to_n3  # => returns a string of the BNode in n3 form
+    #
+    # ==== Returns
+    # @return [String] The BNode in n3.
+    #
+    # @author Tom Morris
+
+    def to_n3
+      "_:" + @identifier
+    end
+
+
+    ## 
+    # Exports the BNode in N-Triples form.
+    #
+    # ==== Example
+    #   b = BNode.new; b.to_ntriples  # => returns a string of the BNode in N-Triples form
+    #
+    # ==== Returns
+    # @return [String] The BNode in N-Triples.
+    #
+    # @author Tom Morris
+
+    def to_ntriples
+      self.to_n3
+    end
+
+    ##
+    # Returns the identifier as a string.
+    # 
+    # === Returns
+    # @return [String] Blank node identifier.
+    #
+    # @author Tom Morris
+    def to_s
+      @identifier
+    end  
+
+    protected
+    def valid_id? name
+      if name =~ /^[a-zA-Z_][a-zA-Z0-9]*$/
+        true
+      else
+        false
+      end
+    end
+  end
+end

data/lib/reddy/exceptions/about_each_exception.rb

@@ -0,0 +1,2 @@
+class AboutEachException
+end

data/lib/reddy/exceptions/uri_relative_exception.rb

@@ -0,0 +1,2 @@
+class UriRelativeException < RuntimeError
+end

data/lib/reddy/graph.rb

@@ -0,0 +1,182 @@
+require 'open-uri'
+
+module Reddy
+  class Graph
+    attr_accessor :triples, :nsbinding
+
+    def initialize
+      @triples = []
+      @nsbinding = {}
+    end
+    
+    def self.load (uri)
+      RdfXmlParser.new(open(uri)).graph
+    end
+
+    def size
+      @triples.size
+    end
+
+    def each
+      @triples.each { |value| yield value }
+    end
+    
+    def [] (item)
+      @triples[item]
+    end
+
+    def each_with_subject(subject)
+      @triples.each do |value|
+        yield value if value.subject == subject
+      end
+    end
+
+    def get_resource(subject)
+      @triples.find_all { |i| true if i.subject == subject}
+    end
+
+    ## 
+    # Adds a triple to a graph directly from the intended subject, predicate, and object.
+    #
+    # ==== Example
+    #   g = Graph.new; g.add_triple(BNode.new, URIRef.new("http://xmlns.com/foaf/0.1/knows"), BNode.new) # => results in the triple being added to g; returns an array of g's triples
+    #
+    # @param [URIRef, BNode] s the subject of the triple
+    # @param [URIRef] p the predicate of the triple
+    # @param [URIRef, BNode, Literal, TypedLiteral] o the object of the triple
+    #
+    # ==== Returns
+    # @return [Array] An array of the triples (leaky abstraction? consider returning the graph instead)
+    #
+    # @raise [Error] Checks parameter types and raises if they are incorrect.
+    # @author Tom Morris
+
+    def add_triple(s, p, o)
+      @triples += [ Triple.new(s, p, o) ]
+    end
+
+    ## 
+    # Adds an extant triple to a graph
+    #
+    # ==== Example
+    #   g = Graph.new; t = Triple.new(BNode.new, URIRef.new("http://xmlns.com/foaf/0.1/knows"), BNode.new); g << t) # => results in the triple being added to g; returns an array of g's triples
+    #
+    # @param [Triple] t the triple to be added to the graph
+    #
+    # ==== Returns
+    # @return [Array] An array of the triples (leaky abstraction? consider returning the graph instead)
+    #
+    # @author Tom Morris
+
+
+    def << (triple)
+  #    self.add_triple(s, p, o)
+      @triples += [ triple ]
+    end
+
+    ## 
+    # Exports the graph to RDF in N-Triples form.
+    #
+    # ==== Example
+    #   g = Graph.new; g.add_triple(BNode.new, URIRef.new("http://xmlns.com/foaf/0.1/knows"), BNode.new); g.to_ntriples  # => returns a string of the graph in N-Triples form
+    #
+    # ==== Returns
+    # @return [String] The graph in N-Triples.
+    #
+    # @author Tom Morris
+
+    def to_ntriples
+      @triples.collect do |t|
+        t.to_ntriples
+      end * "\n" + "\n"
+    end
+
+    ## 
+    # Creates a new namespace given a URI and the short name and binds it to the graph.
+    #
+    # ==== Example
+    #   g = Graph.new; g.namespace("http://xmlns.com/foaf/0.1/", "foaf") # => binds the Foaf namespace to g
+    #
+    # @param [String] uri the URI of the namespace
+    # @param [String] short the short name of the namespace
+    #
+    # ==== Returns
+    # @return [Namespace] The newly created namespace.
+    #
+    # @raise [Error] Checks validity of the desired shortname and raises if it is incorrect.
+    # @raise [Error] Checks that the newly created Namespace is of type Namespace and raises if it is incorrect.
+    # @author Tom Morris
+
+    def namespace(uri, short)
+      self.bind Namespace.new(uri, short)
+    end
+
+    def bind(namespace)
+      if namespace.class == Namespace
+        @nsbinding["#{namespace.short}"] = namespace
+      else
+        raise
+      end
+    end
+
+    def has_bnode_identifier?(bnodeid)
+      temp_bnode = BNode.new(bnodeid)
+      returnval = false
+      @triples.each { |triple|
+        if triple.subject.eql?(temp_bnode)
+          returnval = true
+          break
+        end
+        if triple.object.eql?(temp_bnode)
+          returnval = true
+          break
+        end
+      }
+      return returnval
+    end
+
+    def get_bnode_by_identifier(bnodeid)
+      temp_bnode = BNode.new(bnodeid)
+      each do |triple|
+        if triple.subject == temp_bnode
+          return triple.subject
+        end
+        if triple.object == temp_bnode
+          return triple.object
+        end
+      end
+      return false
+    end
+    
+    def get_by_type(object)
+      out = []
+      each do |t|
+        next unless t.is_type?
+        next unless case object
+                    when String
+                      object == t.object.to_s
+                    when Regexp
+                      object.match(t.object.to_s)
+                    else
+                      object == t.object
+                    end
+        out << t.subject
+      end
+      return out
+    end
+    
+    def join(graph)
+      if graph.class == Graph
+        graph.each { |t| 
+          self << t
+        }
+      else
+        raise "join requires you provide a graph object"
+      end
+    end
+  #  alias :add, :add_triple
+    #  alias (=+, add_triple)
+    private
+
+  end
+end