baccigalupi-aqua 0.1.4 → 0.1.5

data/Aqua.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{aqua}
-  s.version = "0.1.4"
+  s.version = "0.1.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Kane Baccigalupi"]
-  s.date = %q{2009-08-27}
+  s.date = %q{2009-08-31}
   s.description = %q{Even with ORMs like ActiveRecord, DataMapper which ease the pain of relational data storage, considerable developer effort goes into wrangling Ruby objects into their databases. Document-oriented databases have made it possible to store nested data structures that easily map to Ruby objects. Aqua (http://github.com/baccigalupi/aqua) is a new Ruby library that aims to painlessly persists objects, allowing developers to focus more on object oriented code and less on storage. Currently Aqua is in pre-alpha testing, with the following big things left to implement: A data query DSL and implementation; Support of all objects in the Standard Library; Class and code storage to allow the sharing and persistence of classes with their data.}
   s.email = %q{baccigalupi@gmail.com}
   s.extra_rdoc_files = [
@@ -40,8 +40,10 @@ Gem::Specification.new do |s|
      "doc/Aqua/Storage.html",
      "doc/Aqua/Store.html",
      "doc/Aqua/Store/CouchDB.html",
+     "doc/Aqua/Store/CouchDB/Attachments.html",
      "doc/Aqua/Store/CouchDB/Conflict.html",
      "doc/Aqua/Store/CouchDB/Database.html",
+     "doc/Aqua/Store/CouchDB/DesignDocument.html",
      "doc/Aqua/Store/CouchDB/RequestFailed.html",
      "doc/Aqua/Store/CouchDB/RequestTimeout.html",
      "doc/Aqua/Store/CouchDB/ResourceNotFound.html",
@@ -66,9 +68,11 @@ Gem::Specification.new do |s|
      "doc/Hash.html",
      "doc/OpenStruct.html",
      "doc/README.rdoc.html",
+     "doc/Range.html",
      "doc/Rational.html",
      "doc/RestAPI.html",
      "doc/RestClientAdapter.html",
+     "doc/Set.html",
      "doc/Time.html",
      "doc/TrueClass.html",
      "doc/all-files.html",
@@ -92,8 +96,10 @@ Gem::Specification.new do |s|
      "lib/aqua/object/stub.rb",
      "lib/aqua/object/tank.rb",
      "lib/aqua/object/unpack.rb",
+     "lib/aqua/store/couch_db/attachments.rb",
      "lib/aqua/store/couch_db/couch_db.rb",
      "lib/aqua/store/couch_db/database.rb",
+     "lib/aqua/store/couch_db/design_document.rb",
      "lib/aqua/store/couch_db/http_client/adapter/rest_client.rb",
      "lib/aqua/store/couch_db/http_client/rest_api.rb",
      "lib/aqua/store/couch_db/server.rb",
@@ -101,6 +107,7 @@ Gem::Specification.new do |s|
      "lib/aqua/store/storage.rb",
      "lib/aqua/support/initializers.rb",
      "lib/aqua/support/mash.rb",
+     "lib/aqua/support/set.rb",
      "lib/aqua/support/string_extensions.rb",
      "spec/aqua_spec.rb",
      "spec/object/config_spec.rb",
@@ -110,6 +117,7 @@ Gem::Specification.new do |s|
      "spec/object/object_fixtures/grounded.rb",
      "spec/object/object_fixtures/log.rb",
      "spec/object/object_fixtures/persistent.rb",
+     "spec/object/object_fixtures/sugar.rb",
      "spec/object/object_fixtures/user.rb",
      "spec/object/pack_spec.rb",
      "spec/object/query_spec.rb",
@@ -118,13 +126,17 @@ Gem::Specification.new do |s|
      "spec/object/unpack_spec.rb",
      "spec/spec.opts",
      "spec/spec_helper.rb",
+     "spec/store/couchdb/attachments_spec.rb",
      "spec/store/couchdb/couch_db_spec.rb",
      "spec/store/couchdb/database_spec.rb",
-     "spec/store/couchdb/document_fixture.rb",
+     "spec/store/couchdb/design_document_spec.rb",
+     "spec/store/couchdb/fixtures_and_data/document_fixture.rb",
+     "spec/store/couchdb/fixtures_and_data/image_attach.png",
      "spec/store/couchdb/server_spec.rb",
      "spec/store/couchdb/storage_methods_spec.rb",
      "utils/code_statistics.rb",
-     "utils/console"
+     "utils/console",
+     "utils/custom.css"
   ]
   s.has_rdoc = true
   s.homepage = %q{http://github.com/baccigalupi/aqua}
@@ -141,6 +153,7 @@ Gem::Specification.new do |s|
      "spec/object/object_fixtures/grounded.rb",
      "spec/object/object_fixtures/log.rb",
      "spec/object/object_fixtures/persistent.rb",
+     "spec/object/object_fixtures/sugar.rb",
      "spec/object/object_fixtures/user.rb",
      "spec/object/pack_spec.rb",
      "spec/object/query_spec.rb",
@@ -148,9 +161,11 @@ Gem::Specification.new do |s|
      "spec/object/tank_spec.rb",
      "spec/object/unpack_spec.rb",
      "spec/spec_helper.rb",
+     "spec/store/couchdb/attachments_spec.rb",
      "spec/store/couchdb/couch_db_spec.rb",
      "spec/store/couchdb/database_spec.rb",
-     "spec/store/couchdb/document_fixture.rb",
+     "spec/store/couchdb/design_document_spec.rb",
+     "spec/store/couchdb/fixtures_and_data/document_fixture.rb",
      "spec/store/couchdb/server_spec.rb",
      "spec/store/couchdb/storage_methods_spec.rb"
   ]

data/README.rdoc

@@ -6,13 +6,11 @@ Even with ORMs like ActiveRecord, DataMapper which ease the pain of relational d
 
 Currently Aqua is in pre-alpha testing, with the following big things left to implement: 
 * A data query DSL and implementation (yeah, ouch!) 
-* Support of all objects in the Standard Library 
 * Class and code storage to allow the sharing and persistence of classes with their data
 * Other storage systems, most notably a filestore, so that users can try Aqua out without having to install CouchDb
-* Object keys, including symbols for hash-like objects
 * Data storage amenity add-ons including: validation, callbacks, AR-styled syntax, and properties that automate some of the object typing, validation, and searchability option.   
 
-Aqua aims to be lean and modular, in addition to transparent. Currently it weighs in at 1000 lines of code with half of that for the CouchDB storage engine.
+Aqua aims to be lean and modular, in addition to transparent. Currently it weighs in at < 1200 lines of code with half of that for the CouchDB storage engine.
 
 == Usage 
 
@@ -76,7 +74,13 @@ Currently, Aqua uses CouchDB for its storage. Make sure you have CouchDB install
 Aqua is so young that it hasn't made it over to the established land of rubyforge. So for now you can install the gem by including github as a source, and then do a sudo gem install
 
   gem sources -a http://gems.github.com
-  sudo gem install baccigalupi-aqua
+  sudo gem install 'baccigalupi-aqua' 
+  
+Also, beware that Aqua has an unstated dependency: httpclient. The CouchDB engine was built with flexibility and speed in mind. The http_client gem seems like the best thing since sliced bread now, but may become outdated or slow comparatively. Developers are encouraged to build adapters to their preferred http clients. To do this please fork the project and request a pull once you have your adapter built and tested.
+
+Meanwhile, you will want to make sure that httpclient is available to Aqua.
+
+  sudo gem install 'httpclient'
 
 == More Info
 

data/VERSION

@@ -1 +1 @@
-0.1.4
+0.1.5

data/doc/Aqua.html

@@ -484,7 +484,7 @@ String with the full module name
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:25 PM by 
+  Generated on Monday, August 31 2009 at 03:23:22 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Config.html

@@ -103,7 +103,7 @@
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:24 PM by 
+  Generated on Monday, August 31 2009 at 03:23:20 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Config/ClassMethods.html

@@ -151,7 +151,7 @@
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:25 PM by 
+  Generated on Monday, August 31 2009 at 03:23:22 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/From.html

@@ -73,12 +73,12 @@ From
           <pre class="lines">
 
 
-24
-25
-26</pre>
+27
+28
+29</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/support/initializers.rb', line 24</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/support/initializers.rb', line 27</span>
 
 <span class='def def kw'>def</span> <span class='aqua_init identifier id'>aqua_init</span><span class='lparen token'>(</span> <span class='init identifier id'>init</span> <span class='rparen token'>)</span> 
   <span class='new identifier id'>new</span><span class='lparen token'>(</span> <span class='init identifier id'>init</span> <span class='rparen token'>)</span>
@@ -98,7 +98,7 @@ From
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:20 PM by 
+  Generated on Monday, August 31 2009 at 03:23:17 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/ObjectNotFound.html

@@ -25,7 +25,7 @@
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:21 PM by 
+  Generated on Monday, August 31 2009 at 03:23:17 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Pack.html

@@ -119,7 +119,7 @@ actual storage ivars. Aqua::Pack
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:23 PM by 
+  Generated on Monday, August 31 2009 at 03:23:21 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Pack/ClassMethods.html

@@ -231,7 +231,7 @@ persistance
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:23 PM by 
+  Generated on Monday, August 31 2009 at 03:23:20 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Pack/InstanceMethods.html

@@ -926,7 +926,7 @@ Saves object and raises an error on failure
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:22 PM by 
+  Generated on Monday, August 31 2009 at 03:23:18 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Query.html

@@ -99,7 +99,7 @@
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:21 PM by 
+  Generated on Monday, August 31 2009 at 03:23:22 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Query/ClassMethods.html

@@ -21,7 +21,7 @@
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:20 PM by 
+  Generated on Monday, August 31 2009 at 03:23:19 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Query/InstanceMethods.html

@@ -21,7 +21,7 @@
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:23 PM by 
+  Generated on Monday, August 31 2009 at 03:23:17 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Storage.html

@@ -91,7 +91,7 @@ configuration of a store
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:20 PM by 
+  Generated on Monday, August 31 2009 at 03:23:17 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Store.html

@@ -26,7 +26,7 @@ Store
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:23 PM by 
+  Generated on Monday, August 31 2009 at 03:23:17 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Store/CouchDB.html

@@ -247,12 +247,12 @@ depend on usefulness outside this.
           <pre class="lines">
 
 
-80
-81
-82</pre>
+82
+83
+84</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 80</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 82</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='clear_servers identifier id'>clear_servers</span>
   <span class='@servers ivar id'>@servers</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span>
@@ -328,14 +328,14 @@ converted
           <pre class="lines">
 
 
-113
-114
 115
 116
-117</pre>
+117
+118
+119</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 113</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 115</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='escape identifier id'>escape</span><span class='lparen token'>(</span> <span class='str identifier id'>str</span> <span class='rparen token'>)</span>
   <span class='str identifier id'>str</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span><span class='lparen token'>(</span><span class='string val'>'::'</span><span class='comma token'>,</span> <span class='string val'>'__'</span><span class='rparen token'>)</span>
@@ -405,12 +405,12 @@ A string identifier for the HTTP adapter in use
           <pre class="lines">
 
 
-18
-19
-20</pre>
+20
+21
+22</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 18</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 20</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='http_adapter identifier id'>http_adapter</span>
   <span class='@adapter ivar id'>@adapter</span> <span class='opasgn op'>||=</span> <span class='set_http_adapter identifier id'>set_http_adapter</span>
@@ -447,17 +447,17 @@ A string identifier for the HTTP adapter in use
           <pre class="lines">
 
 
-137
-138
 139
 140
 141
 142
 143
-144</pre>
+144
+145
+146</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 137</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 139</span>
 
 <span class='def def kw'>def</span> <span class='method_missing identifier id'>method_missing</span><span class='lparen token'>(</span> <span class='method identifier id'>method</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='args identifier id'>args</span> <span class='rparen token'>)</span>
   <span class='if if kw'>if</span> <span class='@adapter ivar id'>@adapter</span><span class='dot token'>.</span><span class='nil? fid id'>nil?</span>
@@ -510,8 +510,6 @@ query string.
           <pre class="lines">
 
 
-94
-95
 96
 97
 98
@@ -519,10 +517,12 @@ query string.
 100
 101
 102
-103</pre>
+103
+104
+105</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 94</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 96</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='paramify_url identifier id'>paramify_url</span><span class='lparen token'>(</span> <span class='url identifier id'>url</span><span class='comma token'>,</span> <span class='params identifier id'>params</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span> <span class='rparen token'>)</span>
   <span class='if if kw'>if</span> <span class='params identifier id'>params</span> <span class='andop op'>&amp;&amp;</span> <span class='notop op'>!</span><span class='params identifier id'>params</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
@@ -576,16 +576,16 @@ memory so that there is only one instance of a Server per namespace.
           <pre class="lines">
 
 
-68
-69
 70
 71
 72
 73
-74</pre>
+74
+75
+76</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 68</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 70</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='server identifier id'>server</span><span class='lparen token'>(</span> <span class='namespace identifier id'>namespace</span><span class='assign token'>=</span><span class='nil nil kw'>nil</span> <span class='rparen token'>)</span>
   <span class='namespace identifier id'>namespace</span> <span class='opasgn op'>||=</span> <span class='symbol val'>:aqua</span>
@@ -634,12 +634,12 @@ Cache of CouchDB Servers used by Aqua. Each is identified by its namespace.
           <pre class="lines">
 
 
-58
-59
-60</pre>
+60
+61
+62</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 58</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 60</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='servers identifier id'>servers</span>
   <span class='@servers ivar id'>@servers</span> <span class='opasgn op'>||=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span>
@@ -726,8 +726,6 @@ Name of HTTP Client Adapter module
           <pre class="lines">
 
 
-37
-38
 39
 40
 41
@@ -742,10 +740,12 @@ Name of HTTP Client Adapter module
 50
 51
 52
-53</pre>
+53
+54
+55</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 37</span>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/couch_db.rb', line 39</span>
 
 <span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='set_http_adapter identifier id'>set_http_adapter</span><span class='lparen token'>(</span> <span class='mod_string identifier id'>mod_string</span><span class='assign token'>=</span><span class='string val'>'RestClientAdapter'</span> <span class='rparen token'>)</span>
     
@@ -779,7 +779,7 @@ Name of HTTP Client Adapter module
 </div>
     </div>
     <div id="yard_info">
-  Generated on Thursday, August 27 2009 at 05:50:23 PM by 
+  Generated on Monday, August 31 2009 at 03:23:17 PM by 
   <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
   0.2.3.5 (ruby-1.8.6).
 </div>

data/doc/Aqua/Store/CouchDB/Attachments.html

@@ -0,0 +1,974 @@
+<!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="../../../custom.css" type="text/css" charset="utf-8" />
+<link rel="stylesheet" href="../../../syntax_highlight.css" type="text/css" charset="utf-8" />
+
+    <script src="../../../jquery.js" type="text/javascript" charset="utf-8"></script>
+    <script src="../../../app.js" type="text/javascript" charset="utf-8"></script>
+    <title>Class: Aqua::Store::CouchDB::Attachments</title>
+  </head>
+  <body>
+    <div id="content">
+      <div class="section class Aqua_Store_CouchDB_Attachments">
+  <h1 class="title">Class: Aqua::Store::CouchDB::Attachments</h1>
+  <div class="section inheritance">
+  <ul>
+  <li>Mash</li><ul><li>Aqua::Store::CouchDB::Attachments</li>
+  </ul></ul>
+</div><div class="section docstring">
+  <p>
+Attachments is a Hash-like container with keys that are attacment names and
+values that are file-type objects. Initializing and adding to the
+collection assures the types of both keys and values. The collection
+implements a lazy-loading scheme, such that when an attachment is requested
+and not found, it will try to load it from CouchDB. Attachments
+</p>
+
+</div><div class="section attributes">
+  <h1>Attributes</h1>
+
+  
+    <div class="instance">
+      <h2>Instance Attributes</h2>
+      <table>
+      
+        
+        <tr class="">
+          <th class='signature'>
+            <span class='name'>document</span>
+          </td>
+          <td class="readwrite">
+            [<span id='document-instance_method'>R</span>] 
+          </td>
+          <td class="visibility">
+            public
+          </td>
+          <td class="docstring">
+            <p>
+Returns the value of attribute <tt>document</tt>.
+</p>
+
+            
+          </td>
+        </tr>
+        
+      
+        
+        <tr class="">
+          <th class='signature'>
+            <span class='name'>stub</span>
+          </td>
+          <td class="readwrite">
+            [<span id='stub-instance_method'>R</span>] 
+          </td>
+          <td class="visibility">
+            public
+          </td>
+          <td class="docstring">
+            <p>
+Returns the value of attribute <tt>stub</tt>.
+</p>
+
+            
+          </td>
+        </tr>
+        
+      
+      </table>
+    </div>
+  
+</div>
+<div class="section constants">
+  
+</div><div class="section constructor">
+<h1>Constructor Summary</h1>
+  <div id="initialize-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'></span>
+      <span class='name'>initialize</span><span class='args'>(doc, hash = {})</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Creates a new attachment collection with keys that are attachment names and
+values that are file-type objects. The collection manages both the key and
+the value types.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="raise">
+  <h3>Raises:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>ArgumentError</tt>]</span>
+      
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'></span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+22
+23
+24
+25
+26
+27</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 22</span>
+
+<span class='def def kw'>def</span> <span class='initialize identifier id'>initialize</span><span class='lparen token'>(</span> <span class='doc identifier id'>doc</span><span class='comma token'>,</span> <span class='hash identifier id'>hash</span><span class='assign token'>=</span><span class='lbrace token'>{</span><span class='rbrace token'>}</span> <span class='rparen token'>)</span>
+  <span class='raise identifier id'>raise</span> <span class='ArgumentError constant id'>ArgumentError</span><span class='comma token'>,</span> <span class='string val'>&quot;must be initialized with a document&quot;</span> <span class='unless unless_mod kw'>unless</span> <span class='doc identifier id'>doc</span><span class='dot token'>.</span><span class='respond_to? fid id'>respond_to?</span><span class='lparen token'>(</span> <span class='symbol val'>:retrieve</span> <span class='rparen token'>)</span> 
+  <span class='@document ivar id'>@document</span> <span class='assign token'>=</span> <span class='doc identifier id'>doc</span>
+  <span class='self self kw'>self</span><span class='dot token'>.</span><span class='class identifier id'>class</span><span class='dot token'>.</span><span class='validate_hash identifier id'>validate_hash</span><span class='lparen token'>(</span> <span class='hash identifier id'>hash</span> <span class='rparen token'>)</span> <span class='unless unless_mod kw'>unless</span> <span class='hash identifier id'>hash</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+  <span class='super super kw'>super</span><span class='lparen token'>(</span> <span class='hash identifier id'>hash</span> <span class='rparen token'>)</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+</div>  <div class="section visibilitygroup public">
+    <h1>Public Visibility</h1>
+      <div class="section methodsummary class public">
+    <h1>Public Class Method Summary</h1>
+<table class="summary">
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#validate_hash-class_method" title="validate_hash">validate_hash</a></span><span class='args'>(hash)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Validates and throws an error on a hash, insisting that the key is a string
+or symbol, and the value is a file.
+</p>
+
+        
+      </td>
+    </tr>
+  
+</table>
+
+  </div>
+  <div class="section methodsummary instance public">
+    <h1>Public Instance Method Summary</h1>
+<table class="summary">
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#add-instance_method" title="#add">#add</a></span><span class='args'>(name, file)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Adds an attachment to the collection, checking for type.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#add%21-instance_method" title="#add!">#add!</a></span><span class='args'>(name, file)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Adds an attachment to the collection and to the database.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#delete%21-instance_method" title="#delete!">#delete!</a></span><span class='args'>(name)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Deletes an attachment from the collection, and from the database.
+</p>
+
+        
+          <p class='returns'>
+            Returns: 
+              <span class='return_types'>
+                 <tt>File</tt>
+              </span>
+          </p>
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#get-instance_method" title="#get">#get</a></span><span class='args'>(name, stream = false)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Gets an attachment from the collection first.
+</p>
+
+        
+          <p class='returns'>
+            Returns: 
+              <span class='return_types'>
+                 <tt>File</tt>
+              </span>
+          </p>
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#get%21-instance_method" title="#get!">#get!</a></span><span class='args'>(name, stream = false)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Gets an attachment from the database.
+</p>
+
+        
+          <p class='returns'>
+            Returns: 
+              <span class='return_types'>
+                 <tt>File</tt>
+              </span>
+          </p>
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#update_doc_rev-instance_method" title="#update_doc_rev">#update_doc_rev</a></span><span class='args'>(response)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Goes into the document and updates it&#8217;s rev to match the returned
+rev.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        
+          <span class='overload'>
+            <span class='name'><a href="#uri_for-instance_method" title="#uri_for">#uri_for</a></span><span class='args'>(name, include_rev = true)</span>
+            <span class='block'></span>
+          </span>
+        
+        
+      </th>
+      <td class="docstring">
+        <p>
+Constructs the standalone attachment uri for PUT and DELETE actions.
+</p>
+
+        
+      </td>
+    </tr>
+  
+</table>
+
+  </div>
+<div class="section methoddetails class public">
+  <h1>Public Class Method Details</h1>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>validate_hash</h3>
+</div><div id="validate_hash-class_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'></span>
+      <span class='name'>validate_hash</span><span class='args'>(hash)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Validates and throws an error on a hash, insisting that the key is a string
+or symbol, and the value is a file.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+132
+133
+134
+135
+136
+137</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 132</span>
+
+<span class='def def kw'>def</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='validate_hash identifier id'>validate_hash</span><span class='lparen token'>(</span> <span class='hash identifier id'>hash</span> <span class='rparen token'>)</span>
+  <span class='hash identifier id'>hash</span><span class='dot token'>.</span><span class='each identifier id'>each</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='file identifier id'>file</span><span class='bitor op'>|</span>
+    <span class='raise identifier id'>raise</span> <span class='ArgumentError constant id'>ArgumentError</span><span class='comma token'>,</span> <span class='dstring node'>&quot;Attachment name, #{name.inspect}, must be a Symbol or a String&quot;</span> <span class='unless unless_mod kw'>unless</span> <span class='lbrack token'>[</span><span class='Symbol constant id'>Symbol</span><span class='comma token'>,</span> <span class='String constant id'>String</span> <span class='rbrack token'>]</span><span class='dot token'>.</span><span class='include? fid id'>include?</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='dot token'>.</span><span class='class identifier id'>class</span> <span class='rparen token'>)</span>
+    <span class='raise identifier id'>raise</span> <span class='ArgumentError constant id'>ArgumentError</span><span class='comma token'>,</span> <span class='dstring node'>&quot;Attachment file, #{file.inspect}, must be a File-like object&quot;</span>  <span class='unless unless_mod kw'>unless</span> <span class='file identifier id'>file</span><span class='dot token'>.</span><span class='respond_to? fid id'>respond_to?</span><span class='lparen token'>(</span> <span class='symbol val'>:read</span> <span class='rparen token'>)</span> 
+  <span class='end end kw'>end</span>  
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+</div><div class="section methoddetails instance public">
+  <h1>Public Instance Method Details</h1>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>add</h3>
+</div><div id="add-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'></span>
+      <span class='name'>add</span><span class='args'>(name, file)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Adds an attachment to the collection, checking for type. Does not add
+directly to the database.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+35
+36
+37
+38</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 35</span>
+
+<span class='def def kw'>def</span> <span class='add identifier id'>add</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='file identifier id'>file</span> <span class='rparen token'>)</span>
+  <span class='self self kw'>self</span><span class='dot token'>.</span><span class='class identifier id'>class</span><span class='dot token'>.</span><span class='validate_hash identifier id'>validate_hash</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='file identifier id'>file</span> <span class='rparen token'>)</span>
+  <span class='self self kw'>self</span><span class='lbrack token'>[</span><span class='name identifier id'>name</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='file identifier id'>file</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>add!</h3>
+</div><div id="add!-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'></span>
+      <span class='name'>add!</span><span class='args'>(name, file)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Adds an attachment to the collection and to the database. Document
+doesn&#8217;t have to be saved, but it does need to have an id.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 47</span>
+
+<span class='def def kw'>def</span> <span class='add! fid id'>add!</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='file identifier id'>file</span> <span class='rparen token'>)</span>
+  <span class='add identifier id'>add</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='file identifier id'>file</span> <span class='rparen token'>)</span>
+  <span class='content_type identifier id'>content_type</span> <span class='assign token'>=</span> <span class='MIME constant id'>MIME</span><span class='colon2 op'>::</span><span class='Types constant id'>Types</span><span class='dot token'>.</span><span class='type_for identifier id'>type_for</span><span class='lparen token'>(</span><span class='file identifier id'>file</span><span class='dot token'>.</span><span class='path identifier id'>path</span><span class='rparen token'>)</span> 
+  <span class='content_type identifier id'>content_type</span> <span class='assign token'>=</span> <span class='content_type identifier id'>content_type</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span> <span class='integer val'>? </span><span class='string val'>'text\/plain'</span> <span class='colon op'>:</span> <span class='content_type identifier id'>content_type</span>
+  <span class='data identifier id'>data</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span>
+    <span class='string val'>'content-type'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='content_type identifier id'>content_type</span><span class='comma token'>,</span>
+    <span class='string val'>'data'</span>         <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='Base64 constant id'>Base64</span><span class='dot token'>.</span><span class='encode64 identifier id'>encode64</span><span class='lparen token'>(</span> <span class='file identifier id'>file</span><span class='dot token'>.</span><span class='read identifier id'>read</span> <span class='rparen token'>)</span><span class='dot token'>.</span><span class='gsub identifier id'>gsub</span><span class='lparen token'>(</span><span class='regexp val'>/\s/</span><span class='comma token'>,</span><span class='string val'>''</span><span class='rparen token'>)</span> 
+  <span class='rbrace token'>}</span>
+  <span class='response identifier id'>response</span> <span class='assign token'>=</span> <span class='CouchDB constant id'>CouchDB</span><span class='dot token'>.</span><span class='put identifier id'>put</span><span class='lparen token'>(</span> <span class='uri_for identifier id'>uri_for</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span> <span class='rparen token'>)</span><span class='comma token'>,</span> <span class='data identifier id'>data</span> <span class='rparen token'>)</span>
+  <span class='update_doc_rev identifier id'>update_doc_rev</span><span class='lparen token'>(</span> <span class='response identifier id'>response</span> <span class='rparen token'>)</span>
+  <span class='file identifier id'>file</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>delete!</h3>
+</div><div id="delete!-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'><tt>File</tt></span>
+      <span class='name'>delete!</span><span class='args'>(name)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Deletes an attachment from the collection, and from the database. Use
+#delete (from Hash) to just delete the attachment from the collection.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="return">
+  <h3>Returns:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>File</tt>, <tt>nil</tt>]</span>
+      
+      
+        <span class='name'></span>
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+File at that location or nil if no file found
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+67
+68
+69
+70
+71
+72
+73
+74
+75</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 67</span>
+
+<span class='def def kw'>def</span> <span class='delete! fid id'>delete!</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span> <span class='rparen token'>)</span>
+  <span class='if if kw'>if</span> <span class='self self kw'>self</span><span class='lbrack token'>[</span><span class='name identifier id'>name</span><span class='rbrack token'>]</span>
+    <span class='file identifier id'>file</span> <span class='assign token'>=</span> <span class='delete identifier id'>delete</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span> <span class='rparen token'>)</span> 
+    <span class='unless unless kw'>unless</span> <span class='document identifier id'>document</span><span class='dot token'>.</span><span class='new? fid id'>new?</span>
+      <span class='CouchDB constant id'>CouchDB</span><span class='dot token'>.</span><span class='delete identifier id'>delete</span><span class='lparen token'>(</span> <span class='uri_for identifier id'>uri_for</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span> <span class='rparen token'>)</span> <span class='rparen token'>)</span>
+    <span class='end end kw'>end</span> 
+    <span class='file identifier id'>file</span> 
+  <span class='end end kw'>end</span>  
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>get</h3>
+</div><div id="get-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'><tt>File</tt></span>
+      <span class='name'>get</span><span class='args'>(name, stream = false)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Gets an attachment from the collection first. If not found, it will be
+requested from the database.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="return">
+  <h3>Returns:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>File</tt>, <tt>nil</tt>]</span>
+      
+      
+        <span class='name'></span>
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+File for that name, or nil if not found in hash or in database
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+83
+84
+85
+86
+87
+88
+89</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 83</span>
+
+<span class='def def kw'>def</span> <span class='get identifier id'>get</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='stream identifier id'>stream</span><span class='assign token'>=</span><span class='false false kw'>false</span> <span class='rparen token'>)</span>
+  <span class='file identifier id'>file</span> <span class='assign token'>=</span> <span class='self self kw'>self</span><span class='lbrack token'>[</span><span class='name identifier id'>name</span><span class='rbrack token'>]</span> 
+  <span class='unless unless kw'>unless</span> <span class='file identifier id'>file</span>
+    <span class='file identifier id'>file</span> <span class='assign token'>=</span> <span class='get! fid id'>get!</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='stream identifier id'>stream</span> <span class='rparen token'>)</span>
+  <span class='end end kw'>end</span>
+  <span class='file identifier id'>file</span>  
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>get!</h3>
+</div><div id="get!-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'><tt>File</tt></span>
+      <span class='name'>get!</span><span class='args'>(name, stream = false)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Gets an attachment from the database. Stores it in the hash.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="return">
+  <h3>Returns:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>File</tt>, <tt>nil</tt>]</span>
+      
+      
+        <span class='name'></span>
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+File for that name, or nil if not found in the database
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+<div class="raise">
+  <h3>Raises:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>Object</tt>]</span>
+      
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+Any error encountered on retrieval of the attachment, json, http_client,
+Aqua etc
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+<div class="todo">
+  <h3>Todo Item:</h3>
+  <ul>
+  
+    <li><strong>make this more memory favorable, maybe streaming/saving in a max number of bytes</strong> </li>
+  
+  </ul>
+</div>
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+101
+102
+103
+104
+105
+106
+107
+108
+109
+110
+111
+112
+113</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 101</span>
+
+<span class='def def kw'>def</span> <span class='get! fid id'>get!</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='stream identifier id'>stream</span><span class='assign token'>=</span><span class='false false kw'>false</span> <span class='rparen token'>)</span> 
+  <span class='file identifier id'>file</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+  <span class='response identifier id'>response</span> <span class='assign token'>=</span> <span class='CouchDB constant id'>CouchDB</span><span class='dot token'>.</span><span class='get identifier id'>get</span><span class='lparen token'>(</span> <span class='uri_for identifier id'>uri_for</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='false false kw'>false</span> <span class='rparen token'>)</span> <span class='rparen token'>)</span> <span class='rescue rescue kw'>rescue</span> <span class='nil nil kw'>nil</span>
+  <span class='data identifier id'>data</span> <span class='assign token'>=</span> <span class='Base64 constant id'>Base64</span><span class='dot token'>.</span><span class='decode64 identifier id'>decode64</span><span class='lparen token'>(</span> <span class='response identifier id'>response</span><span class='lbrack token'>[</span><span class='string val'>'data'</span><span class='rbrack token'>]</span> <span class='rparen token'>)</span> <span class='if if_mod kw'>if</span> <span class='response identifier id'>response</span> 
+  <span class='if if kw'>if</span> <span class='data identifier id'>data</span>
+    <span class='file identifier id'>file</span> <span class='assign token'>=</span> <span class='Tempfile constant id'>Tempfile</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span> <span class='CGI constant id'>CGI</span><span class='dot token'>.</span><span class='escape identifier id'>escape</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span> <span class='rparen token'>)</span> <span class='rparen token'>)</span> 
+    <span class='file identifier id'>file</span><span class='dot token'>.</span><span class='binmode identifier id'>binmode</span> <span class='if if_mod kw'>if</span> <span class='file identifier id'>file</span><span class='dot token'>.</span><span class='respond_to? fid id'>respond_to?</span><span class='lparen token'>(</span> <span class='symbol val'>:binmode</span> <span class='rparen token'>)</span>
+    <span class='file identifier id'>file</span><span class='dot token'>.</span><span class='write identifier id'>write</span><span class='lparen token'>(</span> <span class='data identifier id'>data</span> <span class='rparen token'>)</span>
+    <span class='file identifier id'>file</span><span class='dot token'>.</span><span class='rewind identifier id'>rewind</span> 
+    <span class='self self kw'>self</span><span class='lbrack token'>[</span><span class='name identifier id'>name</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='file identifier id'>file</span>
+  <span class='end end kw'>end</span>  
+  <span class='stream identifier id'>stream</span> <span class='integer val'>? </span><span class='file identifier id'>file</span><span class='dot token'>.</span><span class='read identifier id'>read</span> <span class='colon op'>:</span> <span class='file identifier id'>file</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>update_doc_rev</h3>
+</div><div id="update_doc_rev-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'></span>
+      <span class='name'>update_doc_rev</span><span class='args'>(response)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Goes into the document and updates it&#8217;s rev to match the returned
+rev. That way #new? will return false when an attachment is created before
+the document is saved. It also means that future attempts to save the doc
+won&#8217;t fail with a conflict.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+    
+      <dt>
+        <span class='type'>[<tt><a href="../../../Hash.html" title="Hash">Hash</a></tt>]</span>
+        <span class='name'>response</span>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+from the put request
+</p>
+</span>
+      </dd>
+    
+  
+  </dl>
+</div>
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+145
+146
+147</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 145</span>
+
+<span class='def def kw'>def</span> <span class='update_doc_rev identifier id'>update_doc_rev</span><span class='lparen token'>(</span> <span class='response identifier id'>response</span> <span class='rparen token'>)</span>
+  <span class='document identifier id'>document</span><span class='lbrack token'>[</span><span class='symbol val'>:_rev</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='response identifier id'>response</span><span class='lbrack token'>[</span><span class='string val'>'rev'</span><span class='rbrack token'>]</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>uri_for</h3>
+</div><div id="uri_for-instance_method" class="section method">
+  <div class="details_title">
+    <div class='section methodsignature'>
+    <tt class='def'>
+      <span class='visibility'>public</span>
+      <span class='return_types'></span>
+      <span class='name'>uri_for</span><span class='args'>(name, include_rev = true)</span>
+      <span class='block'></span>
+    </tt>
+  </div>
+
+</div><div class="section docstring">
+  <p>
+Constructs the standalone attachment uri for PUT and DELETE actions.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="raise">
+  <h3>Raises:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>ArgumentError</tt>]</span>
+      
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'></span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+120
+121
+122
+123</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/aqua/store/couch_db/attachments.rb', line 120</span>
+
+<span class='def def kw'>def</span> <span class='uri_for identifier id'>uri_for</span><span class='lparen token'>(</span> <span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='include_rev identifier id'>include_rev</span> <span class='assign token'>=</span> <span class='true true kw'>true</span> <span class='rparen token'>)</span>
+  <span class='raise identifier id'>raise</span> <span class='ArgumentError constant id'>ArgumentError</span><span class='comma token'>,</span> <span class='string val'>'Document must have id in order to save an attachment'</span> <span class='if if_mod kw'>if</span> <span class='document identifier id'>document</span><span class='dot token'>.</span><span class='id identifier id'>id</span><span class='dot token'>.</span><span class='nil? fid id'>nil?</span> <span class='orop op'>||</span> <span class='document identifier id'>document</span><span class='dot token'>.</span><span class='id identifier id'>id</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+  <span class='document identifier id'>document</span><span class='dot token'>.</span><span class='uri identifier id'>uri</span> <span class='plus op'>+</span> <span class='dstring node'>&quot;/#{CGI.escape( name.to_s )}&quot;</span> <span class='plus op'>+</span> <span class='lparen token'>(</span> <span class='document identifier id'>document</span><span class='dot token'>.</span><span class='rev identifier id'>rev</span> <span class='andop op'>&amp;&amp;</span> <span class='include_rev identifier id'>include_rev</span> <span class='integer val'>? </span><span class='dstring node'>&quot;?rev=#{document.rev}&quot;</span> <span class='colon op'>:</span> <span class='string val'>&quot;&quot;</span> <span class='rparen token'>)</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+</div>
+  </div>
+
+</div>
+    </div>
+    <div id="yard_info">
+  Generated on Monday, August 31 2009 at 03:23:18 PM by 
+  <abbr class="yard" title="Yay! A Ruby Documentation Tool"><a href="http://yard.soen.ca">YARD</a></abbr> 
+  0.2.3.5 (ruby-1.8.6).
+</div>
+
+  </body>
+</html>