hbasegate 0.2.1 → 0.2.2

data/README.md

@@ -3,6 +3,8 @@ hbasegate
 
 JRuby gem wrapping Java API for HBase
 
+(Use hbase-stargate for other ruby implementations)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -38,20 +40,20 @@ Get a handle to the table:
 And use it:
 
     $ r = table.get('me')
-    $ puts r
+    $ puts r.to_h
 
-You specify column families, columns and values in an array of arrays. Each element of the inner array specifies on
-item.
+You specify column families and qualifiers as colon separated strings. When writing, you supply a hash of
+columns to values and when reading, you specify an array of columns.
 
-    $ r = table.get('me', [['family']])
-    $ r = table.get('me', [['family', 'column']])
-    $ r = table.get('me', [['family1', 'column1'], ['family2', 'column2']])
-    $ r = table.put('me', [['family1', 'column1', 'value1'], ['family2', 'column2', 'value2']])
+    $ r = table.get('me', ['family'])
+    $ r = table.get('me', ['family:qualifier'])
+    $ r = table.get('me', ['family1:qualifier1', 'family2:qualifier2'])
+    $ table.put('me', { 'family1:column1' => 'value1', 'family2:column2' => 'value2' })
     $ r = table.delete('me')
-    $ r = table.delete('me', [['family']])
-    $ r = table.delete('me', [['family', 'column']])
-
+    $ r = table.delete('me', ['family'])
+    $ r = table.delete('me', ['family:qualifier'])
 
+The to_h method of the result is useful for getting a hash of the result.
 
 ## Contributing
 

data/lib/hbasegate/htable.rb

@@ -11,26 +11,27 @@ module HBaseGate
     alias_method :original_put, :put
     alias_method :original_get_scanner, :get_scanner
 
-    # Read row key with an array of family, column arrays.
+    # Read row key with an optional array of columns.
     def get(key, entries = nil)
       get = Get.new(key.to_java_bytes)
-      augment_action(entries, get.method(:add_family), get.method(:add_column))
+      specify_columns(entries, get.method(:add_family), get.method(:add_column))
       original_get(get)
     end
 
-    # Store row key with an array of family, column, value arrays.
-    def put(key, entries = nil)
+    # Store row key with an hash of columns to values.
+    def put(key, column_values = nil)
       put = Put.new(key.to_java_bytes)
-      (entries || []).each.each do |family, qualifier, value|
+      (column_values || {}).each do |column, value|
+        family, qualifier = column.split(/:/)
         put.add(family.to_java_bytes, qualifier.to_java_bytes, value.to_java_bytes)
       end
       original_put(put)
     end
 
-    # Delete row key with an array of family, column arrays.
-    def delete(key, entries = nil)
+    # Delete row key with an optional array of columns.
+    def delete(key, columns = nil)
       delete = Delete.new(key.to_java_bytes)
-      augment_action(entries, delete.method(:delete_family), delete.method(:delete_column))
+      specify_columns(columns, delete.method(:delete_family), delete.method(:delete_column))
       original_delete(delete)
     end
 
@@ -48,9 +49,10 @@ module HBaseGate
     end
 
     private
-    # Iterate over the entries and use the given functions on them.
-    def augment_action(entries, family_do, qualifier_do)
-      (entries || []).each do |family, qualifier|
+    # Iterate over the columns and use the given functions on them.
+    def specify_columns(columns, family_do, qualifier_do)
+      (columns || []).each do |column|
+        family, qualifier = column.split(/:/)
         case
           when qualifier
             qualifier_do.call(family.to_java_bytes, qualifier.to_java_bytes)

data/lib/hbasegate/result_scanner.rb

@@ -4,7 +4,7 @@ module HBaseGate
   module ResultScanner
     include Enumerable
     def each
-      until (result = self.next).nil? do yield result; end
+      until (result = self.next).nil? do yield result end
     end
   end
 end

data/lib/hbasegate/version.rb

@@ -1,3 +1,3 @@
 module HBaseGate
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

metadata

@@ -1,32 +1,32 @@
 --- !ruby/object:Gem::Specification
 name: hbasegate
 version: !ruby/object:Gem::Version
-  prerelease:
-  version: 0.2.1
+  version: 0.2.2
+  prerelease: 
 platform: ruby
 authors:
 - Knut O. Hellan
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-17 00:00:00.000000000 Z
+date: 2013-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
-    none: false
-  prerelease: false
-  type: :development
 description: JRuby gem wrapping Java API for HBase
 email:
 - knut.hellan@gmail.com
@@ -54,27 +54,26 @@ files:
 homepage: http://github.com/khellan/hbasegate
 licenses:
 - MIT
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-  none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-  none: false
 requirements: []
-rubyforge_project:
-rubygems_version: 1.8.24
-signing_key:
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
 specification_version: 3
 summary: More ruby friendly API than using Java directly
 test_files: []
-...