cloudkit-jruby 0.11.2

data/CHANGES

@@ -0,0 +1,47 @@
+0.11.2
+- Added Location header for 201s
+- Fixed JSON response for DELETE operations
+- Updated MD5 dependency for Ruby 1.9 (Andreas Haller)
+- Updated spec setup for RSpec 1.2 (Andreas Haller)
+- Updated gem dependencies for Rack, OpenID, and JSON
+- Other minor fixes
+
+0.11.1
+- Added a block option for configuring OpenID bypassed routes (Devlin Daley)
+- Added write locks for Tokyo Tyrant Tables
+- Added Tokyo Tyrant Table example
+- Fixed POST method tunneling bug (Saimon Moore)
+- Fixed escaping of nested JSON Objects and Arrays
+
+0.11.0
+- Added Tokyo Cabinet storage
+- Added MemoryTable development-time storage
+- Improved router performance
+- Added CloudKit::Resource model
+- Added custom URIs for OpenID bypass
+- Removed internal undocumented ExtractionViews
+- Removed SQL backends
+- Removed Sequel and Rack::Config dependencies
+- Switched test framework to RSpec
+
+0.10.1
+- Updated oauth and sequel gem dependencies
+- Fixed 410 responses for stale PUT operations
+- Fixed MySQL content encoding (Harry Weppner)
+- Various fixes for filter_merge!, rekey!, and excluding (Cameron Walters)
+
+0.10.0
+- Updated for Rack 0.9
+- Added batch URI resolution for resource collections
+- Refactored use of constants
+- Updated documentation
+
+0.9.1
+- Fixed Rack::Lint/rackup errors related to Content-Type headers
+- Patched Rack to support StringIO#string in Rack::Lint::InputWrapper
+- Fixed server_url encoding in OpenIDStore
+- Added sqlite3-ruby dependency in gemspec
+- Updated documentation
+
+0.9.0
+- First public gem release

data/COPYING

@@ -0,0 +1,20 @@
+Copyright (c) 2008, 2009 Jon Crosby http://joncrosby.me
+
+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

@@ -0,0 +1,84 @@
+=CloudKit
+
+CloudKit is an Open Web JSON Appliance.
+
+CloudKit provides schema-free, auto-versioned, RESTful JSON storage with optional OpenID and OAuth support, including OAuth Discovery.
+
+CloudKit is Rack middleware. It can be used on its own or alongside other Rack-based applications or middleware components like Rails, Merb or Sinatra.
+
+===Install
+
+  gem install cloudkit
+
+===Examples
+
+In a rackup file called config.ru:
+
+  require 'cloudkit'
+  expose :notes, :todos
+
+The above creates a versioned HTTP/REST service using JSON to represent two types of resource collections -- Notes and ToDos.
+
+In a different rackup file:
+
+  require 'cloudkit'
+  contain :notes, :todos
+
+The above provides the same API as example 1 with added authentication and authorization via OpenID and OAuth, respectively.
+
+An explicit version of example 2, minus the default developer landing page:
+
+  require 'cloudkit'
+  use Rack::Session::Pool
+  use CloudKit::OAuthFilter
+  use CloudKit::OpenIDFilter
+  use CloudKit::Service, :collections => [:notes, :todos]
+  run lambda {|env| [200, {'Content-Type' => 'text/html', 'Content-Length' => '5'}, ['HELLO']]}
+
+The same as above, using Tokyo Cabinet:
+
+  require 'cloudkit'
+  require 'rufus/tokyo' # gem install rufus-tokyo
+  CloudKit.setup_storage_adapter(Rufus::Tokyo::Table.new('cloudkit.tdb'))
+  use Rack::Session::Pool
+  use CloudKit::OAuthFilter
+  use CloudKit::OpenIDFilter
+  use CloudKit::Service, :collections => [:notes, :todos]
+  run lambda {|env| [200, {'Content-Type' => 'text/html', 'Content-Length' => '5'}, ['HELLO']]}
+
+See the examples directory for more.
+
+===Online
+
+Main Site: http://getcloudkit.com
+
+Blog: http://blog.joncrosby.me
+
+Google Group: http://groups.google.com/group/cloudkit
+
+Source: http://github.com/jcrosby/cloudkit
+
+IRC: #cloudkit on freenode
+
+===License
+
+Copyright (c) 2008, 2009 Jon Crosby http://joncrosby.me
+
+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,42 @@
+require 'rake/clean'
+require 'spec/rake/spectask'
+
+CLEAN.include 'doc/api'
+
+task :default => :spec
+
+desc "Run all examples (or a specific spec with TASK=xxxx)"
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_opts  = ["-c"]
+  t.spec_files = begin
+    if ENV["TASK"] 
+      ENV["TASK"].split(',').map { |task| "spec/**/#{task}_spec.rb" }
+    else
+      FileList['spec/**/*_spec.rb']
+    end
+  end
+end
+
+desc 'Generate rdoc'
+task :rdoc do
+  rm_rf 'doc/api'
+  sh((<<-SH).gsub(/[\s\n]+/, ' ').strip)
+  hanna
+    --inline-source
+    --line-numbers
+    --include=lib/cloudkit.rb
+    --include=lib/cloudkit/*.rb
+    --include=lib/cloudkit/*/*.rb
+    --exclude=Rakefile
+    --exclude=TODO
+    --exclude=cloudkit.gemspec
+    --exclude=templates/*
+    --exclude=examples/*
+    --exclude=spec/*
+    --exclude=doc/index.html
+    --exclude=doc/curl.html
+    --exclude=doc/rest-api.html
+    --exclude=doc/main.css
+    --op=doc/api
+  SH
+end

data/TODO

@@ -0,0 +1,21 @@
+1.0
+- openid sreg
+- oauth token management
+- oauth consumer registration
+- jsonquery
+- jsonschema
+- user lookup via a block for integration with existing stores
+- custom templates for openid / oauth
+
+Backlog
+- acls i.e. allowed methods per user per uri
+- method filtering on collections
+- js functions as observers (validation, mapping, etc.)
+- complete user data export
+- expect header/100-continue
+- deployable gem + admin app
+- cappuccino adapter
+- sproutcore adapter
+- titanium middleware
+    version/upgrade middleware
+    rake automation

data/cloudkit.gemspec

@@ -0,0 +1,89 @@
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.name              = "cloudkit-jruby"
+  s.version           = "0.11.2"
+  s.date              = "2008-05-05"
+  s.summary           = "An Open Web JSON Appliance."
+  s.description       = "An Open Web JSON Appliance."
+  s.authors           = ["Jon Crosby"]
+  s.email             = "jon@joncrosby.me"
+  s.homepage          = "http://getcloudkit.com"
+  s.files             = %w[
+    CHANGES
+    COPYING
+    README
+    Rakefile
+    TODO
+    cloudkit.gemspec
+    doc/curl.html
+    doc/images/example-code.gif
+    doc/images/json-title.gif
+    doc/images/oauth-discovery-logo.gif
+    doc/images/openid-logo.gif
+    doc/index.html
+    doc/main.css
+    doc/rest-api.html
+    examples/1.ru
+    examples/2.ru
+    examples/3.ru
+    examples/4.ru
+    examples/5.ru
+    examples/6.ru
+    examples/TOC
+    lib/cloudkit.rb
+    lib/cloudkit/constants.rb
+    lib/cloudkit/exceptions.rb
+    lib/cloudkit/flash_session.rb
+    lib/cloudkit/oauth_filter.rb
+    lib/cloudkit/oauth_store.rb
+    lib/cloudkit/openid_filter.rb
+    lib/cloudkit/openid_store.rb
+    lib/cloudkit/rack/builder.rb
+    lib/cloudkit/rack/router.rb
+    lib/cloudkit/request.rb
+    lib/cloudkit/service.rb
+    lib/cloudkit/store.rb
+    lib/cloudkit/store/memory_table.rb
+    lib/cloudkit/store/resource.rb
+    lib/cloudkit/store/response.rb
+    lib/cloudkit/store/response_helpers.rb
+    lib/cloudkit/templates/authorize_request_token.erb
+    lib/cloudkit/templates/oauth_descriptor.erb
+    lib/cloudkit/templates/oauth_meta.erb
+    lib/cloudkit/templates/openid_login.erb
+    lib/cloudkit/templates/request_authorization.erb
+    lib/cloudkit/templates/request_token_denied.erb
+    lib/cloudkit/uri.rb
+    lib/cloudkit/user_store.rb
+    lib/cloudkit/util.rb
+    spec/ext_spec.rb
+    spec/flash_session_spec.rb
+    spec/memory_table_spec.rb
+    spec/oauth_filter_spec.rb
+    spec/oauth_store_spec.rb
+    spec/openid_filter_spec.rb
+    spec/openid_store_spec.rb
+    spec/rack_builder_spec.rb
+    spec/request_spec.rb
+    spec/resource_spec.rb
+    spec/service_spec.rb
+    spec/spec_helper.rb
+    spec/store_spec.rb
+    spec/uri_spec.rb
+    spec/user_store_spec.rb
+    spec/util_spec.rb
+  ]
+  s.test_files        = s.files.select {|path| path =~ /^spec\/.*_spec.rb/}
+  s.rubyforge_project = "cloudkit"
+  s.rubygems_version  = "1.1.1"
+  s.add_dependency 'rack', '>= 1.0'
+  s.add_dependency 'uuid', '= 2.0.1'
+  s.add_dependency 'oauth', '~> 0.3'
+  s.add_dependency 'ruby-openid', '~> 2.1'
+  if Gem::Platform::CURRENT =~ /java/
+    s.add_dependency 'json-jruby', '> 0'
+  else
+    s.add_dependency 'json', '~> 1.1'
+  end
+end

data/doc/curl.html

@@ -0,0 +1,388 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title>CloudKit via cURL</title>
+  <link rel="stylesheet" href="main.css" type="text/css" charset="utf-8"/>
+</head>
+<body>
+  <div class="wrapper">
+    <ul class="nav">
+      <li><a href="rest-api.html" title="REST API">REST API</a></li>
+      <li><a href="curl.html" title="cURL Tutorial">cURL</a></li>
+      <li><a href="api" title="RDoc">RDoc</a></li>
+      <li><a href="http://github.com/jcrosby/cloudkit" title="GitHub Source Repository">Code</a></li>
+      <li><a href="http://blog.joncrosby.me" title="Author's Blog">Blog</a></li>
+    </ul>
+  </div>
+  <div id="header">
+    <div class="wrapper">
+      <h1><a href="index.html">CloudKit</a></h1>
+      <div class="subpage-subtitle">via cURL</div>
+    </div>
+  </div>
+  <div class="meta">
+    <p class="wrapper">
+  This is a tour of the CloudKit <a href="http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm">REST</a>/HTTP 1.1 API
+  using <a href="http://curl.haxx.se/docs/manpage.html">curl</a>. For the complete
+  spec, see the <a href="rest-api.html">CloudKit REST API</a>.
+    </p>
+  </div>
+<div class="wrapper">
+<p>
+If you haven't already installed the gem:
+  <div class="code">
+    $ gem install cloudkit
+  </div>
+</p>
+
+<p>
+If you already have the gem, make sure you're running the latest version (0.11.2):
+  <div class="code">
+    $ gem list cloudkit<br/>
+    cloudkit (0.10.0) &lt;-- need to upgrade<br/>
+    $ gem update cloudkit<br/>
+    $ gem list cloudkit<br/>
+    cloudkit (0.11.2, 0.10.0) &lt;-- 0.11.2 is now in the list
+  </div>
+</p>
+
+<p>
+Create a rackup file named config.ru, containing these two lines of code:
+  <div class="code">
+    require 'cloudkit'<br/>
+    expose :notes
+  </div>
+</p>
+
+<p>
+Run the app:
+  <div class="code">
+    $ rackup config.ru
+  </div>
+</p>
+
+<p>
+CloudKit is discoverable from top to bottom. Let's see what resource collections
+we're hosting:
+  <div class="code">
+    $ curl -i http://localhost:9292/cloudkit-meta<br/>
+    HTTP/1.1 200 OK<br/>
+    ETag: "ef2f29b1834ef8c2bf0d8f1abb100177"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 20<br/><br/>
+
+    {"uris":["\/notes"]}
+  </div>
+</p>
+
+<p>
+See what we can do with these note resources:
+  <div class="code">
+    $ curl -i -XOPTIONS http://localhost:9292/notes<br/>
+    HTTP/1.1 200 OK<br/>
+    Content-Length: 0<br/>
+    Content-Type: application/json<br/>
+    Allow: GET, HEAD, POST, OPTIONS<br/>
+  </div>
+</p>
+
+<p>
+List the currently available notes:
+  <div class="code">
+    $ curl -i http://localhost:9292/notes<br/>
+    HTTP/1.1 200 OK<br/>
+    ETag: "ffc5e6012614d759283199e67f79071b"<br/>
+    Link: &lt;http://localhost:9292/notes/_resolved&gt;; rel="http://joncrosby.me/cloudkit/1.0/rel/resolved"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 32<br/><br/>
+
+    {"uris":[],"total":0,"offset":0}
+  </div>
+</p>
+
+<p>
+  Along with the usual metadata, many responses also provide discovery
+  information via
+  <a href="http://www.mnot.net/drafts/draft-nottingham-http-link-header-03.txt">Link Headers</a>
+  as shown above. These links allow user agents to find related resources. The
+  purpose of the above rel="resolved" Link Header is to offer a complete representation of
+  all documents in a collection as an alternative to the simple list of links provided above.
+  We'll look at the the result of using the "resolved" URI after we have created a few resources.
+</p>
+
+<p>
+Let's move on, creating a note using <a href="http://tools.ietf.org/html/rfc2616#section-9.5">POST</a>:
+  <div class="code">
+    $ curl -i -XPOST -d'{"title":"projects"}' http://localhost:9292/notes<br/>
+    HTTP/1.1 201 Created<br/>
+    Cache-Control: no-cache<br/>
+    Location: http://localhost:9292/notes/0dda06f0-b134-012b-a2d8-0017f2c62348<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 159<br/><br/>
+
+    {<br/>
+      "uri":"\/notes\/0dda06f0-b134-012b-a2d8-0017f2c62348",<br/>
+      "ok":true,<br/>
+      "etag":"0dda0de0-b134-012b-a2d8-0017f2c62348",<br/>
+      "last_modified":"Sun, 21 Dec 2008 02:21:52 GMT"<br/>
+    }
+  </div>
+</p>
+
+<p>
+Create a different note using <a href="http://tools.ietf.org/html/rfc2616#section-9.6">PUT</a>
+so that we can specify its location:
+  <div class="code">
+    $ curl -i -XPUT -d'{"title":"reminders"}' http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 201 Created<br/>
+    Cache-Control: no-cache<br/>
+    Location: http://localhost:9292/notes/abc<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 126<br/><br/>
+
+    {<br/>
+      "uri":"\/notes\/abc",<br/>
+      "ok":true,<br/>
+      "etag":"89487620-b134-012b-a2d8-0017f2c62348",<br/>
+      "last_modified":"Sun, 21 Dec 2008 02:25:19 GMT"<br/>
+    }
+  </div>
+</p>
+
+<p>
+View the new note:
+  <div class="code">
+    $ curl -i http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 200 OK<br/>
+    Last-Modified: Sun, 21 Dec 2008 02:25:19 GMT<br/>
+    ETag: "89487620-b134-012b-a2d8-0017f2c62348"<br/>
+    Link: &lt;http://localhost:9292/notes/abc/versions&gt;; rel="http://joncrosby.me/cloudkit/1.0/rel/versions"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 21<br/><br/>
+
+    {"title":"reminders"}
+  </div>
+</p>
+
+<p>
+Once again, we see a Link header. This one lists the location of the complete history
+of this particular document. This history contains all versions of the document including
+the most recent. We will see it in action in a moment.
+</p>
+
+<p>
+Next, attempt a careless update of our newest resource and enjoy the failure:
+  <div class="code">
+    $ curl -i -XPUT -d'{"title":"foo"}' http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 400 Bad Request<br/>
+    Cache-Control: no-cache<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 25<br/><br/>
+
+    {"error":"etag required"}
+  </div>
+</p>
+
+<p>
+Succeed in updating by being specific:
+  <div class="code">
+    $ curl -i -XPUT -H'If-Match:89487620-b134-012b-a2d8-0017f2c62348' -d'{"title":"foo"}' http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 200 OK<br/>
+    Cache-Control: no-cache<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 126<br/>
+    Connection: keep-alive<br/><br/>
+
+    {<br/>
+      "uri":"\/notes\/abc",<br/>
+      "ok":true,<br/>
+      "etag":"522be9f0-b135-012b-a2d8-0017f2c62348",<br/>
+      "last_modified":"Sun, 21 Dec 2008 02:30:56 GMT"<br/>
+    }
+  </div>
+</p>
+
+<p>
+(Note: Your <a href="http://tools.ietf.org/html/rfc2616#section-14.19">ETag</a>
+will likely be different so substitute the one that curl provided when you
+created your own "abc" resource.)
+</p>
+
+<p>
+Watch a secondary, out-of-date client fail at updating by being specific but also being stale:
+  <div class="code">
+    $ curl -i -XPUT -H'If-Match:89487620-b134-012b-a2d8-0017f2c62348' -d'{"title":"bar"}' http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 412 Precondition Failed<br/>
+    Cache-Control: no-cache<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 31<br/><br/>
+
+    {"error":"precondition failed"}
+  </div>
+</p>
+
+<p>
+A <a href="http://tools.ietf.org/html/rfc2616#section-10.4.13">412</a> code is
+returned indicating a precondition for this request failed. Specifically, the
+ETag was out of date. In this case, our second client can fall back on the
+resource's history to "catch up" and apply its changes to the most recent
+version of the resource.
+</p>
+
+<p>
+We can list all versions of the document using the URI tagged with rel="versions" in the
+link header mentioned above, reverse sorted by Last-Modified, feed style:
+  <div class="code">
+    $ curl -i http://localhost:9292/notes/abc/versions<br/>
+    HTTP/1.1 200 OK<br/>
+    Last-Modified: Sun, 21 Dec 2008 02:30:56 GMT<br/>
+    ETag: "28ecf6899a45d3cdd0ad82bad56991d1"<br/>
+    Link: &lt;http://localhost:9292/notes/abc/versions/_resolved&gt;; rel="http://joncrosby.me/cloudkit/1.0/rel/resolved"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 109<br/><br/>
+
+    {<br/>
+      "uris":[<br/>
+        "\/notes\/abc",<br/>
+        "\/notes\/abc\/versions\/89487620-b134-012b-a2d8-0017f2c62348"<br/>
+      ],<br/>
+      "total":2,<br/>
+      "offset":0<br/>
+    }
+  </div>
+</p>
+
+<p>
+List all versions again, this time using the "resolved" URI from the Link header.
+This effectively delivers the same information that would be obtained by first listing
+the URIs, then fetching each one of them individually.
+  <div class="code">
+    $ curl -i http://localhost:9292/notes/abc/versions/_resolved<br/>
+    HTTP/1.1 200 OK<br/>
+    Last-Modified: Sun, 21 Dec 2008 02:30:56 GMT<br/>
+    ETag: "282819afc09d7735fd6801532c0c7033"<br/>
+    Link: &lt;http://localhost:9292/notes/abc/versions&gt;; rel="index"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 390<br/><br/>
+
+    {<br/>
+      "documents":[<br/>
+        {<br/>
+          "etag":"522be9f0-b135-012b-a2d8-0017f2c62348",<br/>
+          "last_modified":"Sun, 21 Dec 2008 02:30:56 GMT",<br/>
+          "document":"{\"title\":\"foo\"}",<br/>
+          "uri":"\/notes\/abc"<br/>
+        },<br/>
+        {<br/>
+          "etag":"89487620-b134-012b-a2d8-0017f2c62348",<br/>
+          "last_modified":"Sun, 21 Dec 2008 02:25:19 GMT",<br/>
+          "document":"{\"title\":\"reminders\"}",<br/>
+          "uri":"\/notes\/abc\/versions\/89487620-b134-012b-a2d8-0017f2c62348"}<br/>
+      ],<br/>
+      "total":2,<br/>
+      "offset":0<br/>
+    }
+  </div>
+</p>
+
+<p>
+  Notice the resolved response includes a Link header pointing back to its index.
+</p>
+
+<p>
+  We can use this same "resolved" technique on the main "notes" listing:
+  <div class="code">
+    $ curl -i http://localhost:9292/notes/_resolved<br/>
+    HTTP/1.1 200 OK<br/>
+    Last-Modified: Sun, 21 Dec 2008 02:30:56 GMT<br/>
+    ETag: "6628242625a7f71cce838a02deb27912"<br/>
+    Link: &lt;http://localhost:9292/notes&gt; rel="index"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 374<br/><br/>
+
+    {<br/>
+      "documents":[<br/>
+        {<br/>
+          "etag":"522be9f0-b135-012b-a2d8-0017f2c62348",<br/>
+          "last_modified":"Sun, 21 Dec 2008 02:30:56 GMT",<br/>
+          "document":"{\"title\":\"foo\"}",<br/>
+          "uri":"\/notes\/abc"<br/>
+        },<br/>
+        {<br/>
+          "etag":"0dda0de0-b134-012b-a2d8-0017f2c62348",<br/>
+          "last_modified":"Sun, 21 Dec 2008 02:21:52 GMT",<br/>
+          "document":"{\"title\":\"projects\"}",<br/>
+          "uri":"\/notes\/0dda06f0-b134-012b-a2d8-0017f2c62348"<br/>
+        }<br/>
+      ],<br/>
+      "total":2,<br/>
+      "offset":0<br/>
+    }
+  </div>
+</p>
+
+<p>
+Next, let's delete the our most recent document:
+  <div class="code">
+    $ curl -i -XDELETE -H'If-Match:522be9f0-b135-012b-a2d8-0017f2c62348' http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 200 OK<br/>
+    Cache-Control: no-cache<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 174<br/><br/>
+
+    {<br/>
+      "uri":"\/notes\/abc\/versions\/522be9f0-b135-012b-a2d8-0017f2c62348",<br/>
+      "ok":true,<br/>
+      "etag":"522be9f0-b135-012b-a2d8-0017f2c62348",<br/>
+      "last_modified":"Sun, 21 Dec 2008 02:30:56 GMT"<br/>
+    }
+  </div>
+</p>
+
+<p>
+Try to GET it again and notice the helpful <a href="http://tools.ietf.org/html/rfc2616#section-10.4.11">410</a>:
+  <div class="code">
+    $ curl -i http://localhost:9292/notes/abc<br/>
+    HTTP/1.1 410 Gone<br/>
+    Link: &lt;http://localhost:9292/notes/abc/versions&gt;; rel="http://joncrosby.me/cloudkit/1.0/rel/versions"<br/>
+    Cache-Control: no-cache<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 37<br/><br/>
+
+    {"error":"entity previously deleted"}
+  </div>
+</p>
+
+<p>
+Notice the history is preserved:
+  <div class="code">
+    $ curl -i http://localhost:9292/notes/abc/versions<br/>
+    HTTP/1.1 200 OK<br/>
+    Last-Modified: Sun, 21 Dec 2008 02:30:56 GMT<br/>
+    ETag: "2308ee33e953c9be41221ff7612e5217"<br/>
+    Link: &lt;http://localhost:9292/notes/abc/versions/_resolved&gt;; rel="http://joncrosby.me/cloudkit/1.0/rel/resolved"<br/>
+    Cache-Control: proxy-revalidate<br/>
+    Content-Type: application/json<br/>
+    Content-Length: 157<br/><br/>
+
+    {<br/>
+      "uris":[<br/>
+        "\/notes\/abc\/versions\/522be9f0-b135-012b-a2d8-0017f2c62348",<br/>
+        "\/notes\/abc\/versions\/89487620-b134-012b-a2d8-0017f2c62348"<br/>
+      ],<br/>
+      "total":2,<br/>
+      "offset":0<br/>
+    }
+  </div>
+</p>
+</div>
+</body>
+</html>