libcouchbase 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be988dba6fcc3cad2ae5e6b5ee57be6382fab952
-  data.tar.gz: 7eba0fd2d3ec665e9373e308bd78405766670769
+  metadata.gz: 2c7026a453499153eecaf17905759b204cec170c
+  data.tar.gz: b46e74fd72718803d075fb1afa7ea348fe7b7079
 SHA512:
-  metadata.gz: 386f1456c6853cae5766041ee2ee988703cf1f71d4d4d5974ebbc00ee887f44f6b0a8689144b83bc2b9c13df573b262ecd281cc1fa57e817904544ef96576889
-  data.tar.gz: 7a37eecb3b1bbb3c761fc21f68a4eb6c5a7974e32624642f49de9a89b3e84581444cb40e13f970f66774c57fee977f3d4215a9bbefd4577ade7f4e867d8d1784
+  metadata.gz: 37a4e81b2fae232db4e7e74e4d0966cbce04a695f7e7f0966f067331b882f8e022b60c1742c7289ee1f371a368daab93a36c48ff3cbeb0de5872e6fda88e1b1c
+  data.tar.gz: 5d4f5a2e4e8f24ff3a0a025b94a3a016831cb2717d57c13bb4ebf7b36f043bb139282722172b4927b94c4237e5fdcc77c433d4f6df8056f09b7c41afd1490979

data/.travis.yml

@@ -16,10 +16,10 @@ before_install:
   - sudo apt-get install libev-dev python-httplib2
   - sudo wget https://packages.couchbase.com/releases/5.0.0/couchbase-server-enterprise_5.0.0-ubuntu14.04_amd64.deb
   - sudo dpkg -i couchbase-server-enterprise_5.0.0-ubuntu14.04_amd64.deb
-  - sleep 4
+  - sleep 8
   - sudo service couchbase-server status
   - /opt/couchbase/bin/couchbase-cli cluster-init -c 127.0.0.1:8091 --cluster-username=admin --cluster-password=password --cluster-ramsize=320 --cluster-index-ramsize=256 --cluster-fts-ramsize=256 --services=data,index,query,fts
-  - sleep 4
+  - sleep 5
   - /opt/couchbase/bin/couchbase-cli server-info   -c 127.0.0.1:8091 -u admin -p password
   - /opt/couchbase/bin/couchbase-cli bucket-create -c 127.0.0.1:8091 -u admin -p password --bucket=default --bucket-type=couchbase --bucket-ramsize=160 --bucket-replica=0 --wait
   - /opt/couchbase/bin/couchbase-cli bucket-create -c 127.0.0.1:8091 -u admin -p password --bucket=test    --bucket-type=couchbase --bucket-ramsize=160 --bucket-replica=0 --enable-flush=1 --wait

data/README.md

@@ -261,6 +261,70 @@ Delete all items in the bucket. This must be enabled on the cluster to work
 bucket.flush
 ```
 
+### Subdocument queries
+
+These allow you to modify keys within documents. There is a block form.
+
+```ruby
+c.subdoc(:foo) { |subdoc|
+    subdoc.get('sub.key')
+    subdoc.exists?('other.key')
+    subdoc.get_count('some.array')
+} # => ["sub key val", true, 23]
+```
+
+There is an inline form
+
+```ruby
+c.subdoc(:foo).get(:bob).execute! # => { age: 13, working: false }
+c.subdoc(:foo)
+    .get(:bob)
+    .get(:jane)
+    .execute! # => [{ age: 13, working: false }, { age: 47, working: true }]
+```
+
+You can't perform lookups and mutations in the same request.
+
+```ruby
+# multi-mutation example
+c.subdoc(:foo)
+    .counter('bob.age', 1)
+    .dict_upsert('bob.address', {
+        number: 23
+        street: 'Daily Ave'
+        suburb: 'Some Town'
+    }).execute! # => 14 (the new counter value)
+```
+
+By default, subkeys are created if they don't exist
+
+```ruby
+c.put(:some_key, {name: 'bob'})
+c.subdoc(:some_key).dict_add('non.existant.key', {
+  random: 123,
+  hash: 'values'
+}).execute! 
+```
+
+Possible lookup operations are:
+
+* `get`
+* `exists?`
+* `get_count`
+
+Possible mutation operations
+
+* `counter` increments the subkey by integer value passed
+* `dict_upsert` replaces the subkey with value passed
+* `dict_add`
+* `array_add_first`
+* `array_add_last`
+* `array_add_unique`
+* `array_insert`
+* `replace`
+
+You can see additional docs here: https://developer.couchbase.com/documentation/server/current/sdk/subdocument-operations.html
+
 
 ### Views (Map/Reduce queries)
 

data/lib/libcouchbase/connection.rb

@@ -97,7 +97,8 @@ module Libcouchbase
             @connection = Ext::CreateSt.new
             @connection[:version] = 3
             @connection[:v][:v3][:connstr]  = FFI::MemoryPointer.from_string(connstr)
-            @connection[:v][:v3][:username] = FFI::MemoryPointer.from_string(username&.to_s || bucket.to_s)
+            uname = (username && !username.to_s.empty?) ? username.to_s : bucket.to_s
+            @connection[:v][:v3][:username] = FFI::MemoryPointer.from_string(uname)
             @connection[:v][:v3][:passwd]   = FFI::MemoryPointer.from_string(password) if password
             @connection[:v][:v3][:io]       = @io_ptr.get_pointer(0)
             @handle_ptr = FFI::MemoryPointer.new :pointer, 1

data/lib/libcouchbase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true, encoding: ASCII-8BIT
 
 module Libcouchbase
-    VERSION = '1.1.0'
+    VERSION = '1.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libcouchbase
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Stephen von Takach
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-24 00:00:00.000000000 Z
+date: 2017-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi