cassandra-driver 0.1.0.alpha1 → 1.0.0.beta.1

data/lib/cassandra/time_uuid.rb

@@ -0,0 +1,141 @@
+# encoding: utf-8
+
+#--
+# Copyright 2013-2014 DataStax, Inc.
+#
+# 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.
+#++
+
+module Cassandra
+  # A variant of UUID which can extract its time component.
+  #
+  class TimeUuid < Uuid
+    include Comparable
+
+    # Returns the time component from this UUID as a Time.
+    #
+    # @return [Time]
+    def to_time
+      t = time_bits - GREGORIAN_OFFSET
+      seconds = t/10_000_000
+      microseconds = (t - seconds * 10_000_000)/10.0
+      Time.at(seconds, microseconds).utc
+    end
+
+    def <=>(other)
+      c = self.value <=> other.value
+      return c if c == 0
+      self.time_bits <=> other.time_bits
+    end
+
+    protected
+
+    def time_bits
+      n = (value >> 64)
+      t = 0
+      t |= (n & 0x0000000000000fff) << 48
+      t |= (n & 0x00000000ffff0000) << 16
+      t |= (n & 0xffffffff00000000) >> 32
+      t
+    end
+
+    private
+
+    # @private
+    LOWER_HALF_MASK = 0xffffffff_ffffffff
+
+    public
+
+    # A UUID version 1, variant 1 generator. It can generate a sequence of UUIDs
+    # with reasonable uniqueness guarantees:
+    #
+    # * The clock ID and node ID components are set to random numbers when the
+    #   generator is created.
+    # * If two calls to {#next} happen within the time afforded by the system
+    #   clock resolution a counter is incremented and added to the time
+    #   component.
+    # * If the clock moves backwards the clock ID is reset to a new random
+    #   number.
+    #
+    # Instances of this class are absolutely not threadsafe. You should
+    # never share instances between threads.
+    #
+    class Generator
+      # Create a new UUID generator.
+      #
+      # @param [Integer] node_id an alternate node ID (defaults to a random number)
+      # @param [Integer] clock_id an alternate clock ID (defaults to a random number)
+      #
+      def initialize(node_id=nil, clock_id=nil, clock=Time)
+        @node_id = node_id || (rand(2**47) | 0x010000000000)
+        @clock_id = clock_id || rand(2**16)
+        @clock = clock
+      end
+
+      # Returns a new UUID with a time component that is the current time.
+      #
+      # @return [Cassandra::TimeUuid] a new UUID
+      #
+      def next
+        now = @clock.now
+        usecs = now.to_i * 1_000_000 + now.usec
+        if @last_usecs && @last_usecs - @sequence <= usecs && usecs <= @last_usecs
+          @sequence += 1
+        elsif @last_usecs && @last_usecs > usecs
+          @sequence = 0
+          @clock_id = rand(2**16)
+        else
+          @sequence = 0
+        end
+        @last_usecs = usecs + @sequence
+        from_usecs(@last_usecs)
+      end
+
+      # Returns a new UUID with a time component based on the specified Time.
+      # A piece of jitter is added to ensure that multiple calls with the same
+      # time do not generate the same UUID (if you want determinism you can set
+      # the second parameter to zero).
+      #
+      # @param [Time] time the time to encode into the UUID
+      # @param [Integer] jitter a number of microseconds to add to the time to make it unique
+      # @return [Cassandra::TimeUuid] a new UUID
+      #
+      def from_time(time, jitter=rand(2**16))
+        usecs = time.to_i * 1_000_000 + time.usec + jitter
+        from_usecs(usecs)
+      end
+
+      # @private
+      def from_usecs(usecs)
+        t = GREGORIAN_OFFSET + usecs * 10
+        time_hi  = t & 0x0fff000000000000
+        time_mid = t & 0x0000ffff00000000
+        time_low = t & 0x00000000ffffffff
+        version = 1
+        clock_id = @clock_id & 0x3fff
+        node_id = @node_id & 0xffffffffffff
+        variant = 0x8000
+        n = (time_low << 96) | (time_mid << 48) | (time_hi << 16)
+        n |= version << 76
+        n |= (clock_id | variant) << 48
+        n |= node_id
+        TimeUuid.new(n)
+      end
+    end
+
+    private
+
+    # @private
+    GREGORIAN_OFFSET = 122192928000000000
+  end
+end

data/lib/cassandra/util.rb

@@ -0,0 +1,169 @@
+# encoding: utf-8
+
+#--
+# Copyright 2013-2014 DataStax, Inc.
+#
+# 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 'stringio'
+
+module Cassandra
+  # @private
+  module Util extend self
+    def encode_hash(hash, io = StringIO.new)
+      first = true
+
+      io.putc(CRL_OPN)
+      hash.each do |k, v|
+        if first
+          first = false
+        else
+          io.print(COMMA)
+        end
+
+        encode_object(k, io)
+        io.print(COLON)
+        encode_object(v, io)
+      end
+      io.putc(CRL_CLS)
+
+      io.string
+    end
+
+    def encode_set(set, io = StringIO.new)
+      first = true
+
+      io.putc(CRL_OPN)
+      set.each do |object|
+        if first
+          first = false
+        else
+          io.print(COMMA)
+        end
+
+        encode_object(object, io)
+      end
+      io.putc(CRL_CLS)
+
+      io.string
+    end
+
+    def encode_array(array, io = StringIO.new)
+      first = true
+
+      io.putc(SQR_OPN)
+      array.each do |object|
+        if first
+          first = false
+        else
+          io.print(COMMA)
+        end
+
+        encode_object(object, io)
+      end
+      io.putc(SQR_CLS)
+
+      io.string
+    end
+
+    def encode_string(string, io = StringIO.new)
+      io.putc(QUOT)
+      string.chars do |c|
+        case c
+        when QUOT then io.print(ESC_QUOT)
+        else
+          io.putc(c)
+        end
+      end
+      io.putc(QUOT)
+
+      io.string
+    end
+
+    def encode_object(object, io = StringIO.new)
+      case object
+      when ::Hash    then encode_hash(object, io)
+      when ::Array   then encode_array(object, io)
+      when ::Set     then encode_set(object, io)
+      when ::String  then encode_string(object, io)
+      when ::Time    then encode_timestamp(object, io)
+      when ::Numeric then encode_number(object, io)
+      when ::IPAddr  then encode_inet(object, io)
+      when Uuid      then encode_uuid(object, io)
+      when nil       then io.print(NULL_STR)
+      when false     then io.print(FALSE_STR)
+      when true      then io.print(TRUE_STR)
+      else
+        raise "unsupported type: #{object.inspect}"
+      end
+
+      io.string
+    end
+    alias :encode :encode_object
+
+    def encode_timestamp(time, io = StringIO.new)
+      io.print(time.to_i)
+      io.string
+    end
+
+    def encode_number(number, io = StringIO.new)
+      io.print(number)
+      io.string
+    end
+
+    def encode_uuid(uuid, io = StringIO.new)
+      io.print(uuid)
+      io.string
+    end
+
+    def encode_inet(inet, io = StringIO.new)
+      io.putc(QUOT)
+      io.print(inet)
+      io.putc(QUOT)
+      io.string
+    end
+
+    def escape_name(name)
+      return name if name[LOWERCASE_REGEXP] == name
+      DBL_QUOT + name + DBL_QUOT
+    end
+
+    # @private
+    LOWERCASE_REGEXP = /[[:lower:]\_]*/
+    # @private
+    NULL_STR = 'null'.freeze
+    # @private
+    FALSE_STR = 'false'.freeze
+    # @private
+    TRUE_STR = 'true'.freeze
+    # @private
+    CRL_OPN = '{'.freeze
+    # @private
+    CRL_CLS = '}'.freeze
+    # @private
+    SQR_OPN = '['.freeze
+    # @private
+    SQR_CLS = ']'.freeze
+    # @private
+    COMMA = ', '.freeze
+    # @private
+    COLON = ' : '.freeze
+    # @private
+    QUOT = ?'.freeze
+    # @private
+    ESC_QUOT = "''".freeze
+    # @private
+    DBL_QUOT = ?".freeze
+  end
+end

data/lib/cassandra/uuid.rb

@@ -0,0 +1,104 @@
+# encoding: utf-8
+
+#--
+# Copyright 2013-2014 DataStax, Inc.
+#
+# 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.
+#++
+
+module Cassandra
+  # Represents a UUID value.
+  #
+  # This is a very basic implementation of UUIDs and exists more or less just
+  # to encode and decode UUIDs from and to Cassandra.
+  #
+  # If you want to generate UUIDs see {Cassandra::TimeUuid::Generator}.
+  #
+  class Uuid
+    # Creates a new UUID either from a string (expected to be on the standard 8-4-4-4-12 form, or just 32 characters without hyphens), or from a 128 bit number.
+    #
+    # @param uuid [String] a 32 char uuid
+    #
+    # @raise [ArgumentError] if the string does not conform to the expected format
+    #
+    def initialize(uuid)
+      case uuid
+      when String
+        @n = from_s(uuid)
+      else
+        @n = uuid
+      end
+    end
+
+    # Returns a string representation of this UUID in the standard 8-4-4-4-12 form.
+    #
+    def to_s
+      @s ||= begin
+        s = RAW_FORMAT % @n
+        s.insert(20, HYPHEN)
+        s.insert(16, HYPHEN)
+        s.insert(12, HYPHEN)
+        s.insert( 8, HYPHEN)
+        s
+      end
+    end
+
+    def hash
+      @n.hash
+    end
+
+    # Returns the numerical representation of this UUID
+    #
+    # @return [Bignum] the 128 bit numerical representation
+    #
+    def value
+      @n
+    end
+    alias_method :to_i, :value
+
+    # @private
+    def eql?(other)
+      other.respond_to?(:value) && self.value == other.value
+    end
+    alias_method :==, :eql?
+
+    private
+
+    # @private
+    RAW_FORMAT = '%032x'.force_encoding(Encoding::ASCII).freeze
+    # @private
+    HYPHEN = '-'.force_encoding(Encoding::ASCII).freeze
+    # @private
+    EMPTY_STRING = ''.freeze
+
+    if RUBY_ENGINE == 'jruby'
+      # @private
+      HEX_RE = /^[A-Fa-f0-9]+$/
+      # See https://github.com/jruby/jruby/issues/1608
+      # @private
+      def from_s(str)
+        str = str.gsub(HYPHEN, EMPTY_STRING)
+        raise ArgumentError, "Expected 32 hexadecimal digits but got #{str.length}" unless str.length == 32
+        raise ArgumentError, "invalid value for Integer(): \"#{str}\"" unless str =~ HEX_RE
+        Integer(str, 16)
+      end
+    else
+      # @private
+      def from_s(str)
+        str = str.gsub(HYPHEN, EMPTY_STRING)
+        raise ArgumentError, "Expected 32 hexadecimal digits but got #{str.length}" unless str.length == 32
+        Integer(str, 16)
+      end
+    end
+  end
+end

data/lib/cassandra/version.rb

@@ -1,5 +1,21 @@
 # encoding: utf-8
 
+#--
+# Copyright 2013-2014 DataStax, Inc.
+#
+# 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.
+#++
+
 module Cassandra
-  VERSION = '0.1.0.alpha1'
+  VERSION = '1.0.0.beta.1'.freeze
 end

metadata

@@ -2,7 +2,7 @@
 name: cassandra-driver
 version: !ruby/object:Gem::Version
   prerelease: 6
-  version: 0.1.0.alpha1
+  version: 1.0.0.beta.1
 platform: ruby
 authors:
 - Theo Hultberg
@@ -10,8 +10,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-27 00:00:00.000000000 Z
+date: 2014-09-11 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: ione
+  type: :runtime
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   type: :development
@@ -44,20 +60,130 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
-description: A pure Ruby driver for Cassandra
+description: A pure Ruby driver for Apache Cassandra
 email:
 - theo@iconara.net
 - bulat.shakirzyanov@datastax.com
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
+- lib/cassandra/auth/providers/password.rb
+- lib/cassandra/auth/providers.rb
+- lib/cassandra/auth.rb
+- lib/cassandra/client/batch.rb
+- lib/cassandra/client/client.rb
+- lib/cassandra/client/column_metadata.rb
+- lib/cassandra/client/connection_manager.rb
+- lib/cassandra/client/connector.rb
+- lib/cassandra/client/execute_options_decoder.rb
+- lib/cassandra/client/null_logger.rb
+- lib/cassandra/client/peer_discovery.rb
+- lib/cassandra/client/prepared_statement.rb
+- lib/cassandra/client/query_result.rb
+- lib/cassandra/client/request_runner.rb
+- lib/cassandra/client/result_metadata.rb
+- lib/cassandra/client/void_result.rb
+- lib/cassandra/client.rb
+- lib/cassandra/cluster/client.rb
+- lib/cassandra/cluster/connector.rb
+- lib/cassandra/cluster/control_connection.rb
+- lib/cassandra/cluster/options.rb
+- lib/cassandra/cluster/registry.rb
+- lib/cassandra/cluster/schema/type_parser.rb
+- lib/cassandra/cluster/schema.rb
+- lib/cassandra/cluster.rb
+- lib/cassandra/column.rb
+- lib/cassandra/compression/compressors/lz4.rb
+- lib/cassandra/compression/compressors/snappy.rb
+- lib/cassandra/compression.rb
+- lib/cassandra/driver.rb
+- lib/cassandra/errors.rb
+- lib/cassandra/execution/info.rb
+- lib/cassandra/execution/options.rb
+- lib/cassandra/execution/trace.rb
+- lib/cassandra/future.rb
+- lib/cassandra/host.rb
+- lib/cassandra/keyspace.rb
+- lib/cassandra/listener.rb
+- lib/cassandra/load_balancing/policies/dc_aware_round_robin.rb
+- lib/cassandra/load_balancing/policies/round_robin.rb
+- lib/cassandra/load_balancing/policies/white_list.rb
+- lib/cassandra/load_balancing/policies.rb
+- lib/cassandra/load_balancing.rb
+- lib/cassandra/protocol/cql_byte_buffer.rb
+- lib/cassandra/protocol/cql_protocol_handler.rb
+- lib/cassandra/protocol/frame_decoder.rb
+- lib/cassandra/protocol/frame_encoder.rb
+- lib/cassandra/protocol/request.rb
+- lib/cassandra/protocol/requests/auth_response_request.rb
+- lib/cassandra/protocol/requests/batch_request.rb
+- lib/cassandra/protocol/requests/credentials_request.rb
+- lib/cassandra/protocol/requests/execute_request.rb
+- lib/cassandra/protocol/requests/options_request.rb
+- lib/cassandra/protocol/requests/prepare_request.rb
+- lib/cassandra/protocol/requests/query_request.rb
+- lib/cassandra/protocol/requests/register_request.rb
+- lib/cassandra/protocol/requests/startup_request.rb
+- lib/cassandra/protocol/requests/void_query_request.rb
+- lib/cassandra/protocol/response.rb
+- lib/cassandra/protocol/responses/auth_challenge_response.rb
+- lib/cassandra/protocol/responses/auth_success_response.rb
+- lib/cassandra/protocol/responses/authenticate_response.rb
+- lib/cassandra/protocol/responses/detailed_error_response.rb
+- lib/cassandra/protocol/responses/error_response.rb
+- lib/cassandra/protocol/responses/event_response.rb
+- lib/cassandra/protocol/responses/prepared_result_response.rb
+- lib/cassandra/protocol/responses/raw_rows_result_response.rb
+- lib/cassandra/protocol/responses/ready_response.rb
+- lib/cassandra/protocol/responses/result_response.rb
+- lib/cassandra/protocol/responses/rows_result_response.rb
+- lib/cassandra/protocol/responses/schema_change_event_response.rb
+- lib/cassandra/protocol/responses/schema_change_result_response.rb
+- lib/cassandra/protocol/responses/set_keyspace_result_response.rb
+- lib/cassandra/protocol/responses/status_change_event_response.rb
+- lib/cassandra/protocol/responses/supported_response.rb
+- lib/cassandra/protocol/responses/topology_change_event_response.rb
+- lib/cassandra/protocol/responses/void_result_response.rb
+- lib/cassandra/protocol/type_converter.rb
+- lib/cassandra/protocol.rb
+- lib/cassandra/reconnection/policies/constant.rb
+- lib/cassandra/reconnection/policies/exponential.rb
+- lib/cassandra/reconnection/policies.rb
+- lib/cassandra/reconnection.rb
+- lib/cassandra/result.rb
+- lib/cassandra/retry/policies/default.rb
+- lib/cassandra/retry/policies/downgrading_consistency.rb
+- lib/cassandra/retry/policies/fallthrough.rb
+- lib/cassandra/retry/policies.rb
+- lib/cassandra/retry.rb
+- lib/cassandra/session.rb
+- lib/cassandra/statement.rb
+- lib/cassandra/statements/batch.rb
+- lib/cassandra/statements/bound.rb
+- lib/cassandra/statements/prepared.rb
+- lib/cassandra/statements/simple.rb
+- lib/cassandra/statements/void.rb
+- lib/cassandra/statements.rb
+- lib/cassandra/table.rb
+- lib/cassandra/time_uuid.rb
+- lib/cassandra/util.rb
+- lib/cassandra/uuid.rb
 - lib/cassandra/version.rb
-homepage: 
+- lib/cassandra.rb
+- README.md
+- .yardopts
+homepage: http://datastax.github.io/ruby-driver
 licenses:
 - Apache License 2.0
 post_install_message: 
-rdoc_options: []
+rdoc_options:
+- --title
+- Datastax Ruby Driver
+- --main
+- README.md
+- --line-numbers
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -65,7 +191,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -77,6 +203,6 @@ rubyforge_project:
 rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: Cassandra driver
+summary: Datastax Ruby Driver for Apache Cassandra
 test_files: []
 has_rdoc: