yaanno-relaxdb 0.2.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Paul Carey
+
+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.textile

@@ -0,0 +1,164 @@
+h3. What's New?
+
+* Pagination! CouchDB offers great support for retrieving a subset of data, but the housekeeping is tricky. RelaxDB takes care of it.
+** Note that if you invoke paginate_by on an already created view, the necessary reduce function won't be automatically created. Take a look at SortedByView and create the reduce func by hand.
+* Support for multi key post
+** For example, @ Numbers.all.sorted_by(:val) { |q| q.keys([1,2,3,5]) } @
+* Works with CouchDB 0.9 trunk as of 2008/10/08. Note that pagination won't work correctly on trunk until issue "COUCHDB-135":http://issues.apache.org/jira/browse/COUCHDB-135 is fixed.
+
+*Note*: 0.2.1 requires CouchDB 0.9 trunk. 0.2.0 works with CouchDB 0.8 onwards.
+
+h2. Overview
+
+RelaxDB provides a Ruby interface to CouchDB. It offers a simple idiom for specifying object relationships. The underlying objects are persisted to the mighty CouchDB. Combined with the schema free nature of CouchDB, RelaxDB's current strength lies in quick prototyping of object models.
+
+A few facilities are provided including pretty printing of GET requests and uploading of JavaScript views.
+
+A basic merb plugin, "merb_relaxdb":http://github.com/paulcarey/merb_relaxdb/tree/master is also available.
+
+For more complete documentation take a look at docs/spec_results.html and the corresponding specs.
+
+h2. Details 
+
+h3. Getting started
+
+<pre>
+<code>
+  RelaxDB.configure :host => "localhost", :port => 5984
+  RelaxDB.use_db "scratch"
+</code>
+</pre>
+
+h3. Defining models
+
+<pre>
+<code>
+  class Writer < RelaxDB::Document
+    property :name, :default => "anon"
+    
+    has_many :posts, :class => "Post"
+    has_many :ratings, :class => "Post", :known_as => :critic
+  end
+
+  class Post < RelaxDB::Document
+    property :created_at
+    property :contents
+  
+    belongs_to :writer  
+    has_many :ratings, :class => "Rating"
+  end
+
+  class Rating < RelaxDB::Document
+    property :thumbs_up, :validator => lambda { |tu| tu >= 0 && tu < 3 }, :validation_msg => "No no"
+
+    belongs_to :post
+    belongs_to :critic
+  end
+</code>
+</pre>
+
+h3. Exploring models
+
+<pre>
+<code>
+  paul = Writer.new(:name => "paul").save
+
+  post = Post.new(:contents => "foo")
+  paul.posts << post                                          # post writer is set and post is saved
+  post.created_at                                             # right now
+  paul.ratings << Rating.new(:thumbs_up => 3, :post => post)  # returns false as rating fails validation
+  paul.ratings.size                                           # 0
+
+  # Simple views are auto created
+  Rating.all.sorted_by(:thumbs_up) { |q| q.key(2).count(1) }  # query params map directly to CouchDB
+</code>
+</pre>
+
+h3. Paginating models
+
+<pre>
+<code>
+  # Controller (merb-action-args used for extracting view_params)
+
+  def action(page_params={})
+    u_id = @user._id
+
+    @posts = Post.paginate_by(page_params, :writer_id, :created_at) do |p|
+      p.startkey([u_id, {}]).endkey([u_id]).descending(true).count(5)
+    end
+    render
+  end
+  
+  # In your view
+  
+  <% @posts.each do |p| %>
+    <%= p.contents %>
+  <% end %>
+  
+  <%= link_to "prev", "/posts/?#{@posts.prev_query}" if @posts.prev_query %>
+  <%= link_to "next", "/posts/?#{@posts.next_query}" if @posts.next_query %>  
+</code>
+</pre>
+
+h3. Paginating over your own views
+
+<pre>
+<code>
+
+RelaxDB.paginate_view(page_params, "Letter", "by_letter_and_number", :letter, :number) do |p|
+  p.startkey(["b"]).endkey(["b", {}]).count(2)
+end
+
+</code>
+</pre>
+
+A more illustrative example is listed in the .paginate_view spec in spec/paginate_spec.rb
+
+h3. Creating views by hand
+
+<pre>
+<code>
+  $ cat view.js 
+  function Writer-allnames-map(doc) {
+    if(doc.class == "Writer")
+      emit(null, doc.name);
+  }
+
+  function Writer-allnames-reduce(keys, values) {
+    var allnames = "";
+    for(var i = 0; i < values.length; i++)
+      allnames += values[i];
+    return allnames;
+  }
+  $
+
+  RelaxDB::ViewUploader.upload("view.js")
+  RelaxDB.view("Writer", "allnames")                          # paul
+</code>
+</pre>
+
+h3. Visualise
+
+Create an object graph by simply running
+<pre>
+<code>
+RelaxDB::GraphCreator.create
+</code>
+</pre>
+
+Requires graphviz. Useful for visualising relationships between a limited number of document e.g. test fixtures. "Description and example":http://dev.strawberrydiva.com/visually_explore_couchdb/.
+
+h3. Experimental Features
+
+* Declarative denormalisation
+** Create a partial object graph in JSON with a single call
+** May be used to require fewer GET requests
+** View the denormalisation spec for examples
+
+h2. Incomplete list of limitations
+
+* Error handling is not robust
+* Destroying an object results in non transactional nullification of child/peer references
+* Objects can talk to only one database at a time
+* No caching is used. Although adding an LRU cache would be fairly straightforward, this hasn't been done as it's not yet clear what caching strategies will be most effective. 
+

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'spec/rake/spectask'
+
+PLUGIN = "relaxdb"
+NAME = "relaxdb"
+GEM_VERSION = "0.2.2"
+AUTHOR = "Paul Carey"
+EMAIL = "paul.p.carey@gmail.com"
+HOMEPAGE = "http://github.com/paulcarey/relaxdb/"
+SUMMARY = "RelaxDB provides a simple interface to CouchDB"
+
+spec = Gem::Specification.new do |s|
+  s.name = NAME
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.textile", "LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  
+  s.add_dependency "extlib", ">=0.9.4"
+  s.add_dependency "json_pure"
+  s.add_dependency "uuid"
+  
+  s.require_path = 'lib'
+  s.autorequire = PLUGIN
+  s.files = %w(LICENSE README.textile Rakefile) + Dir.glob("{docs,lib,spec}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Install"
+task :install => [:package] do
+  sh %{sudo gem install --local pkg/#{NAME}-#{GEM_VERSION} --no-update-sources}
+end
+
+desc "Run specs"
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_files = FileList['spec/**/*.rb']
+end
+
+desc "Run specs and produce spec_results.html"
+Spec::Rake::SpecTask.new('spec:html') do |t|
+  t.spec_files = FileList['spec/**/*.rb']
+  t.spec_opts = ["--format", "html:docs/spec_results.html"]
+end

data/docs/spec_results.html

@@ -0,0 +1,604 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!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>
+  <title>RSpec results</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <meta http-equiv="Expires" content="-1" />
+  <meta http-equiv="Pragma" content="no-cache" />
+  <style type="text/css">
+  body {
+    margin: 0;
+    padding: 0;
+    background: #fff;
+    font-size: 80%;
+  }
+  </style>
+</head>
+<body>
+<div class="rspec-report">
+  <script type="text/javascript">
+    // <![CDATA[
+function moveProgressBar(percentDone) {
+  document.getElementById("rspec-header").style.width = percentDone +"%";
+}
+function makeRed(element_id) {
+  document.getElementById(element_id).style.background = '#C40D0D';
+  document.getElementById(element_id).style.color = '#FFFFFF';
+}
+
+function makeYellow(element_id) {
+  if (element_id == "rspec-header" && document.getElementById(element_id).style.background != '#C40D0D')
+  {
+    document.getElementById(element_id).style.background = '#FAF834';
+    document.getElementById(element_id).style.color = '#000000';
+  }
+  else
+  {
+    document.getElementById(element_id).style.background = '#FAF834';
+    document.getElementById(element_id).style.color = '#000000';
+  }
+}
+
+    // ]]>
+  </script>
+  <style type="text/css">
+#rspec-header {
+  background: #65C400; color: #fff;
+}
+
+.rspec-report h1 {
+  margin: 0px 10px 0px 10px;
+  padding: 10px;
+  font-family: "Lucida Grande", Helvetica, sans-serif;
+  font-size: 1.8em;
+}
+
+#summary {
+  margin: 0; padding: 5px 10px;
+  font-family: "Lucida Grande", Helvetica, sans-serif;
+  text-align: right;
+  position: absolute;
+  top: 0px;
+  right: 0px;
+}
+
+#summary p {
+  margin: 0 0 0 2px;
+}
+
+#summary #totals {
+  font-size: 1.2em;
+}
+
+.example_group {
+  margin: 0 10px 5px;
+  background: #fff;
+}
+
+dl {
+  margin: 0; padding: 0 0 5px;
+  font: normal 11px "Lucida Grande", Helvetica, sans-serif;
+}
+
+dt {
+  padding: 3px;
+  background: #65C400;
+  color: #fff;
+  font-weight: bold;
+}
+
+dd {
+  margin: 5px 0 5px 5px;
+  padding: 3px 3px 3px 18px;
+}
+
+dd.spec.passed {
+  border-left: 5px solid #65C400;
+  border-bottom: 1px solid #65C400;
+  background: #DBFFB4; color: #3D7700;
+}
+
+dd.spec.failed {
+  border-left: 5px solid #C20000;
+  border-bottom: 1px solid #C20000;
+  color: #C20000; background: #FFFBD3;
+}
+
+dd.spec.not_implemented {
+  border-left: 5px solid #FAF834;
+  border-bottom: 1px solid #FAF834;
+  background: #FCFB98; color: #131313;
+}
+
+dd.spec.pending_fixed {
+  border-left: 5px solid #0000C2;
+  border-bottom: 1px solid #0000C2;
+  color: #0000C2; background: #D3FBFF;
+}
+
+.backtrace {
+  color: #000;
+  font-size: 12px;
+}
+
+a {
+  color: #BE5C00;
+}
+
+/* Ruby code, style similar to vibrant ink */
+.ruby {
+  font-size: 12px;
+  font-family: monospace;
+  color: white;
+  background-color: black;
+  padding: 0.1em 0 0.2em 0;
+}
+
+.ruby .keyword { color: #FF6600; }
+.ruby .constant { color: #339999; }
+.ruby .attribute { color: white; }
+.ruby .global { color: white; }
+.ruby .module { color: white; }
+.ruby .class { color: white; }
+.ruby .string { color: #66FF00; }
+.ruby .ident { color: white; }
+.ruby .method { color: #FFCC00; }
+.ruby .number { color: white; }
+.ruby .char { color: white; }
+.ruby .comment { color: #9933CC; }
+.ruby .symbol { color: white; }
+.ruby .regex { color: #44B4CC; }
+.ruby .punct { color: white; }
+.ruby .escape { color: white; }
+.ruby .interp { color: white; }
+.ruby .expr { color: white; }
+
+.ruby .offending { background-color: gray; }
+.ruby .linenum {
+  width: 75px;
+  padding: 0.1em 1em 0.2em 0;
+  color: #000000;
+  background-color: #FFFBD3;
+}
+
+  </style>
+
+<div id="rspec-header">
+  <h1>RSpec Results</h1>
+
+  <div id="summary">
+    <p id="totals">&nbsp;</p>
+    <p id="duration">&nbsp;</p>
+  </div>
+</div>
+
+<div class="results">
+<div class="example_group">
+  <dl>
+  <dt id="example_group_1">RelaxDB::BelongsToProxy</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_2">RelaxDB::BelongsToProxy belongs_to</dt>
+    <script type="text/javascript">moveProgressBar('1.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return nil when accessed before assignment</span></dd>
+    <script type="text/javascript">moveProgressBar('2.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be establishable via constructor attribute</span></dd>
+    <script type="text/javascript">moveProgressBar('3.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be establishable via constructor id</span></dd>
+    <script type="text/javascript">moveProgressBar('4.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should establish the parent relationship when supplied a parent and saved</span></dd>
+    <script type="text/javascript">moveProgressBar('5.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should establish the parent relationship when supplied a parent id and saved</span></dd>
+    <script type="text/javascript">moveProgressBar('6.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return the same object on repeated invocations</span></dd>
+    <script type="text/javascript">moveProgressBar('7.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be nullified when the parent is destroyed</span></dd>
+    <script type="text/javascript">moveProgressBar('8.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be preserved across save / load boundary</span></dd>
+    <script type="text/javascript">moveProgressBar('9.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be able to reference itself via its parent</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_3">RelaxDB::DesignDocument</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_4">RelaxDB::DesignDocument#save</dt>
+    <script type="text/javascript">moveProgressBar('10.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should create a corresponding document in CouchDB</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_5">RelaxDB::DesignDocument#destroy</dt>
+    <script type="text/javascript">moveProgressBar('11.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should delete the corresponding document from CouchDB</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_6">RelaxDB::Document</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_7">RelaxDB::Document.new</dt>
+    <script type="text/javascript">moveProgressBar('12.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should create an object with an id</span></dd>
+    <script type="text/javascript">moveProgressBar('13.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should create an object with a nil revision</span></dd>
+    <script type="text/javascript">moveProgressBar('14.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should convert attributes that end in _at to dates</span></dd>
+    <script type="text/javascript">moveProgressBar('15.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">will silently ignore parameters that don't specify class attributes</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_8">RelaxDB::Document#to_json</dt>
+    <script type="text/javascript">moveProgressBar('16.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should not output nil attributes</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_9">RelaxDB::Document#save</dt>
+    <script type="text/javascript">moveProgressBar('17.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should set an object's revision</span></dd>
+    <script type="text/javascript">moveProgressBar('18.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should result in an object considered saved</span></dd>
+    <script type="text/javascript">moveProgressBar('19.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be invokable multiple times</span></dd>
+    <script type="text/javascript">moveProgressBar('20.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should set created_at when first saved</span></dd>
+    <script type="text/javascript">moveProgressBar('21.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should set created_at when first saved unless supplied to the constructor</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_10">RelaxDB::Document loaded objects</dt>
+    <script type="text/javascript">moveProgressBar('22.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should contain state as when saved</span></dd>
+    <script type="text/javascript">moveProgressBar('23.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be saveable</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_11">RelaxDB::Document#destroy</dt>
+    <script type="text/javascript">moveProgressBar('24.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should delete the corresponding document from CouchDB</span></dd>
+    <script type="text/javascript">moveProgressBar('25.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should prevent the object from being resaved</span></dd>
+    <script type="text/javascript">moveProgressBar('26.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">will result in undefined behaviour when invoked on unsaved objects</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_12">RelaxDB::Document#all.destroy!</dt>
+    <script type="text/javascript">moveProgressBar('27.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should delete from CouchDB all documents of the corresponding class</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_13">RelaxDB::Document ==</dt>
+    <script type="text/javascript">moveProgressBar('28.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should define equality based on CouchDB id</span></dd>
+    <script type="text/javascript">moveProgressBar('29.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return false when passed a nil object</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_14">RelaxDB::Document#all</dt>
+    <script type="text/javascript">moveProgressBar('30.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return all instances of that class</span></dd>
+    <script type="text/javascript">moveProgressBar('31.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return an empty array when no instances exist</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_15">RelaxDB::Document#all.sorted_by</dt>
+    <script type="text/javascript">moveProgressBar('32.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should sort ascending by default</span></dd>
+    <script type="text/javascript">moveProgressBar('33.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should sort desc when specified</span></dd>
+    <script type="text/javascript">moveProgressBar('34.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should sort date attributes lexicographically</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_16">RelaxDB::Document#all.sorted_by results</dt>
+    <script type="text/javascript">moveProgressBar('35.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be retrievable by exact criteria</span></dd>
+    <script type="text/javascript">moveProgressBar('36.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be retrievable by relative criteria</span></dd>
+    <script type="text/javascript">moveProgressBar('37.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be retrievable by combined criteria</span></dd>
+    <script type="text/javascript">moveProgressBar('38.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be retrievable by combined criteria where not all docs contain all attributes</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_17">RelaxDB::Document defaults</dt>
+    <script type="text/javascript">moveProgressBar('39.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be set on initialisation</span></dd>
+    <script type="text/javascript">moveProgressBar('40.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be saved</span></dd>
+    <script type="text/javascript">moveProgressBar('41.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be ignored once overwritten</span></dd>
+    <script type="text/javascript">moveProgressBar('42.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">may be a simple value</span></dd>
+    <script type="text/javascript">moveProgressBar('43.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">may be a proc</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_18">RelaxDB::Document validator</dt>
+    <script type="text/javascript">moveProgressBar('44.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should prevent an object from being saved if it evaluates to false</span></dd>
+    <script type="text/javascript">moveProgressBar('45.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should prevent an object from being saved if it throws an exception</span></dd>
+    <script type="text/javascript">moveProgressBar('46.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should pass the property value to the validator</span></dd>
+    <script type="text/javascript">moveProgressBar('47.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should add the validation error message if supplied, on failure</span></dd>
+    <script type="text/javascript">moveProgressBar('48.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should perform all validations</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_19">RelaxDB::HasManyProxy</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_20">RelaxDB::HasManyProxy has_many</dt>
+    <script type="text/javascript">moveProgressBar('49.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be considered enumerable</span></dd>
+    <script type="text/javascript">moveProgressBar('50.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should actually be enumerable</span></dd>
+    <script type="text/javascript">moveProgressBar('51.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should preserve the collection across the load / save boundary</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_21">RelaxDB::HasManyProxy has_many#&lt;&lt;</dt>
+    <script type="text/javascript">moveProgressBar('52.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should link the added item to the parent</span></dd>
+    <script type="text/javascript">moveProgressBar('53.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return self</span></dd>
+    <script type="text/javascript">moveProgressBar('54.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should not created duplicates when invoked with same object more than once</span></dd>
+    <script type="text/javascript">moveProgressBar('55.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return false when the child fails validation</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_22">RelaxDB::HasManyProxy has_many#=</dt>
+    <script type="text/javascript">moveProgressBar('56.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should fail</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_23">RelaxDB::HasManyProxy has_many#delete</dt>
+    <script type="text/javascript">moveProgressBar('57.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should nullify the belongs_to relationship</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_24">RelaxDB::HasManyProxy has_many#clear</dt>
+    <script type="text/javascript">moveProgressBar('58.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should result in an empty collection</span></dd>
+    <script type="text/javascript">moveProgressBar('59.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should nullify all child relationships</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_25">RelaxDB::HasManyProxy has_many owner</dt>
+    <script type="text/javascript">moveProgressBar('60.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be able to form multiple relationships with the same class of child</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_26">RelaxDB::HasManyProxy has_many owner#destroy</dt>
+    <script type="text/javascript">moveProgressBar('61.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should nullify its child relationships</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_27">RelaxDB::HasOneProxy</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_28">RelaxDB::HasOneProxy has_one</dt>
+    <script type="text/javascript">moveProgressBar('62.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return nil when accessed before assignment</span></dd>
+    <script type="text/javascript">moveProgressBar('63.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be establishable via a constructor attribute</span></dd>
+    <script type="text/javascript">moveProgressBar('64.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be establishable via assignment</span></dd>
+    <script type="text/javascript">moveProgressBar('65.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return the same object on repeated invocations</span></dd>
+    <script type="text/javascript">moveProgressBar('66.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be preserved across load / save boundary</span></dd>
+    <script type="text/javascript">moveProgressBar('67.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be able reference itself via its child</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_29">RelaxDB::HasOneProxy has_one#=</dt>
+    <script type="text/javascript">moveProgressBar('68.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should create a reference from the child to the parent</span></dd>
+    <script type="text/javascript">moveProgressBar('69.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should save the assigned object</span></dd>
+    <script type="text/javascript">moveProgressBar('70.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">will not save the parent</span></dd>
+    <script type="text/javascript">moveProgressBar('71.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should set the target to nil when nil is assigned</span></dd>
+    <script type="text/javascript">moveProgressBar('72.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should nullify any existing relationship in the database</span></dd>
+    <script type="text/javascript">moveProgressBar('73.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should nullify any existing relationship on a known in-memory object</span></dd>
+    <script type="text/javascript">moveProgressBar('74.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">will not nullify any existing relationship on unknown in-memory objects</span></dd>
+    <script type="text/javascript">moveProgressBar('75.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">will not throw an error when the rhs fails validation</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_30">RelaxDB::Query</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_31">RelaxDB::Query#view_name</dt>
+    <script type="text/javascript">moveProgressBar('76.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should match a single key attribute</span></dd>
+    <script type="text/javascript">moveProgressBar('77.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should match key attributes</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_32">RelaxDB::Query#view_path</dt>
+    <script type="text/javascript">moveProgressBar('78.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should list design document and view name</span></dd>
+    <script type="text/javascript">moveProgressBar('79.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should contain URL and JSON encoded key when the key has been set</span></dd>
+    <script type="text/javascript">moveProgressBar('80.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should honour startkey, endkey and count</span></dd>
+    <script type="text/javascript">moveProgressBar('81.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should specify the key as the empty string if key was set to nil</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_33">RelaxDB::ReferencesManyProxy</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_34">RelaxDB::ReferencesManyProxy references_many</dt>
+    <script type="text/javascript">moveProgressBar('82.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">is now deprecated and will be removed in the near future</span></dd>
+    <script type="text/javascript">moveProgressBar('83.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should preserve the relationships across the save / load boundary</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_35">RelaxDB::ReferencesManyProxy references_many#=</dt>
+    <script type="text/javascript">moveProgressBar('84.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should not be invoked</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_36">RelaxDB::ReferencesManyProxy references_many#&lt;&lt;</dt>
+    <script type="text/javascript">moveProgressBar('85.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should set the relationship on both sides</span></dd>
+    <script type="text/javascript">moveProgressBar('86.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should not create duplicates when the same object is added more than once</span></dd>
+    <script type="text/javascript">moveProgressBar('87.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should not create duplicates when reciprocal objects are added from opposite sides</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_37">RelaxDB::ReferencesManyProxy references_many#delete</dt>
+    <script type="text/javascript">moveProgressBar('88.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should nullify relationship on both sides</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_38">RelaxDB::ReferencesManyProxy references_many owner#destroy</dt>
+    <script type="text/javascript">moveProgressBar('89.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">will not remove its membership from its peers in memory</span></dd>
+    <script type="text/javascript">moveProgressBar('90.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should remove its membership from its peers in CouchDB</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_39">RelaxDB</dt>
+    <script type="text/javascript">moveProgressBar('91.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should offer an example where behaviour is different with caching enabled and caching disabled</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_40">RelaxDB.create_object</dt>
+    <script type="text/javascript">moveProgressBar('92.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return an instance of a known object if passed a hash with a class key</span></dd>
+    <script type="text/javascript">moveProgressBar('93.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return an instance of a dynamically created object if no class key is provided</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_41">RelaxDB.bulk_save</dt>
+    <script type="text/javascript">moveProgressBar('94.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should be invokable multiple times</span></dd>
+    <script type="text/javascript">moveProgressBar('95.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should succeed when passed no args</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_42">RelaxDB::ViewObject</dt>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_43">RelaxDB::ViewObject.new</dt>
+    <script type="text/javascript">moveProgressBar('96.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should provide readers for the object passed in the hash</span></dd>
+    <script type="text/javascript">moveProgressBar('97.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should try to convert objects ending in _at to a time</span></dd>
+  </dl>
+</div>
+<div class="example_group">
+  <dl>
+  <dt id="example_group_44">RelaxDB::ViewObject.create</dt>
+    <script type="text/javascript">moveProgressBar('98.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return an array of view objects when passed an array</span></dd>
+    <script type="text/javascript">moveProgressBar('99.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return a view object when passed a hash</span></dd>
+    <script type="text/javascript">moveProgressBar('100.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return a simple value when passed a primitive</span></dd>
+  </dl>
+</div>
+<script type="text/javascript">document.getElementById('duration').innerHTML = "Finished in <strong>11.855995 seconds</strong>";</script>
+<script type="text/javascript">document.getElementById('totals').innerHTML = "100 examples, 0 failures";</script>
+</div>
+</div>
+</body>
+</html>