druuid 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5a713dab43e5bca952c2729d2b95b5a41c0ea067
-  data.tar.gz: a2b168e714e1ad0baca24c1d8f414a3722389ac2
+  metadata.gz: 6b3eb19e63eb6ef54ba0ba47e1196a6f2c15c830
+  data.tar.gz: 6de75af50919eac4bd7f818cd41ec37dbaa541f8
 SHA512:
-  metadata.gz: f78b69bcb4536c01a82dd40779e63899f57acc966bed7b184b53963043b5b3549a827547c7885c0ff8d9e6af3a2dfb76ef2355ed8cc8b85d92830b1e621782dc
-  data.tar.gz: f6dfc909421fbb45e62e07e96d5a7b2c9c213a6ed05bd4382bf6db7c5b7e2aa85d6f32376a1711d7db04bad47b214cc03c46c3a30f6227747e546a317e108c55
+  metadata.gz: 4000d869db3357fb2c52ed77306479db6e41ce02bc3ef0a6c68358dae4822b246517f547c7dcbc651e32292d590594a8f59937d249692cd1a80a2382cf8f1807
+  data.tar.gz: 00e0b4894bcd655bc74fbc497a42e98eb6424417a1b594ca605ee041dfc4935f669f2e8abda529955117f7a24bef96697be19c6489b804c218235bb9ac10abd6

data/druuid.rb

@@ -4,6 +4,7 @@ require 'securerandom'
 #
 # Date-relative UUID generation.
 module Druuid
+  NUM_RANDOM_BITS = 64 - 41
 
   class << self
 
@@ -21,8 +22,8 @@ module Druuid
     def gen time = Time.now, epoch_offset = epoch
       ms = ((time.to_f - epoch_offset.to_i) * 1e3).round
       rand = (SecureRandom.random_number * 1e16).round
-      id = ms << (64 - 41)
-      id | rand % (2 ** (64 - 41))
+      id = ms << NUM_RANDOM_BITS
+      id | rand % (2 ** NUM_RANDOM_BITS)
     end
 
     # Determines when a given UUID was generated.
@@ -34,8 +35,21 @@ module Druuid
     #   Druuid.time 11142943683383068069
     #   # => 2012-02-04 00:00:00 -0800
     def time uuid, epoch_offset = epoch
-      ms = uuid >> (64 - 41)
-      Time.at (ms / 1e3) + epoch_offset.to_i
+      ms = uuid >> NUM_RANDOM_BITS
+      Time.at(ms / 1e3) + epoch_offset.to_i
+    end
+
+    # Determines the minimum UUID that could be generated for the given time.
+    #
+    # @param [Time] time of UUID
+    # @param [Numeric] epoch offset
+    # @return [Bignum] UUID
+    # @example
+    #   Druuid.min_for_time
+    #   # => 11142943683379200000
+    def min_for_time time = Time.now, epoch_offset = epoch
+      ms = ((time.to_f - epoch_offset.to_i) * 1e3).round
+      ms << NUM_RANDOM_BITS
     end
 
   end

data/spec/druuid_spec.rb

@@ -1,37 +1,46 @@
 require_relative '../druuid'
 
 describe Druuid do
-  describe '.gen' do
-    it 'generates a UUID' do
-      uuid = Druuid.gen
-      uuid.should be_instance_of Bignum
-      uuid.should_not eq Druuid.gen
-    end
-
+  shared_examples "druuid generator" do |method|
     let(:datetime) { Time.utc 2012, 2, 4, 8 }
     let(:prefix) { '111429436833' }
+
+    it "is a Bugnum" do
+      Druuid.send(method).should be_instance_of Bignum
+    end
+
     context 'with a given time' do
       it 'generates the UUID against the time' do
-        Druuid.gen(datetime).to_s[0, 12].should eq prefix
+        Druuid.send(method, datetime).to_s[0, 12].should eq prefix
       end
     end
 
     let(:offset) { 60 * 60 * 24 }
     context 'with a given epoch' do
       it 'generates the UUID against the offset' do
-        Druuid.gen(datetime + offset, offset).to_s[0, 12].should eq prefix
+        Druuid.send(method, datetime + offset, offset).to_s[0, 12].should eq prefix
       end
     end
 
     context 'with a default epoch' do
       before { @old_epoch, Druuid.epoch = Druuid.epoch, offset }
       it 'generates the UUID against the offset' do
-        Druuid.gen(datetime + offset).to_s[0, 12].should eq prefix
+        Druuid.send(method, datetime + offset).to_s[0, 12].should eq prefix
       end
       after { Druuid.epoch = @old_epoch }
     end
   end
 
+
+  describe '.gen' do
+    it_behaves_like 'druuid generator', :gen
+
+    it 'generates a UUID' do
+      uuid = Druuid.gen
+      uuid.should_not eq Druuid.gen
+    end
+  end
+
   describe '.time' do
     let(:datetime) { Time.utc 2012, 2, 4, 8 }
     let(:uuid) { 11142943683383068069 }
@@ -54,4 +63,14 @@ describe Druuid do
       after { Druuid.epoch = @old_epoch }
     end
   end
+
+  describe '.min_for_time' do
+    it_behaves_like 'druuid generator', :min_for_time
+
+    let(:datetime) { Time.utc 2012, 2, 4, 8 }
+    it 'generates druuid without random bits' do
+      random_bits = Druuid.min_for_time(Time.now) & Integer("0b" + ("1" * Druuid::NUM_RANDOM_BITS))
+      random_bits.should be_zero
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: druuid
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Stephen Celis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-17 00:00:00.000000000 Z
+date: 2017-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -66,10 +66,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Date-relative UUID generation
 test_files:
 - spec/druuid_spec.rb
-has_rdoc: