rubyrdf 0.0.1

data/test/test_typed_literal_node.rb

@@ -0,0 +1,61 @@
+require File.dirname(__FILE__) + '/helper.rb'
+
+class TestTypedLiteralNode < Test::Unit::TestCase
+  def test_new_should_initialize_lexical_form
+    assert_equal 'test', RDF::TypedLiteralNode.new('test', EX::a.uri).lexical_form
+  end
+  
+  def test_new_should_initialize_datatype_uri
+    assert_equal EX::a.uri, RDF::TypedLiteralNode.new('test', EX::a.uri).datatype_uri
+  end
+  
+  def test_new_should_raise_error_for_empty_datatype_uri
+    assert_raise(ArgumentError) {
+      RDF::TypedLiteralNode.new('test', nil)
+    }
+  end
+  
+  def test_new_should_initialize_datatype_uri_from_uri_node
+    assert_equal EX::a.uri, RDF::TypedLiteralNode.new('test', EX::a).datatype_uri
+  end
+  
+  def test_equal_should_be_true_for_same_lexical_form_and_datatype_uri
+    assert_equal RDF::TypedLiteralNode.new('test', EX::a), RDF::TypedLiteralNode.new('test', EX::a)
+  end
+  
+  def test_equal_should_be_false_for_same_lexical_form_and_different_datatype_uri
+    assert_not_equal RDF::TypedLiteralNode.new('test', EX::a), RDF::TypedLiteralNode.new('test', EX::b)
+  end
+  
+  def test_equal_should_be_false_for_different_lexical_form_and_same_datatype_uri
+    assert_not_equal RDF::TypedLiteralNode.new('test2', EX::a), RDF::TypedLiteralNode.new('test', EX::a)
+  end
+  
+  def test_hash_should_be_equal_for_same_lexical_form_and_datatype_uri
+    assert_equal RDF::TypedLiteralNode.new('test', EX::a).hash, RDF::TypedLiteralNode.new('test', EX::a).hash
+  end
+  
+  def test_hash_should_not_be_equal_for_same_lexical_form_and_different_datatype_uri
+    assert_not_equal RDF::TypedLiteralNode.new('test', EX::a).hash, RDF::TypedLiteralNode.new('test', EX::b).hash
+  end
+  
+  def test_hash_should_not_be_equal_for_different_lexical_form_and_same_datatype_uri
+    assert_not_equal RDF::TypedLiteralNode.new('test2', EX::a).hash, RDF::TypedLiteralNode.new('test', EX::a).hash
+  end
+  
+  def test_eql_should_be_true_for_same_lexical_form_and_datatype_uri
+    assert RDF::TypedLiteralNode.new('test', EX::a).eql?(RDF::TypedLiteralNode.new('test', EX::a))
+  end
+  
+  def test_eql_should_be_false_for_same_lexical_form_and_different_datatype_uri
+    assert !RDF::TypedLiteralNode.new('test', EX::a).eql?(RDF::TypedLiteralNode.new('test', EX::b))
+  end
+  
+  def test_eql_should_be_false_for_different_lexical_form_and_same_datatype_uri
+    assert !RDF::TypedLiteralNode.new('test2', EX::a).eql?(RDF::TypedLiteralNode.new('test', EX::a))
+  end
+  
+  def test_to_s_should_be_ntriples_format
+    assert_equal "\"test\"^^<#{EX::a.uri}>", RDF::TypedLiteralNode.new('test', EX::a).to_s
+  end
+end

data/test/test_uri_node.rb

@@ -0,0 +1,45 @@
+require File.dirname(__FILE__) + '/helper.rb'
+
+class TestUriNode < Test::Unit::TestCase
+  def test_new_should_initialize_uri
+    assert_equal EX::a.uri, RDF::UriNode.new(EX::a).uri
+  end
+  
+  def test_new_should_initialize_uri_from_uri_node
+    assert_equal EX::a.uri, RDF::UriNode.new(RDF::UriNode.new(EX::a)).uri
+  end
+  
+  def test_new_should_raise_error_for_blank_uri
+    assert_raise(ArgumentError) {
+      RDF::UriNode.new(nil)
+    }
+  end
+  
+  def test_equal_should_be_true_for_same_uri
+    assert_equal RDF::UriNode.new(EX::a), RDF::UriNode.new(EX::a)
+  end
+  
+  def test_equal_should_be_false_for_different_uri
+    assert_not_equal RDF::UriNode.new(EX::a), RDF::UriNode.new(EX::b)
+  end
+  
+  def test_hash_should_be_equal_for_same_uri
+    assert_equal RDF::UriNode.new(EX::a).hash, RDF::UriNode.new(EX::a).hash
+  end
+  
+  def test_hash_should_not_be_equal_for_different_uri
+    assert_not_equal RDF::UriNode.new(EX::a).hash, RDF::UriNode.new(EX::b).hash
+  end
+  
+  def test_eql_should_be_true_for_same_uri
+    assert RDF::UriNode.new(EX::a).eql?(RDF::UriNode.new(EX::a))
+  end
+  
+  def test_eql_should_be_false_for_different_uri
+    assert !RDF::UriNode.new(EX::a).eql?(RDF::UriNode.new(EX::b))
+  end
+  
+  def test_to_s_should_be_ntriples_format
+    assert_equal "<#{EX::a.uri}>", EX::a.to_s
+  end
+end

data/website/index.html

@@ -0,0 +1,169 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      RubyRDF
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+
+    <h1>RubyRDF</h1>
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/rubyrdf"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/rubyrdf" class="numbers">0.0.1</a>
+    </div>
+    <h1>&#x2192; &#8216;rubyrdf&#8217;</h1>
+
+
+	<h2>What</h2>
+
+
+	<p>An <span class="caps">RDF</span> (Resource Description Framework) data access layer for the Ruby programming language with a pluggable graph implementation.  I have three goals:</p>
+
+
+	<ol>
+	<li>Provide an in-memory, pure Ruby implementation of the <span class="caps">RDF</span> graph model for situations where a high performance triple store is not needed.</li>
+		<li>Provide plug-in graph implementations that delegate to high performance triple stores for situations where high performance is needed.</li>
+		<li>Smooth out differences between triple stores to provide a consistent interface to <span class="caps">RDF</span> data.  An example of this would be to deletgate reasoning to a triple store when available, but to provide a pure Ruby <span class="caps">RDF</span> reasoning engine that can be used with the in-memory model, or with triple stores that do not support reasoning.  Same goes for <span class="caps">SPARQL</span> queries, import/export formats, etc.</li>
+	</ol>
+
+
+	<h2>Installing</h2>
+
+
+	<p><pre class='syntax'><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">rubyrdf</span></pre></p>
+
+
+	<h2>The basics</h2>
+
+
+	<p>RubyRDF implements the basic <span class="caps">RDF</span> data model (UriNode, TypedLiteralNode, PlainLiteralNode, BlankNode, Graph, etc.).  There is also a very, <em>very</em> simple querying mechanism that would hopefully be replaced by <span class="caps">SPARQL</span> or a <span class="caps">SPARQL</span>-based <span class="caps">DSL</span>.  There is also a fully compliant NTriples import/export function.</p>
+
+
+	<p>There is a in-memory graph implementation, and a Sesame 1.x graph implementation that uses Sesame&#8217;s <span class="caps">HTTP</span> protocol.</p>
+
+
+	<p>There is a class (Namespace) that is used to generate new UriNodes easily.</p>
+
+
+	<p>For more details about the <span class="caps">API</span> see the <a href="http://rubyrdf.rubyforge.org/rdoc/">rdocs</a>.</p>
+
+
+	<p>There are also some subprojects (at this point just one) that provide graph implementations for specific triple stores:</p>
+
+
+	<ul>
+	<li><a href="http://rubyrdf.rubyforge.org/rubyrdf-sesame/">RubyRDF Sesame</a></li>
+	</ul>
+
+
+	<h2>Demonstration of usage</h2>
+
+
+	<h3>Adding data to a graph</h3>
+
+
+	<p><pre class='syntax'>
+<span class="ident">g</span> <span class="punct">=</span> <span class="constant">RDF</span><span class="punct">::</span><span class="constant">Graph</span><span class="punct">::</span><span class="constant">Memory</span><span class="punct">.</span><span class="ident">new</span>
+<span class="ident">g</span><span class="punct">.</span><span class="ident">add</span><span class="punct">(</span><span class="constant">UriNode</span><span class="punct">.</span><span class="ident">new</span><span class="punct">('</span><span class="string">http://paul.stadig.name/</span><span class="punct">'),</span> <span class="constant">RDF</span><span class="punct">::</span><span class="ident">type</span><span class="punct">,</span> <span class="constant">RDF</span><span class="punct">::</span><span class="constant">Resource</span><span class="punct">)</span>
+</pre></p>
+
+
+	<h3>Registering a new namespace</h3>
+
+
+	<p><pre class='syntax'>
+<span class="constant">RDF</span><span class="punct">::</span><span class="constant">Namespace</span><span class="punct">.</span><span class="ident">register</span><span class="punct">(</span><span class="symbol">:dc</span><span class="punct">,</span> <span class="punct">'</span><span class="string">http://purl.org/dc/elements/1.1/</span><span class="punct">')</span>
+
+<span class="comment"># you can also create instances of Triple and add them to the graph</span>
+<span class="ident">t</span> <span class="punct">=</span> <span class="constant">RDF</span><span class="punct">::</span><span class="constant">Triple</span><span class="punct">.</span><span class="ident">new</span><span class="punct">(</span><span class="constant">UriNode</span><span class="punct">.</span><span class="ident">new</span><span class="punct">('</span><span class="string">http://paul.stadig.name/</span><span class="punct">'),</span> 
+                    <span class="constant">DC</span><span class="punct">::</span><span class="ident">author</span><span class="punct">,</span> 
+                    <span class="ident">g</span><span class="punct">.</span><span class="ident">new_blank_node</span><span class="punct">('</span><span class="string">paul</span><span class="punct">'))</span>
+<span class="ident">g</span><span class="punct">.</span><span class="ident">add</span><span class="punct">(</span><span class="ident">t</span><span class="punct">)</span>
+</pre></p>
+
+
+	<h3>Querying a graph</h3>
+
+
+	<p><pre class='syntax'>
+<span class="ident">q</span> <span class="punct">=</span> <span class="constant">Query</span><span class="punct">.</span><span class="ident">new</span>
+<span class="ident">q</span><span class="punct">.</span><span class="ident">select</span><span class="punct">(</span><span class="symbol">:x</span><span class="punct">,</span> <span class="symbol">:y</span><span class="punct">).</span><span class="ident">where</span><span class="punct">(</span><span class="symbol">:x</span><span class="punct">,</span> <span class="constant">DC</span><span class="punct">::</span><span class="ident">author</span><span class="punct">,</span> <span class="symbol">:y</span><span class="punct">)</span>
+<span class="ident">result</span> <span class="punct">=</span> <span class="ident">g</span><span class="punct">.</span><span class="ident">execute</span><span class="punct">(</span><span class="ident">q</span><span class="punct">)</span>
+<span class="ident">result</span><span class="punct">.</span><span class="ident">bindings</span><span class="punct">.</span><span class="ident">each</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">b</span><span class="punct">|</span>
+  <span class="ident">puts</span> <span class="punct">&quot;</span><span class="string">x = <span class="expr">#{b[:x]}</span></span><span class="punct">&quot;</span>
+  <span class="ident">puts</span> <span class="punct">&quot;</span><span class="string">y = <span class="expr">#{b[:y]}</span></span><span class="punct">&quot;</span>
+<span class="keyword">end</span>
+</pre></p>
+
+
+	<h2>Forum</h2>
+
+
+	<p><a href="http://groups.google.com/group/rubyrdf">http://groups.google.com/group/rubyrdf</a></p>
+
+
+	<h2>How to get involved</h2>
+
+
+	<p>I am using Bazaar for source control, and Launchpad for development management.  This provides (in my opinion) a superior development process.  Since bazaar is a distributed version control system, you do not need my permission to start hacking on the code, you only need to branch it</p>
+
+
+<pre>bzr branch http://bazaar.launchpad.net/~pjstadig/rubyrdf/trunk rubyrdf</pre>
+
+	<p>Write your tests.  Write your code.  Test.  Then commit</p>
+
+
+<pre>bzr commit -m"Some useful message about what you have done"</pre>
+
+	<p>If you want to let me know about your changes to have them included in the main development branch, then you&#8217;ll need to publish your branch somewhere. Launchpad provides bazaar hosting.  To host your code there you&#8217;ll need a Launchpad account.</p>
+
+
+<pre>bzr push sftp://bazaar.launchpad.net/~[your launchpad login]/rubyrdf/[your branch name]</pre>
+
+	<p>Let me know what you have done, and if your changes work, then I&#8217;ll pull them into the main branch, or I&#8217;ll provide feedback.  You can also do stuff like associate a commit with a bug report, and Launchpad will automagically notice.  For a more detailed tutorial see <a href="http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html">Bazaar in five minutes</a> and <a href="http://doc.bazaar-vcs.org/latest/en/tutorials/using_bazaar_with_launchpad.html">Using Bazaar with Launchpad</a>.</p>
+
+
+	<h2>License</h2>
+
+
+	<p>This code is free to use under the terms of the <span class="caps">BSD</span> license (revised).</p>
+
+
+	<h2>Contact</h2>
+
+
+	<p>Comments are welcome. Send an email to <a href="mailto:paul@stadig.name">Paul Stadig</a> via the <a href="http://groups.google.com/group/rubyrdf">forum</a></p>
+    <p class="coda">
+      <a href="FIXME email">FIXME full name</a>, 9th April 2008<br>
+      Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
+    </p>
+</div>
+
+<!-- insert site tracking codes here, like Google Urchin -->
+
+</body>
+</html>

data/website/index.txt

@@ -0,0 +1,92 @@
+h1. RubyRDF
+
+h1. → 'rubyrdf'
+
+
+h2. What
+
+An RDF (Resource Description Framework) data access layer for the Ruby programming language with a pluggable graph implementation.  I have three goals:
+
+ # Provide an in-memory, pure Ruby implementation of the RDF graph model for situations where a high performance triple store is not needed.
+ # Provide plug-in graph implementations that delegate to high performance triple stores for situations where high performance is needed.
+ # Smooth out differences between triple stores to provide a consistent interface to RDF data.  An example of this would be to deletgate reasoning to a triple store when available, but to provide a pure Ruby RDF reasoning engine that can be used with the in-memory model, or with triple stores that do not support reasoning.  Same goes for SPARQL queries, import/export formats, etc.
+
+h2. Installing
+
+<pre syntax="ruby">sudo gem install rubyrdf</pre>
+
+h2. The basics
+
+RubyRDF implements the basic RDF data model (UriNode, TypedLiteralNode, PlainLiteralNode, BlankNode, Graph, etc.).  There is also a very, _very_ simple querying mechanism that would hopefully be replaced by SPARQL or a SPARQL-based DSL.  There is also a fully compliant NTriples import/export function.
+
+There is a in-memory graph implementation, and a Sesame 1.x graph implementation that uses Sesame's HTTP protocol.
+
+There is a class (Namespace) that is used to generate new UriNodes easily.
+
+For more details about the API see the "rdocs":http://rubyrdf.rubyforge.org/rdoc/.
+
+There are also some subprojects (at this point just one) that provide graph implementations for specific triple stores:
+
+ * "RubyRDF Sesame":http://rubyrdf.rubyforge.org/rubyrdf-sesame/
+
+h2. Demonstration of usage
+
+h3. Adding data to a graph
+
+<pre syntax="ruby">
+g = RDF::Graph::Memory.new
+g.add(UriNode.new('http://paul.stadig.name/'), RDF::type, RDF::Resource)
+</pre>
+
+h3. Registering a new namespace
+
+<pre syntax="ruby">
+RDF::Namespace.register(:dc, 'http://purl.org/dc/elements/1.1/')
+
+# you can also create instances of Triple and add them to the graph
+t = RDF::Triple.new(UriNode.new('http://paul.stadig.name/'), 
+                    DC::author, 
+                    g.new_blank_node('paul'))
+g.add(t)
+</pre>
+
+h3. Querying a graph
+
+<pre syntax="ruby">
+q = Query.new
+q.select(:x, :y).where(:x, DC::author, :y)
+result = g.execute(q)
+result.bindings.each do |b|
+  puts "x = #{b[:x]}"
+  puts "y = #{b[:y]}"
+end
+</pre>
+
+h2. Forum
+
+"http://groups.google.com/group/rubyrdf":http://groups.google.com/group/rubyrdf
+
+h2. How to get involved
+
+I am using Bazaar for source control, and Launchpad for development management.  This provides (in my opinion) a superior development process.  Since bazaar is a distributed version control system, you do not need my permission to start hacking on the code, you only need to branch it
+
+<pre>bzr branch http://bazaar.launchpad.net/~pjstadig/rubyrdf/trunk rubyrdf</pre>
+
+Write your tests.  Write your code.  Test.  Then commit
+
+<pre>bzr commit -m"Some useful message about what you have done"</pre>
+
+If you want to let me know about your changes to have them included in the main development branch, then you'll need to publish your branch somewhere. Launchpad provides bazaar hosting.  To host your code there you'll need a Launchpad account.
+
+<pre>bzr push sftp://bazaar.launchpad.net/~[your launchpad login]/rubyrdf/[your branch name]</pre>
+
+Let me know what you have done, and if your changes work, then I'll pull them into the main branch, or I'll provide feedback.  You can also do stuff like associate a commit with a bug report, and Launchpad will automagically notice.  For a more detailed tutorial see "Bazaar in five minutes":http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html and "Using Bazaar with Launchpad":http://doc.bazaar-vcs.org/latest/en/tutorials/using_bazaar_with_launchpad.html.
+
+h2. License
+
+This code is free to use under the terms of the BSD license (revised).
+
+h2. Contact
+
+Comments are welcome. Send an email to "Paul Stadig":mailto:paul@stadig.name via the "forum":http://groups.google.com/group/rubyrdf
+