gibbler 0.8.2 → 0.8.3

data/CHANGES.txt

@@ -1,5 +1,11 @@
 GIBBLER, CHANGES
 
+* TODO: Global salt
+
+#### 0.8.3 (2010-05-04) ###############################
+
+* ADDED: Support for global secret (Gibbler.secret) which is prepended to all digests.
+
 #### 0.8.2 (2010-04-29) ###############################
 
 * FIXED: test exception for "String has list of attic vars" tryouts when bundled with my other libraries. 

data/README.rdoc

@@ -135,6 +135,19 @@ In Jruby, you can grab the digest types from the openssl library.
     :kimmy.gibbler.to_i          # => 472384540402900668368761869477227308873774630879
 
 
+== Example 6 -- Global secret
+
+Gibbler can prepend all digest inputs with a global secret. You can set this once per project to ensure your project's digests are unique. 
+
+    require 'gibbler'
+    
+    :kimmy.gibbler               # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
+    
+    Gibbler.secret = "sUp0r5ekRu7"
+    
+    :kimmy.gibbler               # => 6c5f5aff4d809cec7e7da091214a35a2698489f8
+    
+
 == Supported Classes
 
 Gibbler methods are available only to the classes which explicitly include them (see RDocs[http://delano.github.com/gibbler] for details on which classes are supported by default). You can also extend custom objects:

data/gibbler.gemspec

@@ -1,7 +1,7 @@
 @spec = Gem::Specification.new do |s|
 	s.name = "gibbler"
   s.rubyforge_project = "gibbler"
-	s.version = "0.8.2"
+	s.version = "0.8.3"
 	s.summary = "Gibbler: Git-like hashes for Ruby objects"
 	s.description = s.summary
 	s.author = "Delano Mandelbaum"

data/lib/gibbler.rb

@@ -15,14 +15,18 @@ require 'digest/sha1'
 # "Hola, Tanneritos"
 #
 module Gibbler
-  VERSION = "0.8.2"
+  VERSION = "0.8.3"
+  
+  @secret = nil
+  class << self
+    attr_accessor :secret
+  end
   
   require 'gibbler/mixins'
   
   class Error < RuntimeError
     def initialize(obj); @obj = obj; end
   end
-  
 end
 
 
@@ -224,9 +228,13 @@ module Gibbler
   
   # Sends +str+ to Digest::SHA1.hexdigest. If another digest class
   # has been specified, that class will be used instead. 
+  # If Gibbler.secret is set, +str+ will be prepended with the
+  # value. 
+  #
   # See: digest_type
   def self.digest(str, digest_type=nil)
     digest_type ||= @@gibbler_digest_type
+    str = [Gibbler.secret, str].join(':') unless Gibbler.secret.nil?
     digest_type.hexdigest str
   end
   

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: gibbler
 version: !ruby/object:Gem::Version 
-  version: 0.8.2
+  version: 0.8.3
 platform: ruby
 authors: 
 - Delano Mandelbaum
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-29 00:00:00 -04:00
+date: 2010-05-04 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency