Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
Reddy
SparqlConstraints.html
SparqlQuery.html
all-methods.html
all-namespaces.html
app.js
index.html
jquery.js
readme.html
style.css
syntax_highlight.css

readme.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
  <head>
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<link rel="stylesheet" href="style.css" type="text/css" charset="utf-8" />
<link rel="stylesheet" href="syntax_highlight.css" type="text/css" charset="utf-8" />

    <title>README</title>
  </head>
  <body>
    <div id="content">
      <div class="section docstring readme">
        <p>
Connie Release 0.0.1 (January 5th 2009)
</p>
<h6>=============================</h6>
<p>
*<b>Git</b>*:
[http://github.com/pius/connie](http://github.com/pius/connie)
*<b>Author</b>*: Pius Uzamere, [The Uyiosa
Corporation](http://www.uyiosa.com)
</p>
<p>
*<b>Copyright</b>*: Pius Uzamere © 2009 *<b>License</b>*: The Lesser GNU
Public License
</p>
<p>
SYNOPSIS
</p>
<hr size="6"></hr><p>
Connie is a Ruby library that implements
[SPARQL](http://www.w3.org/TR/rdf-sparql-query/) given a parse tree of a
SPARQL query and a set of RDF triples. Implements SPARQL properties as a
set of constraints. The constraints are executed by
[Gecode/R](http://gecoder.rubyforge.org/), a Ruby bridge to Gecode, an open
source library for constraint programming written in C++.
</p>
<p>
While Connie can certainly be used to service SPARQL queries written by
hand in Connie&#8217;s parse tree syntax, the intended use is as a
component that receives a parse tree from a SPARQL parser.
</p>
<p>
FEATURE LIST
</p>
<hr size="10"></hr><ol>
<li>**Connie can handle simple, univariate triple patterns**: When finished,
this library will have a full test suite and can serve as a maintainable
reference implementation of a SPARQL engine in Ruby. Currently, only very
basic queries are supported. Please see the spec suite for the latest usage
examples or check out the documentation for more details.

</li>
</ol>
<p>
USAGE
</p>
<hr size="3"></hr><ol>
<li>**Make Sure You&#8217;ve Got the Dependencies installed**

</li>
</ol>
<p>
Connie depends on Gecode/R (http://gecode.rubyforge.org).
</p>
<pre class="code">
  <span class='gt op'>&gt;</span> <span class='sudo identifier id'>sudo</span> <span class='gem identifier id'>gem</span> <span class='install identifier id'>install</span> <span class='gecoder identifier id'>gecoder</span><span class='minus op'>-</span><span class='with identifier id'>with</span><span class='minus op'>-</span><span class='gecode identifier id'>gecode</span>
</pre>
<ol>
<li>**Clone the Repository and Install the Connie Gem from Source**

</li>
</ol>
<pre class="code">
  <span class='gt op'>&gt;</span> <span class='git identifier id'>git</span> <span class='clone identifier id'>clone</span> <span class='git identifier id'>git</span><span class='symbol val'>:/</span><span class='regexp val'>/github.com/</span><span class='pius identifier id'>pius</span><span class='div op'>/</span><span class='connie identifier id'>connie</span><span class='dot token'>.</span><span class='git identifier id'>git</span>
  <span class='gt op'>&gt;</span> <span class='cd identifier id'>cd</span> <span class='connie identifier id'>connie</span>
  <span class='gt op'>&gt;</span> <span class='gem identifier id'>gem</span> <span class='build identifier id'>build</span> <span class='connie identifier id'>connie</span><span class='dot token'>.</span><span class='gemspec identifier id'>gemspec</span>
  <span class='gt op'>&gt;</span> <span class='sudo identifier id'>sudo</span> <span class='gem identifier id'>gem</span> <span class='install identifier id'>install</span> <span class='connie identifier id'>connie</span>
</pre>
<ol>
<li>**Require the gem in your code, play with it**

</li>
</ol>
<p>
For usage, the best thing is to click through the
[documentation](http://pius.github.com/connie). If you need more guidance,
check out the specs, which demonstrate precisely how to feed Connie a
SPARQL query parse tree and run the engine.
</p>
<p>
I&#8217;m still bringing the documentation up to where I&#8217;d like it to
be; please do feel free to contact me if you&#8217;ve got any questions.
</p>
<ol>
<li>**Contribute!**

</li>
</ol>
<p>
Fork my [repository](http://github.com/pius/sparql), make some changes, and
send along a pull request!
</p>
<p>
The best way to contribute is to add a unit test for a specific SPARQL
parse tree and then tweak the code such that your new test case plus all
the others pass.
</p>
<p>
COPYRIGHT
</p>
<hr size="7"></hr><p>
Connie was created in 2009 by Pius Uzamere (pius -AT- alum -DOT- mit -DOT-
edu) and is licensed under the LGPL.
</p>

      </div>
    </div>
  </body>
</html>