jmoses-couchbase 1.3.6

data/Rakefile

@@ -0,0 +1,20 @@
+# Author:: Couchbase <info@couchbase.com>
+# Copyright:: 2011, 2012 Couchbase, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+Dir['tasks/*.rake'].sort.each { |f| load f }
+
+task :default => [:clobber, :compile, :test]

data/couchbase.gemspec

@@ -0,0 +1,49 @@
+# -*- encoding: utf-8 -*-
+# Author:: Couchbase <info@couchbase.com>
+# Copyright:: 2011, 2012 Couchbase, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+$:.push File.expand_path('../lib', __FILE__)
+require 'couchbase/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'jmoses-couchbase'
+  s.version     = Couchbase::VERSION
+  s.author      = ['Couchbase', 'Jon Moses']
+  s.email       = ['support@couchbase.com', 'jon@burningbush.us']
+  s.license     = 'ASL-2'
+  s.homepage    = 'http://couchbase.org'
+  s.summary     = %q{Couchbase ruby driver (updated gemspec for connection-pool 2)}
+  s.description = %q{The official client library for use with Couchbase Server.  This fork has been updated to require connection-pool 2.0, instead of 1.0}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.extensions    = `git ls-files -- ext/**/extconf.rb`.split("\n")
+  s.require_paths = ['lib']
+
+  s.add_runtime_dependency 'yaji', '~> 0.3', '>= 0.3.2'
+  s.add_runtime_dependency 'multi_json', '~> 1.0'
+  s.add_runtime_dependency 'connection_pool', '~> 2.0.0'
+
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'minitest', '~> 5.0', '>= 5.0.4'
+  s.add_development_dependency 'rake-compiler', '~> 0.7', '>= 0.7.5'
+  s.add_development_dependency 'mini_portile', '~> 0.5', '>= 0.5.2'
+  s.add_development_dependency 'yajl-ruby', '~> 1.1', '>= 1.1.0'
+  s.add_development_dependency 'active_support'
+  s.add_development_dependency 'eventmachine'
+end

data/examples/chat-em/Gemfile

@@ -0,0 +1,7 @@
+source :rubygems
+
+gem 'eventmachine'
+
+# couchbase dependencies
+gem 'yaji'
+gem 'multi_json'

data/examples/chat-em/README.markdown

@@ -0,0 +1,45 @@
+# Chat Demo
+
+This is simple demo of the chat built on EventMachine, and using
+Couchbase to store logs.
+
+# Quick Start and Usage
+
+Navigate to the example directory and install dependencies:
+
+    $ cd examples/chat-em
+    $ bundle install
+
+Execute the server
+
+    $ ruby ./server.rb
+    Hi, this is simple chat server based on EventMachine.
+    To join, just use your telnet or netcat clients to connect to
+    port 9999 on this machine. Press Ctrl-C to stop it.
+
+Use telnet to join the chat
+
+    $ telnet localhost 9999
+    Trying 127.0.0.1...
+    Connected to localhost.
+    Escape character is '^]'.
+    *** What is your name?
+    avsej
+    *** Hi, avsej!
+    Hi everyone in this chat
+
+The server will broadcast all your messages and record any event to
+the Couchbase server. If your server hosted not on the localhost or
+using bucket different from "default" you might want to change the
+connection options at the bottom of the `server.rb`, for example in
+this case it will connect to the bucket "protected" with password
+"secret".
+
+    Couchbase.connection_options = {
+                :async => true,
+                :engine => :eventmachine,
+                :bucket => "protected",
+                :password => "secret"
+              }
+
+Happy hacking!

data/examples/chat-em/server.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/env ruby
+["/../../lib", "/.."].each do |path|
+  $LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + path))
+end
+
+require 'bundler'
+Bundler.require
+
+require 'couchbase'
+
+class ChatServer < EM::Connection
+
+  @@clients = []
+
+  def log(message, author = nil)
+    Couchbase.bucket.incr("log:key", :initial => 1) do |res|
+      entry = {
+        'time' => Time.now.utc,
+        'author' => author || "[system]",
+        'message' => message
+      }
+      Couchbase.bucket.set("log:#{res.value}", entry)
+    end
+  end
+
+  def post_init
+    @username = nil
+    send_data("*** What is your name?\n")
+  end
+
+  def receive_data(data)
+    if @username
+      broadcast(data.strip, @username)
+    else
+      name = data.gsub(/\s+|[\[\]]/, '').strip[0..20]
+      if name.empty?
+        send_data("*** What is your name?\n")
+      else
+        @username = name
+        @@clients.push(self)
+        broadcast("#{@username} has joined")
+        send_data("*** Hi, #{@username}!\n")
+      end
+    end
+  end
+
+  def unbind
+    @@clients.delete(self)
+    broadcast("#{@username} has left") if @username
+  end
+
+  def broadcast(message, author = nil)
+    prefix = author ? "<#{@username}>" : "***"
+    log(message, author)
+    @@clients.each do |client|
+      unless client == self
+        client.send_data("#{prefix} #{message}\n")
+      end
+    end
+  end
+
+end
+
+EventMachine.run do
+  # hit Control + C to stop
+  Signal.trap("INT")  { EventMachine.stop }
+  Signal.trap("TERM") { EventMachine.stop }
+
+  Couchbase.connection_options = {:async => true, :engine => :eventmachine}
+  Couchbase.bucket.on_connect do |res|
+    if res.success?
+      puts(<<-MOTD.gsub(/^\s+/, ''))
+        Hi, this is simple chat server based on EventMachine.
+        To join, just use your telnet or netcat clients to connect to
+        port 9999 on this machine. Press Ctrl-C to stop it.
+      MOTD
+      EventMachine.start_server("0.0.0.0", 9999, ChatServer)
+    else
+      puts "Cannot connect to Couchbase Server: #{res.error}"
+    end
+  end
+end

data/examples/chat-goliath-grape/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'couchbase'
+gem 'goliath'
+gem 'grape'

data/examples/chat-goliath-grape/README.markdown

@@ -0,0 +1,50 @@
+# Couchbase + Grape + Goliath = <3
+
+This demo shows how to integrate these cool things to build
+asynchronous REST service
+
+# Usage
+
+1. Clone the repository. Navigate to `examples/chat-goliath-grape/`
+   directory
+
+2. Install libcouchbase (http://www.couchbase.com/develop/c/current).
+   For MacOS users it will look like:
+
+        brew update
+        brew install libcouchbase
+
+3. Install all ruby dependencies. This demo has been tested on latest
+   stable version of ruby (`ruby 2.0.0p0 (2013-02-24 revision 39474)
+   [x86_64-linux]`)
+
+        gem install bundler
+        bundle install
+
+4. Setup your Couchbase server
+   (http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-getting-started.html).
+   It should have `default` bucket. Or you can edit connection options
+   in `config/app.rb` file.
+
+5. Start the server up
+
+        ruby app.rb -sv
+
+6. Create an message:
+
+        $ curl -X POST -Fmessage="Hello world" http://localhost:9000/messages
+        {"ok":true,"id":"msg:1","cas":11880713153673363456}
+
+7. If you create a design document called `messages` and put a view
+   named `all` with this map function:
+
+        function(doc, meta) {
+          if (doc.timestamp) {
+           emit(meta.id, doc)
+          }
+        }
+
+   You can fetch all messages with this command:
+
+        curl -X GET http://localhost:9000/messages
+        {"ok":true,"messages":[{"id":"msg:1","key":"msg:1","value":{"timestamp":"2013-04-11T12:43:42+03:00","message":"Hello world"},"cas":11880713153673363456}]}

data/examples/chat-goliath-grape/app.rb

@@ -0,0 +1,67 @@
+# Author:: Couchbase <info@couchbase.com>
+# Copyright:: 2013 Couchbase, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'em-synchrony'
+require 'couchbase'
+require 'goliath'
+require 'grape'
+require 'date'
+
+class Chat < Grape::API
+
+  format :json
+
+  resource 'messages' do
+    get do
+      view = env.couchbase.design_docs["messages"].all(:include_docs => true)
+      msgs = view.map do |r|
+        {
+          "id" => r.id,
+          "key" => r.key,
+          "value" => r.value,
+          "cas" => r.meta["cas"],
+          # "doc" => r.doc
+        }
+      end
+      {"ok" => true, "messages" => msgs}
+    end
+
+    post do
+      payload = {
+        "timestamp" => DateTime.now.iso8601,
+        "message" => params["message"]
+      }
+      id = env.couchbase.incr("msgid", :initial => 1)
+      id = "msg:#{id}"
+      cas = env.couchbase.set(id, payload)
+      {"ok" => true, "id" => id, "cas" => cas}
+    end
+  end
+
+end
+
+class App < Goliath::API
+  def response(env)
+    Chat.call(env)
+  rescue => e
+    [
+      500,
+      {'Content-Type' => 'application/json'},
+      MultiJson.dump(:error => e, :stacktrace => e.backtrace)
+    ]
+  end
+end

data/examples/chat-goliath-grape/config/app.rb

@@ -0,0 +1,20 @@
+# Author:: Couchbase <info@couchbase.com>
+# Copyright:: 2013 Couchbase, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+config['couchbase'] = EventMachine::Synchrony::ConnectionPool.new(:size => 5) do
+  Couchbase::Bucket.new(:engine => :eventmachine)
+end

data/examples/transcoders/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gem 'couchbase'

data/examples/transcoders/README.markdown

@@ -0,0 +1,59 @@
+# Gzip Transcoder
+
+This example demonstrates advanced usage of client-side transcoders.
+In particular it uses GzipWriter and GzipReader classes from ruby
+standard library to keep documents compressed. The example shows basic
+technique, so that it can be used as a starting point to write your
+custom data filters and adaptors.
+
+## Usage
+
+1. Clone the repository. Navigate to directory `examples/transcoders`.
+
+2. Install libcouchbase (http://www.couchbase.com/develop/c/current).
+   For MacOS users it will look like:
+
+        brew update
+        brew install libcouchbase
+
+3. Install all ruby dependencies. This demo has been tested on latest
+   stable version of ruby (`ruby 2.0.0p0 (2013-02-24 revision 39474)
+   [x86_64-linux]`)
+
+        gem install bundler
+        bundle install
+
+4. Setup your Couchbase server
+   (http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-getting-started.html).
+   It should have `default` bucket. Or you can specify different
+   bucket using CLI options.
+
+5. Store some file to the cluster:
+
+        $ ./cb-zcp Gemfile
+        Run with arguments: {:bucket=>"default", :hostname=>"127.0.0.1", :port=>8091, :username=>nil, :password=>nil}
+        store "Gemfile" ... ok
+
+6. Get the data back:
+
+        $ ./cb-zcat Gemfile
+        Run with arguments: {:bucket=>"default", :hostname=>"127.0.0.1", :port=>8091, :username=>nil, :password=>nil}
+        Gemfile:
+        source 'https://rubygems.org'
+
+        gem 'couchbase'
+
+7. To make sure that the data is in compressed state, you can check it in `irb`:
+
+        $ bundle exec irb
+        2.0.0p0 (main):001:0> require 'couchbase'
+        true
+        2.0.0p0 (main):002:0> conn = Couchbase.connect(:transcoder => nil)
+        #<Couchbase::Bucket:0x007fa344886fc8 "http://localhost:8091/pools/default/buckets/default/" transcoder=nil, default_flags=0x0, quiet=false, connected=true, timeout=2500000>
+        2.0.0p0 (main):003:0> File.open("Gemfile.gz", "w+"){|f| f.write(conn.get("Gemfile"))}
+        65
+
+        $ zcat Gemfile.gz
+        source 'https://rubygems.org'
+
+        gem 'couchbase'

data/examples/transcoders/cb-zcat

@@ -0,0 +1,40 @@
+#!/usr/bin/env ruby
+# Author:: Couchbase <info@couchbase.com>
+# Copyright:: 2013 Couchbase, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'bundler'
+Bundler.setup
+
+require 'couchbase'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'gzip_transcoder'
+require 'options'
+
+STDERR.puts "Run with arguments: #{OPTIONS.inspect}"
+begin
+  conn = Couchbase.connect(OPTIONS)
+  conn.transcoder = GzipTranscoder.new
+
+  ARGV.each do |filename|
+    STDERR.puts "#{filename}:"
+    STDOUT.puts(conn.get(filename))
+  end
+rescue Couchbase::Error::Base => ex
+  STDERR.puts "ERROR: #{ex}"
+  exit 1
+end