imglab 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf939223729128b42634757899edf1587158d8ca042246f53eb87a440fca5251
-  data.tar.gz: 7635dd0f8eab66ab587b95e48665660d836a7a0d598601098b83f884f18bdcdd
+  metadata.gz: 78faee0a4ff6558f7ece0d993cac443de2b480e0c230a5586dc6fdbc8c6867db
+  data.tar.gz: e6cbb31a3d1e86d8b54cc7c9985b10cd3555886d941ca66925b6752f8bacf51d
 SHA512:
-  metadata.gz: 22943677cf74e75e8a77b52f0ac83c5eed5df72c85edb54180eba8c262881f0d264cc60ed40b015dec1b6aeecd7deb9d65d86493162dc6068d3ad8a546a321fa
-  data.tar.gz: 367a286bd40425c71594cf151a3d9a72d9f1a51291104b123bc778ddd342ed61f1d8572b1ef14c7e827932638051f236b9c99faacee029719e18c1017037f5ea
+  metadata.gz: cb456e7d68b9e66ae072ec27f5232c455cd32f040b3b029dbd0d03362709f22bbd3c61a3b2d908589eff85ff28dde67ceba0c7dd2d12ccb458a121ac035c4974
+  data.tar.gz: 4053ed5c372ad62d78bd0af9c8d762b0cd9a6dfa9cba6215328d59bfd73e75951b96c97986ee5657a455954d3fd09cc4d8ce91292edda7061a67b006e8e3c329

data/Gemfile

@@ -5,4 +5,4 @@ gemspec
 
 gem "rake", "~> 12.0"
 gem "minitest", "~> 5.11.3"
-gem "yard", "~> 0.9.26"
+gem "yard", "~> 0.8.7"

data/README.md

@@ -234,6 +234,24 @@ Imglab.url(
 
 `signature` query parameter will be automatically generated and attached to the nested URL value.
 
+### Specifying URLs with expiration timestamp
+
+The `expires` parameter allows you to specify a UNIX timestamp in seconds after which the request is expired.
+
+If a Ruby `Time` instance is used as value to `expires` parameter it will be automatically converted to UNIX timestamp. In the following example, we specify an expiration time of one hour, adding 3600 seconds to the current time:
+
+```ruby
+Imglab.url("assets", "image.jpeg", width: 500, expires: Time.now.utc + 3600)
+```
+
+If you are using Rails or Active Support you can use it's time helpers:
+
+```ruby
+Imglab.url("assets", "image.jpeg", width: 500, expires: 1.hour.from_now)
+```
+
+> Note: The `expires` parameter should be used in conjunction with secure sources. Otherwise, `expires` value could be tampered with.
+
 ## Generating URLs for on-premises imglab server
 
 For on-premises imglab server is possible to define custom sources pointing to your server location.

data/lib/imglab/utils.rb

@@ -18,8 +18,7 @@ class Imglab::Utils
   # @return [Hash]
   def self.normalize_params(params)
     params.inject({}) do |normalized_params, value|
-      normalized_params[dasherize(value[0])] = value[1]
-      normalized_params
+      normalized_params.merge(normalize_param(dasherize(value[0]), value[1]))
     end
   end
 
@@ -38,4 +37,13 @@ class Imglab::Utils
   def self.dasherize(value)
     value.to_s.gsub("_", "-")
   end
+
+  def self.normalize_param(key, value)
+    case
+    when key == "expires" && value.instance_of?(Time)
+      {key => value.to_i}
+    else
+      {key => value}
+    end
+  end
 end

data/lib/imglab/version.rb

@@ -1,3 +1,3 @@
 module Imglab
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imglab
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - imglab
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-05-12 00:00:00.000000000 Z
+date: 2022-06-06 00:00:00.000000000 Z
 dependencies: []
 description: Official Ruby library to integrate with imglab services.
 email:
@@ -54,7 +54,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Official imglab Ruby library.