apache_secure_download 0.0.2.213 → 0.0.3.217

data/ChangeLog

@@ -1,5 +1,11 @@
 = Revision history for apache_secure_download
 
+== 0.0.3 [2008-02-25]
+
+* Apache::SecureDownload::Util.secure_url
+** also takes a hash with options instead of explicit expiration time
+** can create cacheable URLs by setting the <tt>:cache</tt> option
+
 == 0.0.2 [2008-02-20]
 
 * Added helper module Apache::SecureDownload::Util

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to apache_secure_download version 0.0.2
+This documentation refers to apache_secure_download version 0.0.3
 
 
 == DESCRIPTION
@@ -32,6 +32,12 @@ And create links to your resources with timestamp and token:
   # or simply use the provided helper:
   url = Apache::SecureDownload::Util.secure_url("secret", path, 1.minute.from_now)
 
+  # make resulting URL cacheable for 30 seconds (on average):
+  url = Apache::SecureDownload::Util.secure_url("secret", path, :expires => 1.minute.from_now, :cache => 30)
+
+  # specify expiration time using an offset (results in Time.now + 60; also includes caching for 60 seconds):
+  url = Apache::SecureDownload::Util.secure_url("secret", path, :offset => 60)
+
 
 == AUTHORS
 

data/lib/apache/secure_download/util.rb

@@ -41,11 +41,20 @@ module Apache
         Digest::SHA1.hexdigest(secret + path + timestamp.to_s)
       end
 
-      def secure_url(secret, url, timestamp = Time.now + 60)
+      def secure_url(secret, url, expires = Time.now + 60)
         path, _, query = URI.split(url)[5..7]
         path << '?' << query if query
 
-        timestamp = timestamp.to_i
+        if expires.is_a?(Hash)
+          timestamp = (expires[:expires] || Time.now + (expires[:offset] ||= 60)).to_i
+
+          unless expires[:cache] == false || (cache = expires[:cache] || expires[:offset]).zero?
+            # makes the URL cacheable for +cache+ seconds *on average*
+            timestamp = ((timestamp / cache.to_f).round + 1) * cache.to_i
+          end
+        else
+          timestamp = expires.to_i
+        end
 
         url + "#{query ? '&' : '?'}timestamp=#{timestamp}&token=#{token(secret, path, timestamp)}"
       end

data/lib/apache/secure_download/version.rb

@@ -6,7 +6,7 @@ module Apache
 
       MAJOR = 0
       MINOR = 0
-      TINY  = 2
+      TINY  = 3
 
       class << self
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: apache_secure_download
 version: !ruby/object:Gem::Version 
-  version: 0.0.2.213
+  version: 0.0.3.217
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-02-20 00:00:00 +01:00
+date: 2008-02-25 00:00:00 +01:00
 default_executable: 
 dependencies: []