couchbase 2.0.0.pre.1-java

checksums.yaml

@@ -0,0 +1,15 @@
+---
+SHA1:
+  metadata.gz: !binary |-
+    ZGM3OWI3NzQ3ODBjNWJiYzdhMmVlMjFhYzk5ZGE2ZjQ2ZTRlYjZkZg==
+  data.tar.gz: !binary |-
+    MzQ5ZTFhMmNmZjAwMzQzOWM4NDcyMjcxZGYyNzZhMGIyYzNkOWNlMg==
+SHA512:
+  metadata.gz: !binary |-
+    NGRiNmI0NGVhODBhMTU3ODE4NzJmMzFhZTUyYmNmOTU3N2NmYWJmNjI3NjQ5
+    Yzg3YzY5ZTk1MGU0YTM1YTg4Y2Y4NDJhM2YyYzdhNGUzZTVhYTlhYjI2OThk
+    OWJiN2M0MGIwMzc3Y2M4MzY0ZmM3ZTQyYjNkYjZjMTlhYWFhZjE=
+  data.tar.gz: !binary |-
+    ZjUxNmJiMjhhMjdhYjM2NWUwNGNiZDIwNjcwMmE0NzZhODA4OGJjNzk0MGRl
+    YTBlYmY3ZDZjNGUwZTllNWY4YzE1MTVjNDI3ZjFlODRlMGIxNDZjN2ZjY2Nl
+    NjYwODRkNDE3MWM2NmM3Njc0MzZmMjMxOGUxOGYzOTU3NWVjYWU=

data/.gitignore

@@ -0,0 +1,15 @@
+*.bundle
+*.gem
+*.so
+.timestamp
+.yardoc
+Gemfile.lock
+core*
+doc/
+ext/couchbase/Makefile
+ext/couchbase/mkmf.log
+lib/couchbase_ext.rb
+pkg/*
+ports
+test/CouchbaseMock.jar
+tmp

data/.travis.yml

@@ -0,0 +1,22 @@
+before_install:
+  - sudo rm -rf /etc/apt/sources.list.d/couchdb-ppa-source.list
+  - sudo rm -rf /etc/apt/sources.list.d/mongodb.list
+  - sudo rm -rf /etc/apt/sources.list.d/datastax-source.list
+  - sudo rm -rf /etc/apt/sources.list.d/rabbitmq-source.list
+  - sudo rm -rf /etc/apt/sources.list.d/mapopa-source.list
+  - sudo rm -rf /etc/apt/sources.list.d/webupd8team-java-ppa-source.list
+  - sudo rm -rf /etc/apt/sources.list.d/maven3-ppa-source.list
+  - wget -O- http://packages.couchbase.com/ubuntu/couchbase.key | sudo apt-key add -
+  - echo deb http://packages.couchbase.com/snapshot/ubuntu oneiric oneiric/main | sudo tee /etc/apt/sources.list.d/couchbase.list
+  - sudo apt-get update
+  - sudo apt-get -y install libcouchbase2-dev
+
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ree
+
+notifications:
+  email:
+    - sergey@couchbase.com

data/.yardopts

@@ -0,0 +1,5 @@
+--protected
+--no-private
+-
+README.markdown
+RELEASE_NOTES.markdown

data/CONTRIBUTING.markdown

@@ -0,0 +1,75 @@
+We've decided to use "gerrit" for our code review system, making it
+easier for all of us to contribute with code and comments.
+
+  1. Visit http://review.couchbase.org and "Register" for an account
+  2. Review http://review.couchbase.org/static/individual_agreement.html
+  3. Agree to agreement by visiting http://review.couchbase.org/#/settings/agreements
+  4. If you do not receive an email, please contact us
+  5. Check out the `couchbase-ruby-client` area http://review.couchbase.org/#/q/status:open+project:couchbase-ruby-client,n,z
+  6. Join us on IRC at #libcouchbase on Freenode :-)
+
+We normally don't go looking for stuff in gerrit, so you should add at
+least me `"Sergey Avseyev" <sergey.avseyev@gmail.com>` as a reviewer
+for your patch (and I'll know who else to add and add them for you).
+
+## Contributing Using Repo Tool
+
+Follow ["Uploading Changes" guide][1] on the site if you have some code to contribute.
+
+All you should need to set up your development environment should be:
+
+    ~ % mkdir couchbase-ruby
+    ~ % cd couchbase-ruby
+    ~/couchbase-ruby % repo init -u git://github.com/trondn/manifests.git -m ruby.xml
+    ~/couchbase-ruby % repo sync
+    ~/couchbase-ruby % repo start my-branch-name --all
+    ~/couchbase-ruby % make
+
+This will build the latest version of `libcouchbase`,
+`couchbase-ruby-client` and `couchbase-ruby-client` libraries. You must
+have a C and C++ compiler installed, automake, autoconf.
+
+If you have to make any changes just commit them before you upload
+them to gerrit with the following command:
+
+    ~/couchbase-ruby/client % repo upload
+
+You might experience a problem trying to upload the patches if you've
+selected a different login name at http://review.couchbase.org than
+your login name. Don't worry, all you need to do is to add the
+following to your ~/.gitconfig file:
+
+    [review "review.couchbase.org"]
+        username = YOURNAME
+
+## Contributing Using Plain Git
+
+If you not so familiar with repo tool and its workflow there is
+alternative way to do the same job. Lets assume you have installed
+couchbase gem and libcouchbase from official packages and would you to
+contribute to couchbase-client gem only. Then you just need to complete
+gerrit registration steps above and clone the source repository
+(remember the repository on github.com is just a mirror):
+
+    ~ % git clone ssh://YOURNAME@review.couchbase.org:29418/couchbase-ruby-client.git
+
+Install [`commit-msg` hook][2]:
+
+    ~/couchbase-ruby-client % scp -p -P 29418 YOURNAME@review.couchbase.org:hooks/commit-msg .git/hooks/
+
+Make your changes and upload them for review:
+
+    ~/couchbase-ruby-client % git commit
+    ~/couchbase-ruby-client % git push origin HEAD:refs/for/master
+
+If you need to fix or add something to your patch, do it and re-upload
+the changes (all you need is to keep `Change-Id:` line the same to
+allow gerrit to track the patch.
+
+    ~/couchbase-ruby-client % git commit --amend
+    ~/couchbase-ruby-client % git push origin HEAD:refs/for/master
+
+Happy hacking!
+
+[1]: http://review.couchbase.org/Documentation/user-upload.html
+[2]: http://review.couchbase.org/Documentation/user-changeid.html

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in couchbase.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,201 @@
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same "printed page" as the copyright notice for easier
+   identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+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.

data/Makefile

@@ -0,0 +1,3 @@
+all:
+	$(MAKE) -C../.. ruby-client
+

data/README.markdown

@@ -0,0 +1,83 @@
+# Couchbase Ruby Client
+
+This is the official client library for use with Couchbase Server.
+
+## SUPPORT
+
+If you find an issue, please file it in our [JIRA][1]. Also you are
+always welcome on the `#libcouchbase` channel at [freenode.net IRC
+servers][2]. Checkout [library overview][overview] and [API
+documentation][api].
+
+
+## INSTALL
+
+At the moment it only support [jruby](http://jruby.org/), so
+installation is as simple as:
+
+    $ gem install couchbase
+
+## USAGE
+
+Since it is 2.0 release, it introduces API changes comparing to 1.x
+versions.
+
+    require 'couchbase'
+
+Cluster object accepts list of nodes to connect to:
+
+    c = Couchbase::Cluster.new(['localhost'])
+
+
+To open bucket, specify name and password (optional):
+
+    b = c.open_bucket('default', '')
+
+SDK 2.0 operates with documents, so the API expose
+`Couchbase::Document` to wrap your data:
+
+    doc = Couchbase::Document.new(:id => 'mydoc', :content => {'foo' => 'bar'})
+
+Now you can put it into the bucket:
+
+    b.upsert(doc)
+    # => #<Couchbase::Document:0x6ada79a9
+    #     @cas=247387287270276,
+    #     @content={"foo"=>"bar"},
+    #     @expiry=0,
+    #     @id="mydoc",
+    #     @transcode=true>
+
+And retrieve it later:
+
+    b.get('mydoc')
+    # => #<Couchbase::Document:0x789052f6
+    #     @cas=247387287270276,
+    #     @content={"foo"=>"bar"},
+    #     @expiry=0,
+    #     @id="mydoc",
+    #     @transcode=true>
+
+More complex example with `beer-sample` bucket, which comes with the
+server distribution.
+
+    require 'couchbase'
+    c = Couchbase::Cluster.new(['localhost'])
+    b = c.open_bucket('beer-sample')
+    res = b.query('beer', 'by_location', :group_level => 1)
+
+    puts 'First 4 countries: '
+    res.rows.take(4).each do |row|
+      puts "#{row['key'].first}: #{row['value']}"
+    end
+
+    res.rows.each do |row|
+      b.counter('beer_lovers', +1, initial: 1) if row['value'] > 10
+    end
+    puts "There are #{b.get('beer_lovers').content} countries with more than 10 breweries"
+    # >> First 4 countries:
+    # >> Argentina: 2
+    # >> Aruba: 1
+    # >> Australia: 14
+    # >> Austria: 10
+    # >> There are 18 countries with more than 10 breweries

data/RELEASE_NOTES.markdown

@@ -0,0 +1,872 @@
+# Release Notes
+
+This document is a list of user visible feature changes and important
+bugfixes. Do not forget to update this doc in every important patch.
+
+## 1.3.7 (2014-04-18)
+
+* [major] Allow the selection of bootstrap providers. Since libcouchbase
+  2.3.0 there is a new bootstrapping transport available: Cluster
+  Configuration Carrier Publication (CCCP). It is more efficient way
+  to keep cluster configuration up to date using Carrier Publication
+  instead of HTTP connection.
+
+        nodes = ["example.com", "example.org"]
+        Couchbase.connect(node_list: nodes, bootstrap_transports: [:cccp, :http])
+
+  Read more about it here:
+  http://www.couchbase.com/wiki/display/couchbase/Cluster+Configuration+Carrier+Publication
+
+* [major] RCBC-168 An experimental DNS SRV helper for connection
+  constructor. The DNS SRV records need to be configured on a reachable
+  DNS server. An example configuration could look like the following
+  (note that the service ids might change):
+
+        _cbmcd._tcp.example.com.  0  IN  SRV  20  0  11210 node2.example.com.
+        _cbmcd._tcp.example.com.  0  IN  SRV  10  0  11210 node1.example.com.
+        _cbmcd._tcp.example.com.  0  IN  SRV  30  0  11210 node3.example.com.
+
+        _cbhttp._tcp.example.com.  0  IN  SRV  20  0  8091 node2.example.com.
+        _cbhttp._tcp.example.com.  0  IN  SRV  10  0  8091 node1.example.com.
+        _cbhttp._tcp.example.com.  0  IN  SRV  30  0  8091 node3.example.com.
+
+  Now if "example.com" is passed in as the argument, the three nodes
+  configured will be parsed and put in the returned URI list. Note
+  that the priority is respected (in this example, node1 will be the
+  first one in the list, followed by node2 and node3). As of now,
+  weighting is not supported. This is how it could be used to
+  bootstrap the connection:
+
+        transport = :http
+        nodes = Couchbase::DNS.locate('example.com', transport)
+        if nodes.empty?
+          nodes = ["example.com:8091"]
+        end
+        Couchbase.connect(node_list: nodes, bootstrap_transports: [transport])
+
+  NOTE: This is experiemental and subject to change at any time. Watch
+  the release notes for changes in future releases.
+
+* [major] RCBC-166 Fix a crash with eventmachine. In eventmachine event
+  handlers are separated and run seprately and in the following order:
+  [READ, WRITE]. So it was possible to cancel WRITE event handler from
+  the READ handler which cause crash when the reactor run it in next
+  turn.
+
+* [minor] Fixed a typo which doesn't allow to use bundler in the project
+  directory.
+
+## 1.3.6 (2014-02-17)
+
+* [major] Fix linkage issue which blocks library installation on
+  windows.
+
+## 1.3.5 (2014-02-05)
+
+* [major] RCBC-159, RCBC-152 Honor the :environment constructor argument
+
+* [major] Allow inheritance from `Couchbase::Bucket`. It wasn't
+  possible to create a view with subclass of the `Couchbase::Bucket`.
+
+* [major] Ensure that an exception raised early will not prevent the
+  finalizer from being called in the underlying client being constructed.
+  One example situation where this could occur:
+
+        class Couchbase::Bucket
+          def initialize(*args)
+            raise "something wrong"
+            super
+          end
+        end
+
+## 1.3.4 (2014-01-08)
+
+* [major] Build 64-bit versions of the extensions for Windows
+  platform. Also support ruby 2.0 and 2.1.
+
+* [minor] Update hacking section in README
+
+* [minor] Fix gemspec warnings regarding versions of the dependencies.
+  Now it honours semantic versioning and doesn't use strict versions.
+
+* [major] RCBC-151 Return CAS in extended mode for incr/decr
+
+* [minor] RCBC-150 Update list of options on `Cluster.create_bucket`.
+  Added new options: `:replica_index`, `:flush_enabled`,
+  `:parallel_db_and_view_compaction`.
+
+* [major] Allow retries on Couchbase::Bucket#cas collisions.  Now it
+  takes a `:retry` Fixnum option that specifies the maximum number of
+  times the method should retry the entire get/update/set operation
+  when a `Couchbase::Error::KeyExists` error is encountered due to a
+  concurrent update from another writer between its `#get` and `#set`
+  calls.
+
+* [major] MD5 and truncate ActiveSupport::Cache keys that are longer
+  than 250 characters.
+
+## 1.3.3 (2013-09-12)
+
+* [major] RCBC-134 Allow application to use several connections with
+  thread-local singleton.
+
+* [major] RCBC-135 Fixed invalid memory access which was detected by
+  using 'GC.stress = true' in tests.
+
+* [major] RCBC-141 Initialize event indexes correctly. The plugin
+  didn't trace event callbacks, which might lead to invalid memory
+  access during rebalance, where libcouchbase creates/removes a lot of
+  events because of a fast-changing topology.
+
+* [major] RCBC-137 Add selection options for new IO engines: select
+  and iocp.
+
+* [major] When setting the username field, check for password
+  presence. Fixes segmentation fault in this code:
+
+        Couchbase.connect(:username => "default", :bucket => "default")
+
+* [minor] Allow to determine the version of libcouchbase:
+
+        Couchbase.libcouchbase_version
+
+* [major] RCBC-136 Build shared object for ruby 2.0 on windows. Also
+  fixes build script when using latest rake and rake-compiler.
+
+* [minor] Fix deprecation warning on ruby 2.x. On newer versions it
+  should use `rb_thread_call_without_gvl()`.
+
+        ext/couchbase_ext/multithread_plugin.c: In function ‘loop_run_poll’:
+        ext/couchbase_ext/multithread_plugin.c:772:5: warning: ‘rb_thread_blocking_region’ is deprecated (declared at .../2.0.0-p247-dbg/include/ruby-2.0.0/ruby/intern.h:839) [-Wdeprecated-declarations]
+             rb_thread_blocking_region(loop_blocking_poll, args, RUBY_UBF_PROCESS, NULL);
+
+* [major] Do not try to compile with plugins for Windows platform.
+
+* [major] Force handle to be NULL on `lcb_create()` failure.
+  `lcb_create()` can leave garbage in the pointer even if the call
+  itself failed.  This behaviour could lead to illegal memory access
+  on GC.
+
+* [minor] Remove usage of `RARRAY_PTR` in favor of `rb_ary_entry`.
+  This improves performance significantly on Rubinius and also
+  improves compatibility with future CRuby 2.1 which introduces
+  generational garbage collection. This results in these arrays not
+  having to be rescanned in Rubinius and not marked as shady in
+  RBGCENC in CRuby 2.1.
+  For more discussion, also see: https://bugs.ruby-lang.org/issues/8399
+
+## 1.3.2 (2013-07-10)
+
+* [major] RCBC-133 Allow application to select the strategy of reading
+  from replica nodes. **This version requires libcouchbase >= 2.0.7.**
+  Now three strategies are available:
+
+    * `:first` - synonym to `true`, previous behaviour now the
+      default. It means that the library will sequentially iterate
+      over all replicas in the configuration supplied by the cluster
+      and will return as soon as it finds a successful response, or
+      report an error.
+
+            c.get("foo", :replica => true)
+            c.get("foo", :replica => :first)
+            #=> "bar"
+            c.get("foo", :replica => :first, :extended => true)
+            #=> ["bar", 0, 11218368683493556224]
+
+    * `:all` - query all replicas in parallel. In this case the method
+      will return the array of the values on the all replica nodes without
+      a particular order. Also if the key isn't on the node, it will be
+      skipped in the result array.
+
+            c.get("foo", :replica => :all)
+            #=> ["bar", "bar", "bar"]
+            c.get("foo", :replica => :all, :extended => true)
+            #=> [["bar", 0, 11218368683493556224],
+            #    ["bar", 0, 11218368683493556224],
+            #    ["bar", 0, 11218368683493556224]]
+
+    * `Fixnum` - you can also select specific replica node by its
+      index in the cluster configuration. It should be in interval
+      `0...c.num_replicas`
+
+            0...c.num_replicas
+            #=> 0...3
+            c.get("foo", :replica => 1)
+            #=> "bar"
+            c.get("foo", :replica => 42)
+            #=> ArgumentError: replica index should be in interval 0...3
+
+  Note that applications should not assume the order of the
+  replicas indicates more recent data is at a lower index number.
+  It is up to the application to determine which version of a
+  document/item it may wish to use in the case of retrieving data
+  from a replica.
+
+
+## 1.3.1 (2013-06-05)
+
+* [major] RCBC-131 Couchbase::Cluster instance shouldn't require
+  persistent connection.
+
+* Fix compatibility with multi_json 1.7.5. They removed VERSION
+  constant
+
+## 1.3.0 (2013-05-07)
+
+* [major] RCBC-46 implement Couchbase::ConnectionPool to allow
+  applications (and ActiveSupport::Cache::CouchbaseStore) use it in
+  multi-threaded environment
+
+* [major] Introduce Transcoders. This mechanism is more flexible, and
+  similar to how other clients encode values.
+
+* [minor] Deprecate numeric argument to 'default_format'. Instead
+  of this style:
+
+        Couchbase.connect(:default_format => Couchbase::Bucket::FMT_MARSHAL)
+
+  Symbol notation or explicit transcoder entity should be used
+
+        Couchbase.connect(:default_format => :marshal)
+        Couchbase.connect(:transcoder => Couchbase::Transcoder::Marshal)
+
+## 1.2.3 (2013-04-02)
+
+* [major] Make ActiveSupport::Cache::CouchbaseStore threadsafe
+
+* [minor] Check for gethrtime. Needed for solaris/smartos
+
+* [minor] Update documentation bits regarding SET operations
+
+## 1.2.2 (2013-02-11)
+
+* [minor] Bucket#design_docs will return a Hash with DesignDoc
+  instances as a values.
+
+* [critical] RCBC-104 Data corruption on intensive store operations.
+  The issue could also lead to segfaults.
+
+* [major] RCBC-118 Alias #total_rows as #total_entries on view result
+  set to match documentation.
+
+* [minor] View#fetch_all - async method for fetching all records
+
+        conn.run do
+          doc.recent_posts.fetch_all do |posts|
+            do_something_with_all_posts(posts)
+          end
+        end
+
+* [major] Allow to use Bucket instance in completely asynchronous
+  environment like this, without blocking on connect:
+
+        conn = Couchbase.new(:async => true)
+        conn.run do
+          conn.on_connect do |res|
+            if res.success?
+              #
+              # schedule async requests
+              #
+            end
+          end
+        end
+
+* [major] RCBC-27 EventMachine plugin to integrate with EventMachine
+  library. Note that the plugin is experimental at this stage.
+  Example:
+
+        require 'eventmachine'
+        require 'couchbase'
+
+        EM.epoll = true  if EM.epoll?
+        EM.kqueue = true  if EM.kqueue?
+        EM.run do
+          con = Couchbase.connect(:engine => :eventmachine, :async => true)
+          con.on_connect do |res|
+            puts "connected: #{res.inspect}"
+            if res.success?
+              con.set("emfoo", "bar") do |res|
+                puts "set: #{res.inspect}"
+                con.get("emfoo") do |res|
+                  puts "get: #{res.inspect}"
+                  EM.stop
+                end
+              end
+            else
+              EM.stop
+            end
+          end
+        end
+
+
+## 1.2.1 (2012-12-28)
+
+* [major] RCBC-101 Persistence constraints wasn't passed to mutation
+  methods, so they haven't been applied properly.
+
+* [major] RCBC-102 Inconsistent return values in case of storage
+  functions with persistence constraints. It always return a Hash like
+  in case of multi-set, even if there is only one document is being
+  set.
+
+* [minor] Improve internal structures of multi-threaded IO plugin to
+  protect it from memory leaks when the Fiber object is forgotten.
+
+## 1.2.0 (2012-12-12)
+
+ 30 files changed, 2079 insertions(+), 662 deletions(-)
+
+* Specialized io plugin for releasing Ruby GVL (thanks to
+  Sokolov Yura aka funny_falcon).
+
+  * Ruby 1.9.x uses global lock for ensuring integrity, and blocking
+    calls should be called inside rb_thread_blocking_region to allow
+    other threads to be runned.
+
+  * Ruby 1.8.7 have only green threads, so that rb_thread_schedule
+    should be called manually.
+
+* RCBC-42 Catch exceptions from ruby callbacks
+
+* RCBC-99 read out the StringIO contents in json gem monkey patch
+
+* Use marshal serializer by default for session store
+
+* Remove debugger development dependency
+
+* Fix memory leaks and performance improvements
+
+## 1.2.0.z.beta5 (2012-11-29)
+
+ 25 files changed, 1419 insertions(+), 1230 deletions(-)
+
+* RCBC-95 Use response body to clarify Couchbase::Error::HTTP
+
+* Fix memory leaks: in async mode context wasn't freed
+
+* Allow to setup default initial value for INCR/DECR on per connection
+  level.
+
+* Make error message about libcouchbase dependency more verbose
+
+## 1.2.0.z.beta4 (2012-11-21)
+
+ 27 files changed, 311 insertions(+), 123 deletions(-)
+
+* Increase default connection timeout for Views up to 75 seconds
+
+* RCBC-94 Reset global exception after usage
+
+* RCBC-89 Do not expose docs embedded in HTTP response. Use binary
+  protocol for it.
+
+* Remove all_docs mentions. It isn't recommended to use it because of
+  performance issues
+
+* Protect against non string values in :plain mode. Will raise error
+  if the value given isn't a string.
+
+* RCBC-90 Update documentation about session store
+
+* Make rack session store adapter quiet
+
+* Update to recent libcouchbase API
+
+* Adjust version check for MultiJson monkeypatch (8098da1)
+
+* Do not hide ValueFormat reason. It is accessible using
+  Couchbase::Error::Value#inner_exception.
+
+## 1.2.0.z.beta3 (2012-10-16)
+
+ 18 files changed, 241 insertions(+), 57 deletions(-)
+
+* RCBC-52 Implement bucket create/delete operations. Examples:
+
+        conn = Couchbase::Cluster.new(:hostname => "localhost",
+                 :username => "Administrator", :password => "secret")
+        conn.create_bucket("my_protected_bucket",
+                 :ram_quota => 500, # megabytes
+                 :sasl_password => "s3cr3tBuck3t")
+
+* Propagate status code for HTTP responses
+
+* RCBC-87 Fix build error on Mac OS X
+
+* Use global scope to find Error classes (thanks to @wr0ngway)
+
+* Fix memory leaks
+
+* Update to recent libcouchbase API
+
+## 1.2.0.z.beta2 (2012-09-21)
+
+ 3 files changed, 6 insertions(+), 2 deletions(-)
+
+* RCBC-82 Not all rubies are fat on Mac OS X. Fixes build there
+
+## 1.2.0.z.beta  (2012-09-18)
+
+ 2 files changed, 5 insertions(+), 1 deletion(-)
+
+* Fix version ordering by using ".z" prefix before .beta. The problem
+  is that DP (Developer Preview) should have lower precedence than
+  Beta, but alphabetially ".beta" orders before ".dp". This is why
+  further Beta versions have ".z".
+
+## 1.2.0.beta (2012-09-18)
+
+ 51 files changed, 9301 insertions(+), 3364 deletions(-)
+
+* RCBC-81 Protect against NoMethodError in extconf.rb. Fixes
+  gem installation
+
+* RCBC-79 Use RESTful flush
+
+* Various build fixes
+
+* Add attribute reader for Error::Base status code
+
+* CCBC-98 Expose client temporary failure error
+
+* RCBC-28 Implement Bucket#unlock
+
+        # Unlock the single key
+        val, _, cas = c.get("foo", :lock => true, :extended => true)
+        c.unlock("foo", :cas => cas)
+
+        # Unlock several keys
+        c.unlock("foo" => cas1, :bar => cas2)
+        #=> {"foo" => true, "bar" => true}
+
+* Fix CAS conversion for Bucket#delete method for 32-bit systems
+
+## 1.1.5 (2012-09-17)
+
+ 3 files changed, 9 insertions(+), 5 deletions(-)
+
+* RCBC-81 Fixed installing issue on Mac OS X.
+
+## 1.1.4 (2012-08-30)
+
+ 5 files changed, 64 insertions(+), 30 deletions(-)
+
+* RCBC-37 Allow to pass intial list of nodes which will allow to
+  iterate addresses until alive node will be found.
+
+        Couchbase.connect(:node_list => ['example.com:8091', 'example.org:8091', 'example.net'])
+
+* RCBC-70 Fixed UTF-8 in the keys. Original discussion
+  https://groups.google.com/d/topic/couchbase/bya0lSf9uGE/discussion
+
+## 1.2.0.dp6 (2012-06-28)
+
+ 21 files changed, 1520 insertions(+), 428 deletions(-)
+
+* RCBC-47 Allow to skip username for protected buckets. The will use
+  bucket name for credentials.
+
+* Expose number of replicas to the user
+
+* RCBC-6 Implement Bucket#observe command to query durable state.
+  Examples:
+
+        # Query state of single key
+        c.observe("foo")
+        #=> [#<Couchbase::Result:0x00000001650df0 ...>, ...]
+
+        # Query state of multiple keys
+        keys = ["foo", "bar"]
+        stats = c.observe(keys)
+        stats.size   #=> 2
+        stats["foo"] #=> [#<Couchbase::Result:0x00000001650df0 ...>, ...]
+
+* RCBC-49 Storage functions with durability requirements
+
+        # Ensure that the key will be persisted at least on the one node
+        c.set("foo", "bar", :observe => {:persisted => 1})
+
+* RCBC-50 Allow to read keys from replica
+
+* RCBC-57 Expose timers API from libcouchbase
+
+* RCBC-59 Replicate flags in Bucket#cas operation
+
+* Apply timeout value before connection. Currently libcouchbase shares
+  timeouts for connection and IO operations. This patch allows to
+  setup timeout on the instantiating the connection.
+
+* RCBC-39 Allow to specify delta for incr/decr in options
+
+* RCBC-40 Fix Bucket#cas operation behaviour in async mode. The
+  callback of the Bucket#cas method is triggered only once, when it
+  fetches old value, and it isn't possible to receive notification if
+  the next store operation was successful. Example, append JSON
+  encoded value asynchronously:
+
+        c.default_format = :document
+        c.set("foo", {"bar" => 1})
+        c.run do
+          c.cas("foo") do |val|
+            case val.operation
+            when :get
+              val["baz"] = 2
+              val
+            when :set
+              # verify all is ok
+              puts "error: #{ret.error.inspect}" unless ret.success?
+            end
+          end
+        end
+        c.get("foo")      #=> {"bar" => 1, "baz" => 2}
+
+* RCBC-43 More docs and examples on views
+
+* RCBC-37 Bootstrapping using multiple nodes
+
+        Couchbase.connect(:node_list => ['example.com:8091', 'example.org:8091', 'example.net'])
+
+* Inherit StandardError instead RuntimeError for errors
+
+## 1.2.0.dp5 (2012-06-15)
+
+ 12 files changed, 939 insertions(+), 20 deletions(-)
+
+* Integrate with Rack and Rails session store
+
+        # rack
+        require 'rack/session/couchbase'
+        use Rack::Session::Couchbase
+
+        # rails
+        require 'action_dispatch/middleware/session/couchbase_store'
+        AppName::Application.config.session_store :couchbase_store
+
+* Implement cache store adapter for Rails
+
+        cache_options = {
+          :bucket => 'protected',
+          :username => 'protected',
+          :password => 'secret',
+          :expires_in => 30.seconds
+        }
+        config.cache_store = :couchbase_store, cache_options
+
+* Implement key prefix (simple namespacing)
+
+        Couchbase.connect(:key_prefix => "prefix:")
+
+* Allow to force assembling result Hash for multi-get
+
+        connection.get("foo", "bar")
+        #=> [1, 2]
+        connection.get("foo", "bar", :assemble_hash => true)
+        #=> {"foo" => 1, "bar" => 2}
+
+## 1.2.0.dp4 (2012-06-07)
+
+ 4 files changed, 34 insertions(+), 19 deletions(-)
+
+* Update Bucket#replace documentation: it accepts :cas option
+
+* RCBC-36 Fix segfault. Occasional segfault when accessing the
+  results of a View. https://gist.github.com/2883925
+
+## 1.2.0.dp3 (2012-06-06)
+
+ 4 files changed, 22 insertions(+), 4 deletions(-)
+
+* Fix for multi_json < 1.3.3
+
+* Break out from event loop for non-chunked responses. View results
+  are chunked by default, so there no problems, but other requests
+  like Bucket#save_design_doc() were "locking" awaiting forever.
+
+## 1.2.0.dp2 (2012-06-06)
+
+ 22 files changed, 859 insertions(+), 253 deletions(-)
+
+* RCBC-31 Make Bucket#get more consistent. The pattern of using more
+  than one argument to determine if an array should be returned is not
+  idiomatic. Consider the case of a multi-get in an application where
+  I have n items to return. If there happens to be only one item it
+  will be treated differently than if there happens to be 2 items.
+
+        get(["foo"])  #=> ["bar"]
+        get("foo")    #=> "bar"
+        get(["x"], :extended => true) #=> {"x"=>["xval", 0, 18336939621176836096]}
+
+* Use monotonic high resolution clock
+
+* Implement threshold for outgoing commands
+
+* Allow to stop event loop from ruby
+
+* RCBC-35 Fix the View parameters escaping. More info at
+  https://gist.github.com/2775050
+
+* RCBC-34 Use multi_json gem. json_gem compatibility (require
+  'yajl/json_gem') is notorious for causing all kinds of issues with
+  various gems. The most compatible way to use yajl is to call
+  Yajl::Parser and Yajl::Encoder directly.
+
+* Allow to block and wait for part of the requests
+
+* Fixed view iterator. It doesn't lock event loop anymore This used to
+  cause "locks", memory leaks or even segmentation fault.
+
+* Define views only if "views" key presented
+
+* Require yajl as development dependency
+
+* RCBC-76 Implement get with lock operation. Examples:
+
+        # Get and lock key using default timeout
+        c.get("foo", :lock => true)
+
+        # Determine lock timeout parameters
+        c.stats.values_at("ep_getl_default_timeout", "ep_getl_max_timeout")
+        #=> [{"127.0.0.2:11210"=>"15"}, {"127.0.0.1:11210"=>"30"}]
+
+        # Get and lock key using custom timeout
+        c.get("foo", :lock => 3)
+
+* Update documentation
+
+## 1.1.3 (2012-07-27)
+
+ 5 files changed, 192 insertions(+), 101 deletions(-)
+
+* RCBC-64 The Couchbase::Bucket class hasn't implemented the #dup
+  method. So it caused SEGFAULT. The patch is implementing correct
+  function, which copy the internals and initializes new connection.
+
+* RCBC-59 The flags might be reset if caller will use
+  Couchbase::Bucket#cas operation. Here is IRB session demonstrating
+  the issue:
+
+        irb> Couchbase.bucket.set("foo", "bar", :flags => 0x100)
+        17982951084586893312
+        irb> Couchbase.bucket.cas("foo") { "baz" }
+        1712422461213442048
+        irb> Couchbase.bucket.get("foo", :extended => true)
+        ["baz", 0, 1712422461213442048]
+
+
+* RCBC-60 Make object_space GC protector per-bucket object. Previous
+  version provided not completely thread-safe bucket instance, because
+  it was sharing global hash for protecting objects, created in
+  extension, from garbage collecting.
+
+## 1.1.2 (2012-06-05)
+
+ 5 files changed, 9 insertions(+), 4 deletions(-)
+
+* Upgrade libcouchbase dependency to 1.0.4. Version 1.0.4 includes
+  important stability fixes.
+
+* Backport debugger patch. The gem used to require debugger as
+  development dependency. Unfortunately ruby-debug19 isn't supported
+  anymore for ruby 1.9.x. But there is new gem 'debugger'. This patch
+  replaces this dependency.
+
+## 1.2.0.dp (2012-04-10)
+
+ 19 files changed, 1606 insertions(+), 93 deletions(-)
+
+* Properly handle hashes as Couchbase.connection_options. Fixed a bug
+  when 'Couchbase.connection_options' for "default" connection, when
+  there are several arguments to pass to the connect() function when
+  establishing thread local connection as below:
+
+        Couchbase.connection_options = {:port => 9000, :bucket => 'myapp'}
+
+* Implement views. Couchbase Server Views are accessible using the
+  view APIs. Please refer to
+  http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-views.html
+  for getting started with views.
+
+* Use verbose mode by default throwing exceptions on NOT_FOUND errors.
+  This means that quiet attribute is false now on new connections.
+
+* Documentation fixes
+
+## 1.1.1 (2012-03-19)
+
+ 5 files changed, 83 insertions(+), 23 deletions(-)
+
+* Flags are used differently in different clients for example between
+  Python and Ruby. This fix will force the format to a known value
+  irrespective of the flags.
+
+* Calls between Ruby and C libraries for Couchbase which involved
+  default arguments had an associated arity of -1 which was not being
+  handled correctly. That is being handled correctly now.
+
+## 1.1.0 (2012-03-07)
+
+ 27 files changed, 2460 insertions(+), 849 deletions(-)
+
+* With the usage of the URI parser from stdlib it is possible to
+  validate the bucket URI more strictly. Also, it is possible to
+  specify credentials in the URI like:
+  http://username:password@example.com:8091/pools/default/buckets/custom
+
+* The "default" connection is available in thread local storage. This
+  mean that using the Couchbase.bucket method it is possible to get
+  access to current connection and there is no need to share
+  connections when running in multi-thread environment. Each thread
+  has its own connection reference.
+
+* The direct dependency on libevent and libsasl has been removed. Now
+  the library doesn't require libevent headers installed.
+
+* The disconnect and reconnect interfaces are implemented which
+  provide routines for explicit resource management. Connections were
+  freed only when the Garbage Collector found that the connection was
+  not being used. Now it's possible for the client to check if the
+  bucket was connected using 'connected?' or 'disconnect' it manually
+  or 'reconnect' using old settings.
+
+* There were spurious timeout issues with a compound statement like
+  below. No timeout will occur unless there is a problem with the
+  connection.
+
+        connection.run do
+          connection.get("foo") {|ret| puts "got foo = #{ret.value}"}
+          sleep(5)
+        end
+
+* It is not required to install libcouchbase or libvbucket on windows.
+
+* It is possible to store nil as a value. It is possible to
+  distinguish a nil value from a missing key by looking at at the
+  value returned and the flags and CAS values as well.
+
+* Based on the time out fix (CCBC-20), clients will be notified when
+  the connection was dropped or host isn't available.
+
+## 1.0.0 (2012-01-23)
+
+ 50 files changed, 4696 insertions(+), 2647 deletions(-)
+
+* Port library to use libcouchbase instead of memcached gem.
+  Implemented following operations:
+
+  * get, []
+  * set, []=
+  * add
+  * replace
+  * append
+  * prepend
+  * compare-and-swap
+  * arithmetic (incr/decr)
+  * flush
+  * stats
+  * delete
+  * touch
+
+* Introduce support for three data formats:
+
+  * document
+  * marshal
+  * plain
+
+* Removed Views support
+
+* Added benchmarks, couchbase vs. memcached vs. dalli
+
+* Implement asynchronous protocol
+
+## 0.9.8 (2011-12-16)
+
+ 3 files changed, 8 insertions(+), 3 deletions(-)
+
+* RCBC-10 Always specify credentials for non-default buckets. It was
+  impossible to store data in non-default buckets
+
+## 0.9.7 (2011-10-05)
+
+ 7 files changed, 31 insertions(+), 19 deletions(-)
+
+* Fix design doc removing
+
+* Fix 'set' method signature: add missing options argument
+
+* Rename gem to 'couchbase' for easy of use. The github project still
+  is 'couchbase-ruby-client'
+
+## 0.9.6 (2011-10-04)
+
+ 13 files changed, 609 insertions(+), 99 deletions(-)
+
+* Fix bug with decoding multiget result
+
+* Allow create design documents from IO and String
+
+* Rename 'json' format to 'document', and describe possible formats
+
+* Allow to handle errors in view result stream
+
+* Remove dependency on libyajl library: it bundled with yaji now
+
+## 0.9.5 (2011-08-24)
+
+ 4 files changed, 59 insertions(+), 28 deletions(-)
+
+* Update README. Make it more human-friendly
+
+* Removed dependency on will_paginate in development mode
+
+## 0.9.4 (2011-08-01)
+
+ 24 files changed, 1240 insertions(+), 78 deletions(-)
+
+* Use streaming json parser to iterate over view results
+
+* Update memcached gem dependency to v1.3
+
+* Proxy TOUCH command to memcached client
+
+* Fix minor bugs in RestClient and Document classes
+
+* Disable CouchDB API for nodes without 'couchApiBase' key provided.
+
+* Fix bug with unicode parsing in config listener
+
+* 61f394e RCBC-5 Add Dave's test case: ensure memcached client
+  initialized. Fixes Timeout error on connecting to membase with
+  Couchbase.new on Ruby 1.8.7
+
+## 0.9.3 (2011-07-29)
+
+ 6 files changed, 167 insertions(+), 9 deletions(-)
+
+* Use Latch (via Mutex and ConditionVariable) to wait until initial
+  setup will be finished.
+
+* Update prefix for development views (from '$dev_' to 'dev_')
+
+## 0.9.2 (2011-07-28)
+
+ 5 files changed, 31 insertions(+), 20 deletions(-)
+
+* Use zero TTL by default to store records forever
+
+* Update documentation
+
+* Wait until configuration is done
+
+## 0.9.1 (2011-07-25)
+
+ 3 files changed, 5 insertions(+), 2 deletions(-)
+
+* Minor bugfix for RestClient initialization
+
+## 0.9.0 (2011-07-25)
+
+ 19 files changed, 1174 insertions(+)
+
+* Initial public release. It supports most of the binary protocol
+  commands through memcached gem and also is able to listen to bucket
+  configuration and make View requests.