Working with the New Gem

‹prev | My Chain | next›

I continue working on couch_design_docs, a gem to load javascript files from the file system into my CouchDB store as design docs.

Creating a gemspec (needed by github) is easy with bones:

cstrom@jaynestown:~/repos/couch_design_docs$ rake gem:spec
(in /home/cstrom/repos/couch_design_docs)
cstrom@jaynestown:~/repos/couch_design_docs$ git status
# On branch master
# Untracked files:
#   (use "git add ..." to include in what will be committed)
#
#       couch_design_docs.gemspec

After pushing the changes to github and a little wait, I can now install my own gem:

cstrom@jaynestown:~$ gem install eee-c-couch_design_docs
WARNING:  Installing to ~/.gem since /usr/lib/ruby/gems/1.8 and
          /usr/bin aren't both writable.
Successfully installed eee-c-couch_design_docs-1.0.0
1 gem installed

I could also have installed from my local copy using bones's rake gem:install.

With the gem installed, I can take it for a ride:

cstrom@jaynestown:~/repos/eee-code$ irb
>> require 'couch_design_docs'
=> true

Cool! That was easy enough. To instantiate a Store object:

>> store = CouchDesignDocs::Store.new("http://localhost:5984/eee")
=> #<CouchDesignDocs::Store:0xb7a07c58 @url="http://localhost:5984/eee">

And a local document store:

>> dir = CouchDesignDocs::Directory.new("/home/cstrom/repos/eee-code/couch/_design")
=> #<CouchDesignDocs::Directory:0xb7970948 @couch_view_dir="/home/cstrom/repos/eee-code/couch/_design">
>> dir.to_hash
=> {"lucene"=>{"transform"=>"function(doc) { … }"}}

Nice! So, can I get the store to upload the design document?

>> store.load(dir.to_hash)
RestClient::RequestFailed: HTTP status code 409
        from /usr/lib/ruby/gems/1.8/gems/rest-client-1.0/lib/restclient/request.rb:193:in `process_result'
        from /usr/lib/ruby/gems/1.8/gems/rest-client-1.0/lib/restclient/request.rb:123:in `transmit'
        from /usr/lib/ruby/1.8/net/http.rb:543:in `start'
…

Conflict, bummer. That is something missing from the gem—the ability to replace existing documents. For now, I will manually delete the couchdb-lucene design document:



With that, I can retry:

>> store.load(dir.to_hash)
=> {"lucene"=>{"transform"=>"function(doc) { … }" }}

Yay! The .js file from the filesystem was actually PUT in the CouchDB data store as desired.

I spend a little more time with the document store class—driving by example the ability to replace an existing design document. I hope to be able to finish up the gem tomorrow by adding some convenience methods and the ability to replace existing documents.
(commit)