hbase-jruby 0.6.4-java → 0.7.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f36f9ad6226b500c087ad5a8ffc9f294c738752e
-  data.tar.gz: 23ac26035d0054188538e115d899c191dd803776
+  metadata.gz: 0714705c9427de687d1657774b34d8126ef10dbd
+  data.tar.gz: 768ac4c28e4709151a665290402f2a3fe573aefb
 SHA512:
-  metadata.gz: cb25e98c711400af4e3eda1f91efbc0ca2a145f0c213384ea7da2bb45d4b98f6511381dee30c0a606faf9c1f10948aff5996d6c447cfc0acb41d98d71cd9349c
-  data.tar.gz: 58a59bf73bf759718bd58063af461cee14ece10de17cd40634b81dbf26a6406fa3d8dc608a842fde314bb42a74a537c9965e3073edb368e12f34b6961e1445dc
+  metadata.gz: 2102cbfca64c12be4addf08d0c6526549fe7f25923c079b89510d0a3404d1e64245d9feac24299c9ae10ff8533f2e8aaedf08d4859af5158fcea815a34e7ba14
+  data.tar.gz: dfb7325181769b6e57319c072d874f2b01dce456edaad2c7d33590eda98963b9b05a5540d7856b0df85253a900d39fe4829d047bde990ca18346b810a6d92858

data/CHANGELOG.md

@@ -1,6 +1,24 @@
 Changelog
 =========
 
+0.7.0
+-----
+
+- Distinguish float and double
+    - `Cell#float` / `Cell#double`
+    - `Row#float` / `Row#double`
+    - `Row#floats` / `Row#doubles`
+    - `Util.to_bytes 3.14` (double by default)
+    - `Util.to_bytes :float => 3.14`
+    - `Util.to_bytes :double => 3.14`
+    - `Util.from_bytes :float, bytes'`
+- Removed automatic disable/enable to support online alter
+- Fixed `HBase::Table#alter_family[!]` not to drop previous non-default
+  settings
+- Performance improvement with column key interpretation cache
+- Dependency resolution is now deprecated
+- HBase 1.0 client compatibility
+
 0.6.4
 -----
 

data/README.md

@@ -5,7 +5,6 @@
 *hbase-jruby* provides the followings:
 - Easy, Ruby-esque interface for the fundamental HBase operations
 - ActiveRecord-like method chaining for data retrieval
-- Automatic Hadoop/HBase dependency resolution
 
 ## Installation
 
@@ -18,14 +17,13 @@ You can use this gem in HBase shell without external JRuby installation.
 First, clone this repository,
 
 ```sh
-git clone https://github.com/junegunn/hbase-jruby.git
+git clone --depth 1 https://github.com/junegunn/hbase-jruby.git
 ```
 
-then start up the shell (`hbase shell`) and type in the following lines:
+then start up the shell (`hbase shell`) and type in the following line:
 
 ```ruby
-$LOAD_PATH << 'hbase-jruby/lib'
-require 'hbase-jruby'
+$LOAD_PATH << 'hbase-jruby/lib'; require 'hbase-jruby'
 ```
 
 Now, you're all set.
@@ -46,8 +44,48 @@ hbase[:my_table].get(100).double('f:c') # Returns 3.14
 ```ruby
 require 'hbase-jruby'
 
-# Load required JAR files from CDH distribution using Maven
-HBase.resolve_dependency! 'cdh5.2.0'
+# HBase client dependencies
+$CLASSPATH << 'hbase-client-dep-1.0.jar'
+
+# Connect to HBase
+hbase = HBase.new 'localhost'
+
+# Table object
+table = hbase[:test_table]
+table.drop! if table.exists?
+table.create! :cf1, :cf2
+
+# PUT
+table.put 'rowkey1' => { 'cf1:a' => 100, 'cf2:b' => 'Hello' },
+          'rowkey2' => { 'cf1:a' => 200, 'cf2:b' => 'world' }
+
+# GET
+row = table.get('rowkey1')
+number = row.fixnum('cf1:a')
+string = row.string('cf1:b')
+
+# SCAN
+table.range('rowkey1'..'rowkey9')
+     .filter('cf1:a' => 100..200,         # cf1:a between 100 and 200
+             'cf1:b' => 'Hello',          # cf1:b = 'Hello'
+             'cf2:c' => /world/i,         # cf2:c matches /world/i
+             'cf2:d' => ['foo', /^BAR/i]) # cf2:d = 'foo' OR matches /^BAR/i
+     .project('cf1:a', 'cf2').
+     .each do |row|
+  puts row.fixnum('cf1:a')
+end
+
+# DELETE
+table.delete('rowkey9')
+```
+
+## A quick example using schema definition
+
+```ruby
+require 'hbase-jruby'
+
+# HBase client dependencies
+$CLASSPATH << 'hbase-client-dep-1.0.jar'
 
 # Connect to HBase on localhost
 hbase = HBase.new
@@ -64,7 +102,8 @@ hbase.schema = {
       year:      :short,      # Short integer (2-byte)
       pages:     :int,        # Integer (4-byte)
       price:     :bigdecimal, # BigDecimal
-      weight:    :float,      # Double-precision floating-point number
+      height:    :float,      # Single-precision floating-point number (4-byte)
+      weight:    :double,     # Double-precision floating-point number (8-byte)
       in_print:  :boolean,    # Boolean (true | false)
       image:     :raw         # Java byte array; no automatic type conversion
       thumbnail: :byte_array  # HBase::ByteArray
@@ -72,7 +111,7 @@ hbase.schema = {
     # Columns in cf2 family
     cf2: {
       summary:  :string,
-      reviews:  :fixnum,     # Long integer (8-byte)
+      reviews:  :fixnum,      # Long integer (8-byte)
       stars:    :fixnum,
       /^comment\d+/ => :string
     }
@@ -144,73 +183,25 @@ table.delete 1
 ### Resolving Hadoop/HBase dependency
 
 To be able to access HBase from JRuby, Hadoop/HBase dependency must be
-satisfied. This can be done by either setting up CLASSPATH variable beforehand
-or by `require`ing relevant JAR files after launching JRuby.
+satisfied. This can be done either by setting up CLASSPATH beforehand (e.g.
+`CLASSPATH=$(hbase classpath) jruby ...`) or by `require`ing relevant JAR
+files after launching JRuby.
 
-You might be able to find the right uberjar required for using HBase client
-API from [hbase-client-dep releases page](https://github.com/junegunn/hbase-client-dep/releases).
-(If you don't find one, send me a pull request.)
+You might want to check out pre-built uberjars for various versions of HBase
+client in [hbase-client-dep releases page][client].
 
 ```ruby
 require 'hbase-jruby'
-require 'hbase-client-dep-cdh5.2.jar'
+$CLASSPATH << 'hbase-client-dep-1.0.jar'
 
-HBase.log4j = { 'log4j.threshold' => 'ERROR' }
 hbase = HBase.new
 ```
 
-### `HBase.resolve_dependency!` (*to be deprecated!*)
-
-hbase-jruby is shipped with `HBase.resolve_dependency!` helper method that can
-be used to load JAR files from Maven repository.
-
-| Argument   | Dependency               | Default version | Required executable |
-| ---------- | ------------------------ | --------------- | ------------------- |
-| cdh5.2[.*] | Cloudera CDH5.2          | cdh5.2.1        | mvn                 |
-| cdh5.1[.*] | Cloudera CDH5.1          | cdh5.1.4        | mvn                 |
-| cdh5.0[.*] | Cloudera CDH5.0          | cdh5.0.5        | mvn                 |
-| cdh4.5[.*] | Cloudera CDH4.5          | cdh4.5.0        | mvn                 |
-| cdh4.4[.*] | Cloudera CDH4.4          | cdh4.4.0        | mvn                 |
-| cdh4.3[.*] | Cloudera CDH4.3          | cdh4.3.2        | mvn                 |
-| cdh4.2[.*] | Cloudera CDH4.2          | cdh4.2.2        | mvn                 |
-| cdh4.1[.*] | Cloudera CDH4.1          | cdh4.1.5        | mvn                 |
-| cdh3[u*]   | Cloudera CDH3            | cdh3u6          | mvn                 |
-| 0.98[.*]   | Apache HBase 0.98        | 0.98.0-hadoop2  | mvn                 |
-| 0.96[.*]   | Apache HBase 0.96        | 0.96.2-hadoop2  | mvn                 |
-| 0.94[.*]   | Apache HBase 0.94        | 0.94.18         | mvn                 |
-| 0.92[.*]   | Apache HBase 0.92        | 0.92.2          | mvn                 |
-| *POM PATH* | Custom Maven POM file    | -               | mvn                 |
-| `:local`   | Local HBase installation | -               | hbase               |
-
-(Default version is used when an argument prefix is given without specific patch version.
- e.g. `cdh4.2` defaults to `cdh4.2.2`)
-
-#### Examples
-
-```ruby
-# Load JAR files from CDH4 using Maven
-HBase.resolve_dependency! 'cdh4.3.0'
-HBase.resolve_dependency! 'cdh4.2'
-
-# Load JAR files of HBase 0.94.x using Maven
-HBase.resolve_dependency! '0.94.7'
-HBase.resolve_dependency! '0.94.2', verbose: true
-
-# Dependency resolution with custom POM file
-HBase.resolve_dependency! '/path/to/my/pom.xml'
-HBase.resolve_dependency! '/path/to/my/pom.xml', profile: 'trunk'
-
-# Load JAR files from local HBase installation
-# (equivalent to: export CLASSPATH=$CLASSPATH:`hbase classpath`)
-HBase.resolve_dependency! :local
-```
-
-(If you're behind an http proxy, set up your ~/.m2/settings.xml file
-as described in [this page](http://maven.apache.org/guides/mini/guide-proxies.html))
+[client]: https://github.com/junegunn/hbase-client-dep/releases
 
 ### Log4j logs from HBase
 
-You may want to suppress (or customize) log messages from HBase.
+You can suppress (or customize) log messages from HBase.
 
 ```ruby
 # With an external log4j.properties or log4j.xml file
@@ -228,6 +219,9 @@ HBase.log4j = { 'log4j.threshold' => 'ERROR' }
 hbase = HBase.new
 
 # HBase on remote host
+hbase = HBase.new 'remote-server.mydomain.net'
+
+# The above is equivalent to the following:
 hbase = HBase.new 'hbase.zookeeper.quorum' => 'remote-server.mydomain.net'
 
 # Extra configuration
@@ -303,7 +297,7 @@ hbase.schema = {
       year:     :short,      # Short integer (2-byte)
       pages:    :int,        # Integer (4-byte)
       price:    :bigdecimal, # BigDecimal
-      weight:   :float,      # Double-precision floating-point number
+      weight:   :double,     # Double-precision floating-point number
       in_print: :boolean,    # Boolean (true | false)
       image:    :raw         # Java byte array; no automatic type conversion
     },
@@ -958,10 +952,12 @@ hbase[:dupe_table].create!(
 
 ## Table administration
 
-`HBase#Table` provides a number of *bang_methods!* for table administration tasks.
-They run synchronously, except when mentioned otherwise (e.g. `HTable#split!`).
-Some of them take an optional block to allow progress monitoring
-and come with non-bang, asynchronous counterparts.
+`HBase#Table` provides a number of *bang_methods!* for table administration
+tasks. They run synchronously, except when mentioned otherwise (e.g.
+`HTable#split!`). Some of them take an optional block to allow progress
+monitoring and come with non-bang, asynchronous counterparts. If you're
+running an old version of HBase cluster, you'll have to `disable!` the table
+before altering it.
 
 ### Creation and alteration
 
@@ -1218,7 +1214,7 @@ first  = ba[0, 8]
 second = ba[8...16]
 
 first.decode(:fixnum)  # 100
-second.decode(:float)  # 3.14
+second.decode(:double)  # 3.14
 ```
 
 append, prepend more elements to it,
@@ -1240,7 +1236,7 @@ or shift decoded objects from it.
 ba.shift(:fixnum)
 ba.shift(:boolean)
 ba.shift(:fixnum)
-ba.shift(:float)
+ba.shift(:double)
 ba.shift(:int)
 ba.shift(:string, 11)  # Byte length must be given as Strings are not fixed in size
 ```

data/hbase-jruby.gemspec

@@ -19,6 +19,6 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_development_dependency 'test-unit'
+  gem.add_development_dependency 'yard'
   gem.add_development_dependency 'simplecov'
 end

data/lib/hbase-jruby/cell.rb

@@ -101,12 +101,17 @@ class Cell
     Util.from_bytes :bigdecimal, value
   end
 
-  # Returns the column value as a Float
+  # Returns the 4-byte column value as a Float
   # @return [Float]
   def float
     Util.from_bytes :float, value
   end
-  alias double float
+
+  # Returns the 8-byte column value as a Float
+  # @return [Float]
+  def double
+    Util.from_bytes :double, value
+  end
 
   # Returns the column value as a boolean value
   # @return [true, false]

data/lib/hbase-jruby/dependency.rb

@@ -5,213 +5,96 @@ require 'erb'
 
 # HBase connection
 class HBase
+  # @private
+  @mutex = Mutex.new
 
   # @private
-  # https://github.com/apache/hbase/tags
-  # http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.apache.hbase%22%20AND%20a%3A%22hbase%22
-  # https://ccp.cloudera.com/display/SUPPORT/CDH+Downloads
-  SUPPORTED_PROFILES = {
-    # Prefix => Latest known version
-    'cdh5.2' => 'cdh5.2.1',
-    'cdh5.1' => 'cdh5.1.4',
-    'cdh5.0' => 'cdh5.0.5',
-    'cdh4.6' => 'cdh4.6.0',
-    'cdh4.5' => 'cdh4.5.0',
-    'cdh4.4' => 'cdh4.4.0',
-    'cdh4.3' => 'cdh4.3.2',
-    'cdh4.2' => 'cdh4.2.2',
-    'cdh4.1' => 'cdh4.1.5',
-    'cdh3'   => 'cdh3u6',
-    '0.98'   => '0.98.0-hadoop2',
-    '0.96'   => '0.96.2-hadoop2',
-    '0.95'   => '0.95.2-hadoop2',
-    '0.94'   => '0.94.18',
-    '0.92'   => '0.92.2',
+  @deps = {
+    self => %w[
+      org.apache.hadoop.hbase.HBaseConfiguration
+      org.apache.hadoop.hbase.client.HBaseAdmin
+      org.apache.hadoop.hbase.client.HConnectionManager
+      org.apache.hadoop.hbase.client.HTablePool
+    ],
+    Util => %w[
+      java.nio.ByteBuffer
+      org.apache.hadoop.hbase.KeyValue
+      org.apache.hadoop.hbase.util.Bytes
+    ],
+    ByteArray => %w[
+      java.util.Arrays
+      org.apache.hadoop.hbase.util.Bytes
+    ],
+    Cell => %w[
+      org.apache.hadoop.hbase.KeyValue
+    ],
+    Result => %w[
+      org.apache.hadoop.hbase.util.Bytes
+    ],
+    Table => %w[
+      org.apache.hadoop.hbase.HColumnDescriptor
+      org.apache.hadoop.hbase.HTableDescriptor
+      org.apache.hadoop.hbase.client.Append
+      org.apache.hadoop.hbase.client.Delete
+      org.apache.hadoop.hbase.client.Increment
+      org.apache.hadoop.hbase.client.Put
+      org.apache.hadoop.hbase.client.RowMutations
+    ] << %w[org.apache.hadoop.hbase.io.hfile.Compression
+            org.apache.hadoop.hbase.io.compress.Compression],
+    Scoped => %w[
+      org.apache.hadoop.hbase.client.Get
+      org.apache.hadoop.hbase.client.Scan
+      org.apache.hadoop.hbase.filter.BinaryComparator
+      org.apache.hadoop.hbase.filter.ColumnPaginationFilter
+      org.apache.hadoop.hbase.filter.ColumnRangeFilter
+      org.apache.hadoop.hbase.filter.CompareFilter
+      org.apache.hadoop.hbase.filter.FilterBase
+      org.apache.hadoop.hbase.filter.FilterList
+      org.apache.hadoop.hbase.filter.KeyOnlyFilter
+      org.apache.hadoop.hbase.filter.FirstKeyOnlyFilter
+      org.apache.hadoop.hbase.filter.MultipleColumnPrefixFilter
+      org.apache.hadoop.hbase.filter.PrefixFilter
+      org.apache.hadoop.hbase.filter.RegexStringComparator
+      org.apache.hadoop.hbase.filter.RowFilter
+      org.apache.hadoop.hbase.filter.SingleColumnValueFilter
+      org.apache.hadoop.hbase.filter.WhileMatchFilter
+      org.apache.hadoop.hbase.client.coprocessor.AggregationClient
+      org.apache.hadoop.hbase.client.coprocessor.LongColumnInterpreter
+    ]
   }
 
   class << self
-    # @overload resolve_dependency!(dist, options)
-    #   Resolve Hadoop and HBase dependency with a predefined Maven profile
-    #   @param [String] dist HBase distribution: cdh4.[1-5], cdh3, 0.94, 0.92, local
-    #   @param [Hash] options Options
-    #   @option options [Boolean] :verbose Enable verbose output
-    #   @return [Array<String>] Loaded JAR files
-    # @overload resolve_dependency!(pom_path, options)
-    #   Resolve Hadoop and HBase dependency with the given Maven POM file
-    #   @param [String] pom_path Path to POM file
-    #   @param [Hash] options Options
-    #   @option options [Boolean] :verbose Enable verbose output
-    #   @option options [String] :profile Maven profile
-    #   @return [Array<String>] Loaded JAR files
-    def resolve_dependency! dist, options = {}
-      # Backward-compatibility
-      options = { :verbose => options } if [true, false].include?(options)
-      options = { :verbose => false }.merge(options)
-
-      dist    = dist.to_s
-      verbose = options[:verbose]
-
-      silencer = verbose ? '' : '> /dev/null'
-      tempfiles = []
-
-      jars =
-        if %w[hbase local].include?(dist)
-          # Check for hbase executable
-          hbase = `which hbase`
-          raise RuntimeError, "Cannot find `hbase` executable" if hbase.empty?
-          `hbase classpath`.strip.split(':').map { |e| Dir[e] }.flatten
-        else
-          # Check for Maven executable
-          mvn = `which mvn`
-          raise RuntimeError, "Cannot find `mvn` executable" if mvn.empty?
-
-          # POM file path given (with optional profile)
-          if File.exists?(dist)
-            path = dist
-            profile = options[:profile] && "-P #{options[:profile]}"
-          # Predefined dependencies
-          else
-            matched_profiles = SUPPORTED_PROFILES.keys.select { |pf| dist.start_with? pf }
-            if matched_profiles.length != 1
-              raise ArgumentError, "Unknown profile: #{dist}"
-            end
-            matched_profile = matched_profiles.first
-            profiles = SUPPORTED_PROFILES.dup
-            profiles[matched_profile] = dist if dist != matched_profile
-            tempfiles << tf = Tempfile.new('hbase-jruby-pom')
-            erb = ERB.new(File.read File.expand_path("../pom/pom.xml.erb", __FILE__))
-            tf << erb.result(binding)
-            tf.close(false)
-            path = tf.path
-            profile = "-P #{matched_profile}"
-          end
-
-          # Download dependent JAR files and build classpath string
-          tempfiles << tf = Tempfile.new('hbase-jruby-classpath')
-          tf.close(false)
-          system("mvn org.apache.maven.plugins:maven-dependency-plugin:2.5.1:resolve " <<
-                 "org.apache.maven.plugins:maven-dependency-plugin:2.5.1:build-classpath " <<
-                 "-Dsilent=true -Dmdep.outputFile=#{tf.path} #{profile} -f #{path} #{silencer}")
-
-          unless $?.exitstatus == 0
-            message = "Error occurred."
-            message << " Set verbose option to see the log." unless verbose
-            raise RuntimeError.new(message)
-          end
-
-          if File.read(tf.path).empty?
-            desc =
-              if options[:profile]
-                "#{dist} (#{options[:profile]})"
-              else
-                dist
-              end
-            raise ArgumentError.new("Invalid profile: #{desc}")
-          end
-          File.read(tf.path).split(':')
-        end
-
-      # Load jars
-      jars_loaded = jars.select { |jar|
-        File.file?(jar) &&
-        File.extname(jar).downcase == '.jar' &&
-        require(jar)
-      }
-
-      # Apply pending log4j configuration
-      HBase.log4j = @@log4j if @@log4j
-
-      # Try importing Java classes again
-      not_found = HBase.import_java_classes!
-      if verbose && !not_found.empty?
-        warn "Java classes not found: #{not_found.join(', ')}"
-      end
-
-      return jars_loaded
-    ensure
-      tempfiles.each { |tempfile| tempfile.unlink rescue nil }
+    # Returns the version of the loaded client library
+    # @return [String]
+    def version
+      org.apache.hadoop.hbase.util.VersionInfo.getVersion
     end
 
-    # Import Java classes (Prerequisite for classes in hbase-jruby)
-    # @return [Array<String>] List of Java classes *NOT* found
+    # @private
     def import_java_classes!
-      imp = lambda { |hash|
-        hash.map { |base, classes|
+      @mutex.synchronize do
+        @deps.each do |base, list|
           base.class_eval do
-            classes.map { |klass|
-              begin
-                java_import klass
-                nil
-              rescue NameError => e
-                klass
+            list.reject! do |classes|
+              [*classes].find do |klass|
+                begin
+                  java_import klass
+                  true
+                rescue NameError
+                  false
+                end
               end
-            }.compact
-          end
-        }.flatten
-      }
-
-      imp.call(
-        HBase => %w[
-          org.apache.hadoop.hbase.HBaseConfiguration
-          org.apache.hadoop.hbase.client.HBaseAdmin
-          org.apache.hadoop.hbase.client.HConnectionManager
-          org.apache.hadoop.hbase.client.HTablePool
-        ],
-        HBase::Util => %w[
-          java.nio.ByteBuffer
-          org.apache.hadoop.hbase.KeyValue
-          org.apache.hadoop.hbase.util.Bytes
-        ],
-        HBase::ByteArray => %w[
-          java.util.Arrays
-          org.apache.hadoop.hbase.util.Bytes
-        ],
-        HBase::Cell => %w[
-          org.apache.hadoop.hbase.KeyValue
-        ],
-        HBase::Result => %w[
-          org.apache.hadoop.hbase.util.Bytes
-        ],
-        HBase::Table => %w[
-          org.apache.hadoop.hbase.HColumnDescriptor
-          org.apache.hadoop.hbase.HTableDescriptor
-          org.apache.hadoop.hbase.client.Append
-          org.apache.hadoop.hbase.client.Delete
-          org.apache.hadoop.hbase.client.Increment
-          org.apache.hadoop.hbase.client.Put
-          org.apache.hadoop.hbase.client.RowMutations
-          org.apache.hadoop.hbase.io.hfile.Compression
-          org.apache.hadoop.hbase.io.compress.Compression
-        ], # hfile.Compression <= 0.94
-        HBase::Scoped => %w[
-          org.apache.hadoop.hbase.client.Get
-          org.apache.hadoop.hbase.client.Scan
-          org.apache.hadoop.hbase.filter.BinaryComparator
-          org.apache.hadoop.hbase.filter.ColumnPaginationFilter
-          org.apache.hadoop.hbase.filter.ColumnRangeFilter
-          org.apache.hadoop.hbase.filter.CompareFilter
-          org.apache.hadoop.hbase.filter.FilterBase
-          org.apache.hadoop.hbase.filter.FilterList
-          org.apache.hadoop.hbase.filter.KeyOnlyFilter
-          org.apache.hadoop.hbase.filter.FirstKeyOnlyFilter
-          org.apache.hadoop.hbase.filter.MultipleColumnPrefixFilter
-          org.apache.hadoop.hbase.filter.PrefixFilter
-          org.apache.hadoop.hbase.filter.RegexStringComparator
-          org.apache.hadoop.hbase.filter.RowFilter
-          org.apache.hadoop.hbase.filter.SingleColumnValueFilter
-          org.apache.hadoop.hbase.filter.WhileMatchFilter
-          org.apache.hadoop.hbase.client.coprocessor.AggregationClient
-          org.apache.hadoop.hbase.client.coprocessor.LongColumnInterpreter
-        ]).tap { |not_found|
-
-        if not_found.empty?
-          self.instance_eval do
-            def import_java_classes!
-              []
             end
           end
         end
-      }
+        @deps.reject! { |k, v| v.empty? }
+
+        self.instance_eval do
+          def import_java_classes!
+          end
+        end if @deps.empty?
+      end
+      nil
     end
   end#class << self
 end