pius-rena 0.0.1

data/README.txt

@@ -0,0 +1,48 @@
+= rena
+
+* http://github.com/tommorris/rena
+
+== DESCRIPTION:
+
+Rena is an RDF library for Ruby.
+
+== FEATURES/PROBLEMS:
+
+* Features
+
+== SYNOPSIS:
+
+  Synopsis
+
+== REQUIREMENTS:
+
+* Addressable gem
+
+== INSTALL:
+
+* (sudo gem install rena)
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Tom Morris
+
+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/Rakefile

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'rake'
+require 'spec/rake/spectask'
+
+task :default => [:spec]
+
+desc "Install dependencies"
+task :dependencies do
+  require ''
+  gems = ['addressable/uri']
+  gems.each do |g|
+    g2 = g.split('/')[0]
+    begin
+      require g2
+    rescue
+      sh "sudo gem install " + g2
+    end
+  end
+end
+
+desc "Pushes to git"
+task :push do
+  sh "git push --all"
+  sh "growlnotify -m \"Updates pushed\" \"Git\""
+end
+
+desc "Runs specs"
+task :spec do
+  sh "spec --colour --pattern test/spec/*.spec.rb"
+end
+
+desc "Turns spec results into HTML and publish to web (Tom only!)"
+task :spec_html do
+  sh "spec --pattern test/spec/*.spec.rb --format html:rena_new_spec.html"
+  sh "scp rena_new_spec.html bbcityco@bbcity.co.uk:www/tom/files/rena_new_spec.html"
+  sh "rm rena_new_spec.html"
+end
+
+desc "Turns spec results into local HTML"
+task :spec_local do
+  sh "spec --pattern test/spec/*.spec.rb --format html:rena_new_spec.html"
+#  sh "open rena_new_spec.html"
+end
+
+desc "Run specs through RCov"
+Spec::Rake::SpecTask.new('coverage') do |t|
+  t.spec_files = FileList['test/spec/**/*.rb']
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'test,\/Library\/Ruby\/Gems\/1.8\/gems']
+end

data/lib/rena.rb

@@ -0,0 +1,5 @@
+$:.unshift File.dirname(__FILE__)
+Dir.glob(File.join(File.dirname(__FILE__), 'rena/**.rb')).each { |f| require f }
+
+module Rena
+end

data/lib/rena/bnode.rb

@@ -0,0 +1,63 @@
+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_s
+    end
+  end
+  
+  def eql? (eql)
+    if self.identifier == eql.identifier
+      true
+    else
+      false
+    end
+  end
+  
+  ## 
+  # 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
+  
+  def to_s
+    @identifier
+  end  
+  
+  # TODO: add valid bnode name exceptions?
+  protected
+  def valid_id? name
+    if name =~ /^[a-zA-Z_][a-zA-Z0-9]*$/
+      true
+    else
+      false
+    end
+  end
+end

data/lib/rena/exceptions/about_each_exception.rb

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

data/lib/rena/exceptions/uri_relative_exception.rb

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

data/lib/rena/graph.rb

@@ -0,0 +1,150 @@
+require 'rena/namespace'
+require 'rena/bnode'
+require 'rena/uriref'
+require 'rena/literal'
+require 'rena/triple'
+
+class Graph
+  attr_accessor :triples, :nsbinding
+  
+  def initialize
+    @triples = []
+    @nsbinding = {}
+  end
+  
+  def size
+    @triples.size
+  end
+  
+  def each
+    @triples.each { |value| yield value }
+  end
+  
+  def each_with_subject(subject)
+    @triples.each {|value|
+      if value.subject == subject
+        yield value
+      end
+    }
+  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
+    str = ""
+    @triples.each do |t|
+      str << t.to_ntriples + "\n"
+    end
+    return str
+  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)
+    returnval = false
+    @triples.each { |triple|
+      if triple.subject.eql?(temp_bnode)
+        returnval = triple.subject
+        break
+      end
+      if triple.object.eql?(temp_bnode)
+        returnval = triple.object
+        break
+      end
+    }
+    return returnval
+  end
+#  alias :add, :add_triple
+#  alias (=+, add_triple)
+end

data/lib/rena/literal.rb

@@ -0,0 +1,89 @@
+class Literal
+  attr_accessor :contents, :lang
+  def initialize(contents, lang = nil)
+    @contents = contents
+    if lang != nil && lang != false
+      @lang = lang.downcase
+    end
+  end
+  
+  def == (obj)
+    if obj.class == Literal && obj.contents == @contents && (obj.lang == @lang || (obj.lang == nil && @lang == nil))
+      true
+    else
+      false
+    end
+  end
+  
+  def to_n3
+    out = "\"" + @contents + "\""
+    out += "@" + @lang if @lang != nil
+    out += "^^" + @encoding if @encoding != nil
+    return out
+  end
+  
+  def to_ntriples
+    return self.to_n3
+  end
+
+  def to_trix
+    if @lang != nil && @lang != false
+      out = "<plainLiteral xml:lang=\"" + @lang + "\">"
+    else
+      out = "<plainLiteral>"
+    end
+    out += @contents
+    out += "</plainLiteral>"
+    return out
+  end
+  
+end
+
+class TypedLiteral < Literal
+  attr_accessor :contents, :encoding
+  def initialize(contents, encoding)
+    @contents = contents
+    @encoding = encoding
+    if @encoding == "http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral"
+      @xmlliteral = true
+    else
+      @xmlliteral = false
+    end
+  end
+  
+  def == (obj)
+    if obj.class == TypedLiteral && obj.contents == @contents && obj.encoding == @encoding
+      return true
+    else
+      return false
+    end
+  end
+  
+  def to_n3
+    if @encoding == "http://www.w3.org/2001/XMLSchema#int"
+      out = @contents.to_s
+    else
+      out = "\"" + @contents.to_s + "\""
+    end
+    out += "^^<" + @encoding + ">" if @encoding != nil
+    return out
+  end
+  
+  def to_trix
+    "<typedLiteral datatype=\"" + @encoding + "\">" + @contents + "</typedLiteral>"
+  end
+  
+  def xmlliteral?
+    @xmlliteral
+  end
+  
+  def infer!
+    if @contents.class == Fixnum
+      @encoding = "http://www.w3.org/2001/XMLSchema#int"
+    elsif @contents.class == Float 
+      @encoding = "http://www.w3.org/2001/XMLSchema#float"
+    else
+      @encoding = "http://www.w3.org/2001/XMLSchema#string"
+    end
+  end
+end

data/lib/rena/namespace.rb

@@ -0,0 +1,74 @@
+require 'rena/uriref'
+require 'rena/graph'
+
+class Namespace
+  attr_accessor :short, :uri, :fragment
+   
+  ## 
+  # Creates a new namespace given a URI and the short name.
+  #
+  # ==== Example
+  #   Namespace.new("http://xmlns.com/foaf/0.1/", "foaf") # => returns a new Foaf namespace
+  #
+  # @param [String] uri the URI of the namespace
+  # @param [String] short the short name of the namespace
+  # @param [Boolean] fragment are the identifiers on this resource fragment identifiers? (e.g. '#')  Defaults to false.
+  #
+  # ==== Returns
+  # @return [Namespace] The newly created namespace.
+  #
+  # @raise [Error] Checks validity of the desired shortname and raises if it is incorrect.
+  # @author Tom Morris, Pius Uzamere
+  
+  def initialize(uri, short, fragment = false)
+    @uri = uri
+    @fragment = fragment
+    if shortname_valid?(short)
+      @short = short
+    else
+      raise
+    end
+  end
+  
+  ## 
+  # Allows the construction of arbitrary URIs on the namespace.
+  #
+  # ==== Example
+  #   foaf = Namespace.new("http://xmlns.com/foaf/0.1/", "foaf"); foaf.knows # => returns a new URIRef with URI "http://xmlns.com/foaf/0.1/knows"
+  #   foaf = Namespace.new("http://xmlns.com/foaf/0.1/", "foaf", true); foaf.knows # => returns a new URIRef with URI "http://xmlns.com/foaf/0.1/#knows"
+  #
+  # @param [String] uri the URI of the namespace
+  # @param [String] short the short name of the namespace
+  # @param [Boolean] fragment are the identifiers on this resource fragment identifiers? (e.g. '#')  Defaults to false.
+  #
+  # ==== Returns
+  # @return [URIRef] The newly created URIRegerence.
+  #
+  # @raise [Error] Checks validity of the desired shortname and raises if it is incorrect.
+  # @author Tom Morris, Pius Uzamere
+  
+  def method_missing(methodname, *args)
+    unless fragment
+      URIRef.new(@uri + methodname.to_s)
+    else
+      URIRef.new(@uri + '#' + methodname.to_s)
+    end
+  end
+  
+  def bind(graph)
+    if graph.class == Graph
+      graph.bind(self)
+    else
+      raise
+    end
+  end
+  
+  private
+  def shortname_valid?(shortname)
+    if shortname =~ /[a-zA-Z_][a-zA-Z0-9_]+/
+      return true
+    else
+      return false
+    end
+  end
+end