fernet 1.3 → 1.4

data/README.md

@@ -54,6 +54,17 @@ The `verified` variable will be true if:
 Otherwise, `verified` will be false, and you should deny the request with an
 HTTP 401, for example.
 
+The `Fernet.verify` method can be awkward if extracting the plain text data is
+required. For this case, a `verifier` can be requested that makes more
+pleasent:
+
+```ruby
+verifier = Fernet.verifier(secret, token)
+if verifier.valid? # signature valid, TTL verified
+  operate_on(verifier.data) # the original, decrypted data
+end
+```
+
 The specs
 ([spec/fernet_spec.rb](https://github.com/hgmnz/fernet/blob/master/spec/fernet_spec.rb))
 have more usage examples.

data/lib/fernet.rb

@@ -18,4 +18,10 @@ module Fernet
   def self.verify(secret, token, encrypt = Configuration.encrypt, &block)
     Verifier.new(secret, encrypt).verify_token(token, &block)
   end
+
+  def self.verifier(secret, token, encrypt = Configuration.encrypt)
+    Verifier.new(secret, encrypt).tap do |v|
+      v.verify_token(token)
+    end
+  end
 end

data/lib/fernet/verifier.rb

@@ -25,7 +25,11 @@ module Fernet
         custom_verification = true
       end
 
-      signatures_match? && token_recent_enough? && custom_verification
+      @valid = signatures_match? && token_recent_enough? && custom_verification
+    end
+
+    def valid?
+      @valid
     end
 
     def inspect

data/lib/fernet/version.rb

@@ -1,3 +1,3 @@
 module Fernet
-  VERSION = "1.3"
+  VERSION = "1.4"
 end

data/spec/fernet_spec.rb

@@ -135,4 +135,14 @@ describe Fernet do
       verifier.data['password'].should == 'password1'
     end
   end
+
+  it 'returns the unencrypted message upon verify' do
+    token = Fernet.generate(secret) do |generator|
+      generator.data['password'] = 'password1'
+    end
+
+    verifier = Fernet.verifier(secret, token)
+    verifier.should be_valid
+    verifier.data['password'].should == 'password1'
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fernet
 version: !ruby/object:Gem::Version
-  version: '1.3'
+  version: '1.4'
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yajl-ruby
-  requirement: &70208527724740 !ruby/object:Gem::Requirement
+  requirement: &70124570227380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208527724740
+  version_requirements: *70124570227380
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70208527724320 !ruby/object:Gem::Requirement
+  requirement: &70124570226960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +32,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70208527724320
+  version_requirements: *70124570226960
 description: Delicious HMAC Digest(if) authentication and encryption
 email:
 - harold.gimenez@gmail.com