uuid 2.1.1 → 2.2.0

data/CHANGELOG

@@ -1,3 +1,6 @@
+2.2.0 (2010-02-18)
+* Added: set UUID.state_file = false if you cannot use a state file (e.g. shared hosting environment)
+
 2.1.1 (2010-01-27)
 * Fixed bug which caused UUID.new to fail if the state file was somehow extant but empty
 

data/README.rdoc

@@ -68,6 +68,12 @@ writable, the file is created as <tt>.ruby-uuid</tt> in the home directory.
 If you need to create the file with a different mode, use UUID#state_file
 before running the UUID generator.
 
+Note: If you are running on a shared host where the state file is not shared
+between processes, or persisted across restarts (e.g. Heroku, Google App
+Engine) you can simple turn it off:
+
+  UUID.state_file = false
+
 State files are not portable across machines.
 
 

data/lib/uuid.rb

@@ -132,7 +132,7 @@ class UUID
   #
   # State files are not portable across machines.
   def self.state_file(mode = 0644)
-    return @state_file if @state_file
+    return @state_file unless @state_file.nil?
 
     @mode = mode
 
@@ -159,7 +159,11 @@ class UUID
   end
 
   ##
-  # Specify the path of the state file.
+  # Specify the path of the state file.  Use this if you need a different
+  # location for your state file.
+  #
+  # Set to false if your system cannot use a state file (e.g. many shared
+  # hosts).
   def self.state_file=(path)
     @state_file = path
   end
@@ -180,15 +184,18 @@ class UUID
     @last_clock = (Time.now.to_f * CLOCK_MULTIPLIER).to_i
     @mutex = Mutex.new
 
-    if File.size?(self.class.state_file) then
+    state_file = self.class.state_file
+    if state_file && File.size?(state_file) then
       next_sequence
     else
       @mac = Mac.addr.gsub(/:|-/, '').hex & 0x7FFFFFFFFFFF
       fail "Cannot determine MAC address from any available interface, tried with #{Mac.addr}" if @mac == 0
       @sequence = rand 0x10000
 
-      open_lock 'w' do |io|
-        write_state io
+      if state_file
+        open_lock 'w' do |io|
+          write_state io
+        end
       end
     end
   end
@@ -244,15 +251,19 @@ class UUID
   ##
   # Updates the state file with a new sequence number.
   def next_sequence
-    open_lock 'r+' do |io|
-      @mac, @sequence, @last_clock = read_state(io)
+    if self.class.state_file
+      open_lock 'r+' do |io|
+        @mac, @sequence, @last_clock = read_state(io)
 
-      io.rewind
-      io.truncate 0
+        io.rewind
+        io.truncate 0
 
-      @sequence += 1
+        @sequence += 1
 
-      write_state io
+        write_state io
+      end
+    else
+      @sequence += 1
     end
   rescue Errno::ENOENT
     open_lock 'w' do |io|

data/test/test-uuid.rb

@@ -21,6 +21,16 @@ class TestUUID < Test::Unit::TestCase
     assert_equal path, UUID.state_file
   end
 
+  def test_with_no_state_file
+    UUID.state_file = false
+    assert !UUID.state_file
+    uuid = UUID.new
+    assert_match(/\A[\da-f]{32}\z/i, uuid.generate(:compact))
+    seq = uuid.next_sequence
+    assert_equal seq + 1, uuid.next_sequence
+    assert !UUID.state_file
+  end
+
   def test_instance_generate
     uuid = UUID.new
     assert_match(/\A[\da-f]{32}\z/i, uuid.generate(:compact))

data/uuid.gemspec

@@ -1,6 +1,6 @@
 spec = Gem::Specification.new do |spec|
   spec.name = 'uuid'
-  spec.version = '2.1.1'
+  spec.version = '2.2.0'
   spec.summary = "UUID generator"
   spec.description = <<-EOF
 UUID generator for producing universally unique identifiers based on RFC 4122

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: uuid
 version: !ruby/object:Gem::Version 
-  version: 2.1.1
+  version: 2.2.0
 platform: ruby
 authors: 
 - Assaf Arkin
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-27 00:00:00 -08:00
+date: 2010-02-18 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -23,10 +23,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: "1.0"
     version: 
-description: |
-  UUID generator for producing universally unique identifiers based on RFC 4122
-  (http://www.ietf.org/rfc/rfc4122.txt).
-
+description: UUID generator for producing universally unique identifiers based on RFC 4122 (http://www.ietf.org/rfc/rfc4122.txt).
 email: assaf@labnotes.org
 executables: []
 
@@ -45,8 +42,6 @@ files:
 - uuid.gemspec
 has_rdoc: true
 homepage: http://github.com/assaf/uuid
-licenses: []
-
 post_install_message: 
 rdoc_options: 
 - --main
@@ -71,9 +66,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.3.1
 signing_key: 
-specification_version: 3
+specification_version: 2
 summary: UUID generator
 test_files: []