careo-makura 0.1

data/lib/makura/plugin/pager.rb

@@ -0,0 +1,56 @@
+module Makura
+  module Plugin
+    module Pager
+      module SingletonMethods
+        def pager(page, limit)
+          Makura::Plugin::Pager::Pagination.new(self, :pager, page, limit)
+        end
+      end
+
+      class Pagination
+        def initialize(model, view, page, limit)
+          @model, @view, @page, @limit = model, view, page, limit
+        end
+
+        # /pager/_all_docs?count=10&group=true
+        # /pager/_all_docs?startkey=%224f9dca1c66121f9320a69553546db07a%22&startkey_docid=4f9dca1c66121f9320a69553546db07a&skip=1&descending=false&count=10&group=true
+        # /pager/_all_docs?startkey=%22_design%2FUser%22&startkey_docid=_design%2FUser&skip=1&descending=false&count=10&group=true
+        # /pager/_all_docs?startkey=%22d850f0801686b85035680bb6f38d5c5c%22&startkey_docid=d850f0801686b85035680bb6f38d5c5c&skip=1&descending=false&count=10&group=true
+
+        # NOTE:
+        #   * descending should be true if you page backwards
+
+        include Enumerable
+
+        def each(start_id = nil, descending = false, &block)
+          opts = {
+            :count => @limit,
+            :group => true,
+            :descending => descending,
+            # :include_docs => true,
+          }
+
+          if start_id
+            opts[:skip] = 1
+            opts[:startkey_docid] = start_id
+            opts[:startkey] = start_id
+          end
+
+          @model.view(@view, opts).each(&block)
+        end
+
+        def count
+        end
+
+        def first_page?
+        end
+
+        def last_page?
+        end
+
+        def empty?
+        end
+      end
+    end
+  end
+end

data/lib/makura/server.rb

@@ -0,0 +1,203 @@
+module Makura
+  class Server
+    include HTTPMethods
+    attr_accessor :uri, :cache_ttl, :cache_tries
+
+    COUCHDB_URI = 'http://localhost:5984'
+    CACHE_TTL = 5
+    CACHE_TRIES = 2
+
+    # Usage:
+    #   server = Makura::Server.new
+    #   #<URI::HTTP:0xb778ce38 URL:http://localhost:5984>
+    #   server.info
+    #   {"couchdb"=>"Welcome", "version"=>"0.9.0a718650-incubating"}
+
+    def initialize(uri = COUCHDB_URI, cache_ttl = CACHE_TTL, cache_tries = CACHE_TRIES)
+      @uri = URI(uri.to_s)
+      @cache_ttl = cache_ttl
+      @cache_tries = cache_tries
+      @uuids = UUIDCache.new(self)
+    end
+
+    def inspect
+      @uri.inspect
+    end
+
+    # General queries
+
+    # Answers with general couchdb info, looks like:
+    #
+    # Usage:
+    #   server.info
+    #   # {'couchdb' => 'Welcome', 'version' => '0.9.0a718650-incubating'}
+    def info
+      get('/')
+    end
+
+    # Answers with configuration info.
+    #
+    # Usage:
+    #   server.config
+    #
+    def config
+      get('/_config')
+    end
+
+    # Issue restart of the CouchDB daemon.
+    #
+    # Usage:
+    #   server.restart
+    #   # {'ok' => true}
+    def restart
+      post('/_restart')
+    end
+
+    # Array of names of databases on the server
+    #
+    # Usage:
+    #   server.databases
+    #   # ["another", "blog", "makura-spec"]
+    def databases
+      get('/_all_dbs')
+    end
+
+    # Return new database instance using this server instance.
+    #
+    # Usage:
+    #   foo = server.database('foo')
+    #   # #<Makura::Database 'http://localhost:5984/foo'>
+    #   server.databases
+    #   # ["another", "blog", "foo", "makura-spec"]
+
+    def database(name)
+      Database.new(self, name)
+    end
+
+    # Answers with an uuid from the UUIDCache.
+    #
+    # Usage:
+    #   server.next_uuid
+    #   # "55fdca746fa5a5b56f5270875477a2cc"
+
+    def next_uuid
+      @uuids.next
+    end
+
+    def start_cache(namespace = 'makura', *servers)
+      servers << 'localhost:11211' if servers.empty?
+      @cache = MemCache.new(servers, :namespace => namespace, :multithread => true)
+    end
+
+    def stop_cache
+      @cache = nil
+    end
+
+    def cached(request, ttl = cache_ttl, tries = cache_tries)
+      key = request[:url]
+
+      unless response = @cache.get(key)
+        response = execute(request)
+        @cache.add(key, response, ttl)
+      end
+
+      return response
+    rescue MemCache::MemCacheError => error
+      servers = @cache.servers.map{|s| "#{s.host}:#{s.port}"}
+      start_cache(@cache.namespace, *servers)
+      tries -= 1
+      retry if tries > 0
+      warn "[makura caching disabled] #{error.message}"
+      @cache = nil
+      execute(request)
+    end
+
+    # Helpers
+
+    def request(method, path, params = {})
+      keep_raw = params.delete(:raw)
+      payload = params.delete(:payload)
+      payload = payload.to_json if payload and not keep_raw
+      headers = {}
+
+      if content_type = params.delete('Content-Type')
+        headers['Content-Type'] = content_type
+      end
+
+      params.delete_if{|k,v| v.nil? }
+      uri = uri(path, params).to_s
+
+      request = {
+        :method => method,
+        :url => uri,
+        :payload => payload,
+        :headers => headers}
+
+      if @cache and request[:method] == :get
+        raw = cached(request)
+      else
+        raw = execute(request)
+      end
+
+      return raw if keep_raw
+      json = JSON.parse(raw)
+    rescue JSON::ParserError
+      return raw
+    rescue RestClient::RequestFailed => ex
+      raise appropriate_error(ex)
+    rescue RestClient::ResourceNotFound => ex
+      raise Error::ResourceNotFound, request[:url], ex.backtrace
+    rescue Errno::ECONNREFUSED
+      raise Error::ConnectionRefused, "Is CouchDB running at #{@uri}?"
+    end
+
+    def execute(request)
+      RestClient::Request.execute(request)
+    end
+
+    def appropriate_error(exception)
+      body = exception.response.body if exception.respond_to?(:response)
+      backtrace = exception.backtrace
+
+      raise(Error::RequestFailed, exception.message, backtrace) unless body
+      raise(Error::RequestFailed, exception.message, backtrace) if body.empty?
+
+      json = JSON.parse(body)
+      error, reason = json['error'], json['reason']
+
+      case error
+      when 'bad_request'
+        raise(Error::BadRequest, reason, backtrace)
+      when 'authorization'
+        raise(Error::Authorization, reason, backtrace)
+      when 'not_found'
+        raise(Error::NotFound, reason, backtrace)
+      when 'file_exists'
+        raise(Error::FileExists, reason, backtrace)
+      when 'missing_rev'
+        raise(Error::MissingRevision, reason, backtrace)
+      when 'conflict'
+        raise(Error::Conflict, reason, backtrace)
+      else
+        raise(Error::RequestFailed, json.inspect, backtrace)
+      end
+    end
+
+    JSON_PARAMS = %w[key startkey endkey]
+
+    def paramify(hash)
+      hash.map{|k,v|
+        k = k.to_s
+        v = v.to_json if JSON_PARAMS.include?(k)
+        "#{Makura.escape(k)}=#{Makura.escape(v)}"
+      }.join('&')
+    end
+
+    def uri(path = '/', params = {})
+      uri = @uri.dup
+      uri.path = (path[0,1] == '/' ? path : "/#{path}").squeeze('/')
+      uri.query = paramify(params) unless params.empty?
+      uri
+    end
+  end
+end

data/lib/makura/uuid_cache.rb

@@ -0,0 +1,23 @@
+module Makura
+  class UUIDCache
+    attr_accessor :min, :max, :server, :pretty
+
+    def initialize(server, min = 500, max = 1500, pretty = true)
+      @server, @min, @max, @pretty = server, min, max, pretty
+      @uuids = []
+    end
+
+    def next
+      fetch if @uuids.size < min
+      @uuids.shift
+    end
+
+    def fetch(count = 0)
+      todo = max - @uuids.size
+      count = [min, todo, max].sort[1]
+      uuids = @server.get('/_uuids', :count => count)['uuids']
+      uuids.map!{|u| Makura.pretty_from_md5(u) } if pretty
+      @uuids.concat(uuids)
+    end
+  end
+end

data/makura.gemspec

@@ -0,0 +1,41 @@
+Gem::Specification.new do |s|
+  s.name = "makura"
+  s.version = "0.1"
+
+  s.summary = "Ruby wrapper around the CouchDB REST API."
+  s.description = "Ruby wrapper around the CouchDB REST API."
+  s.platform = "ruby"
+  s.has_rdoc = true
+  s.author = "Michael 'manveru' Fellinger"
+  s.email = "m.fellinger@gmail.com"
+  s.homepage = "http://github.com/manveru/makura"
+  s.executables = ['makura']
+  s.bindir = "bin"
+  s.require_path = "lib"
+
+  s.add_dependency('rest-client', '>= 0.8.1')
+  s.add_dependency('json', '>= 1.1.3')
+
+  s.files = [
+    "COPYING",
+    "README.md",
+    "bin/makura",
+    "example/blog.rb",
+    "example/couch/map/author_all.js",
+    "example/couch/map/author_posts.js",
+    "example/couch/map/post_all.js",
+    "example/couch/map/post_comments.js",
+    "example/couch/reduce/sum_length.js",
+    "lib/makura/database.rb",
+    "lib/makura/design.rb",
+    "lib/makura/error.rb",
+    "lib/makura/http_methods.rb",
+    "lib/makura/layout.rb",
+    "lib/makura/model.rb",
+    "lib/makura/plugin/pager.rb",
+    "lib/makura/server.rb",
+    "lib/makura/uuid_cache.rb",
+    "lib/makura.rb",
+    "makura.gemspec"
+  ]
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: careo-makura
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Michael 'manveru' Fellinger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-13 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.3
+    version: 
+description: Ruby wrapper around the CouchDB REST API.
+email: m.fellinger@gmail.com
+executables: 
+- makura
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- COPYING
+- README.md
+- bin/makura
+- example/blog.rb
+- example/couch/map/author_all.js
+- example/couch/map/author_posts.js
+- example/couch/map/post_all.js
+- example/couch/map/post_comments.js
+- example/couch/reduce/sum_length.js
+- lib/makura/database.rb
+- lib/makura/design.rb
+- lib/makura/error.rb
+- lib/makura/http_methods.rb
+- lib/makura/layout.rb
+- lib/makura/model.rb
+- lib/makura/plugin/pager.rb
+- lib/makura/server.rb
+- lib/makura/uuid_cache.rb
+- lib/makura.rb
+- makura.gemspec
+has_rdoc: true
+homepage: http://github.com/manveru/makura
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Ruby wrapper around the CouchDB REST API.
+test_files: []
+