filestack-rails 2.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f1f3cbfc96c33d255ffb170527ff78949bda896a
+  data.tar.gz: 70d836e748adffc356bb29c2d0b3b36053c48bff
+SHA512:
+  metadata.gz: 9176a5865055c079f5bdbffcebfef170ad5848e8f571b0ea2751c457c9c2c87ada8356673175144fc21d751a968cbee802140d1ad1e64fdb61b5aebbfda47b8a
+  data.tar.gz: 5b6c5524f1e2bb9c27bbe00ad37317b80b23969f27dde7eaf356b903ffc1c00baccefea2e16b223203a7d5351dc54bd71eb942030a9230621bb736b78d5929cc

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 YOURNAME
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,192 @@
+# Filepicker::Rails
+[![RubyGems][gem_version_badge]][ruby_gems]
+[![Travis CI][travis_ci_badge]][travis_ci]
+[![Coveralls][coveralls_badge]][coveralls]
+[![Code Climate][code_climate_badge]][code_climate]
+
+Adds form, image_tag, and download/save helpers to help you get up and running with [filestack.com](http://filestack.com) in Rails.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'filepicker-rails'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install filepicker-rails
+
+Add the filestack.com javascript library to your layout:
+
+```erb
+<%= filepicker_js_include_tag %>
+```
+
+Set your API Key in `config/application.rb`:
+
+```ruby
+config.filepicker_rails.api_key = "Your Filestack API Key"
+```
+
+## Usage
+
+### First create a migration to add the field that will hold your Filestack URL
+
+Run the Rails migration generator from the command line:
+
+    $ rails g migration AddNameOfAttrForFilepickerUrlToUser
+
+Then add a column to the model's table of type :string:
+
+```ruby
+class AddNameOfAttrForFilepickerUrlToUser < ActiveRecord::Migration
+  def change
+    add_column :user, :filepicker_url, :string
+  end
+end
+```
+
+### Adding an upload field to your form:
+
+```erb
+<%= form_for @user do |f| %>
+  <div>
+    <%= f.label :filepicker_url, "Upload Your Avatar:" %>
+    <%= f.filepicker_field :filepicker_url %> <!-- User#filepicker_url is a regular string column -->
+  </div>
+
+  <%= f.submit %>
+<% end %>
+```
+The `filepicker_field` accepts a options parameter, [click here to see all the valid options](http://rubydoc.info/github/filestack/filepicker-rails/master/FilepickerRails/FormHelper:filepicker_field).
+
+### Displaying an image:
+
+```erb
+<%= filepicker_image_tag @user.filepicker_url, w: 160, h: 160, fit: 'clip' %>
+```
+
+The `filepicker_image_tag` accepts a options parameter, [click here to see all the valid options](http://rubydoc.info/github/filestack/filepicker-rails/master/FilepickerRails/ApplicationHelper:filepicker_image_url).
+
+### Accessing FilePicker File with OnChange:
+
+Javascript code in the onchange field acts as a callback, which is
+called on upload completion. You can specify onchange either in the ERB
+template (as shown below), or unobtrusively via jQuery's change event.
+
+```erb
+<%= form_for @user do |f| %>
+  <div>
+    <%= f.label :filepicker_url, "Upload Your Avatar:" %>
+    <%= f.filepicker_field :filepicker_url, onchange: 'onPhotoUpload(event)' %>
+  </div>
+
+  <%= f.submit %>
+<% end %>
+```
+
+The callback is called with a special 'event' variable. The variable has a fpfiles (or if not multiple, also fpfile) attribute with information about the files (jQuery users: look under event.originalEvent).
+
+Example fpfiles object:
+```javascript
+[{
+    url: 'https://...',
+    data: {
+        filename: 'filename.txt',
+        size: 100,
+        type: 'text/plain'
+    }
+},{
+    url: 'https://...',
+    data: {
+        filename: 'filename2.jpg',
+        size: 9000,
+        type: 'image/jpeg'
+    }
+}]
+```
+
+### Allowing the user to download a file (or upload it to any of the supported services)
+
+```erb
+<%= filepicker_save_button "Save", @user.filepicker_url, "image/jpg" %>
+```
+
+The `filepicker_save_button` accepts a options parameter, [click here to see all the valid options](http://rubydoc.info/github/filestack/filepicker-rails/master/FilepickerRails/ApplicationHelper:filepicker_save_button).
+
+### CDN
+
+Set your CDN Path in `config/production.rb` ([CDN usage](https://www.filepicker.com/documentation/cdn/)):
+
+```ruby
+config.filepicker_rails.cdn_host = "Your CDN host name"
+```
+
+### Policy
+
+To use the [filepicker policies](https://filestack.com/docs/security/) follow this instructions.
+
+Set your Secret Key in `config/application.rb`
+
+```ruby
+config.filepicker_rails.secret_key = "Your Filestack Secret Key"
+```
+
+#### Expiry time
+
+By default the expiry time is 10 minutes. If you need to change the expiry time this should be an integer and it is expressed in seconds since the [Epoch](http://en.wikipedia.org/wiki/Unix_time).
+
+So you can do something like that to set the expiry time to 5 minutes.
+
+```ruby
+config.filepicker_rails.expiry = -> { (Time.zone.now + 5.minutes).to_i }
+```
+
+If you need always the same url, a static expiry time, to do some cache. You can set a date starting of the Epoch.
+
+```ruby
+-> { 100.years.since(Time.at(0)).to_i }
+```
+
+The argument need to be a [callable](http://www.rubytapas.com/episodes/35-Callable).
+
+## Demo
+
+See a simple demo app [repo](https://github.com/maxtilford/filepicker-rails-demo)
+
+## RDocs
+
+You can view the Filepicker::Rails documentation in RDoc format here:
+
+http://rubydoc.info/github/filestack/filepicker-rails/master/frames
+
+## Versioning
+
+Filepicker::Rails follow the [Semantic Versioning](http://semver.org/).
+
+## Issues
+
+If you have problems, please create a [Github Issue](https://github.com/filestack/filepicker-rails/issues).
+
+## Contributing
+
+Please see [CONTRIBUTING.md](https://github.com/filestack/filepicker-rails/blob/master/CONTRIBUTING.md) for details.
+
+## Credits
+
+Thank you to all the [contributors](https://github.com/filestack/filepicker-rails/graphs/contributors).
+
+[gem_version_badge]: https://badge.fury.io/rb/filepicker-rails.png
+[ruby_gems]: http://rubygems.org/gems/filepicker-rails
+[travis_ci]: http://travis-ci.org/Ink/filepicker-rails
+[travis_ci_badge]: https://travis-ci.org/Ink/filepicker-rails.svg?branch=master
+[code_climate]: https://codeclimate.com/github/Ink/filepicker-rails
+[code_climate_badge]: https://codeclimate.com/github/Ink/filepicker-rails.png
+[coveralls]: https://coveralls.io/r/Ink/filepicker-rails
+[coveralls_badge]: https://coveralls.io/repos/Ink/filepicker-rails/badge.png?branch=master

data/Rakefile

@@ -0,0 +1,37 @@
+begin
+  require 'bundler/setup'
+  require 'appraisal'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rspec/core/rake_task'
+require 'rdoc/task'
+
+RSpec::Core::RakeTask.new
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'FilepickerRails'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+task :default do
+  if ENV['BUNDLE_GEMFILE'] =~ /gemfiles/
+    Rake::Task['spec'].invoke
+  else
+    Rake::Task['appraise'].invoke
+  end
+end
+
+task :appraise do
+  exec 'appraisal install && appraisal rake'
+end
+
+Bundler::GemHelper.install_tasks
+

data/app/helpers/filepicker_rails/application_helper.rb

@@ -0,0 +1,267 @@
+module FilepickerRails
+  module ApplicationHelper
+
+    include FilepickerRails::Tag
+
+    # Creates a javascript tag to the filepicker JavaScript.
+    #
+    # #### Examples
+    #
+    #     filepicker_js_include_tag
+    #     # => <script src="//api.filepicker.io/v1/filepicker.js"></script>
+    def filepicker_js_include_tag
+      javascript_include_tag "//api.filepicker.io/v2/filepicker.js", type: "text/javascript"
+    end
+
+    # Creates a filepicker field tag, accepts optional `options` hash for configuration.
+    #
+    # #### Options
+    #
+    # - `:button_text` - The text of the upload button.
+    # - `:button_class` - The class of the upload button.
+    # - `:extensions` - The extensions of file types you want to support for this upload. Ex: `.png,.jpg`.
+    # - `:mimetypes` - The file types you want to support for this upload. Ex: `image/png,text/*`.
+    # - `:container` - Where to show the file picker dialog can be `modal`, `window` or the id of an iframe on the page.
+    # - `:multiple` - (true or false) Whether or not multiple uploads can be saved at once.
+    # - `:services` - What services your users can upload to. Ex: `BOX, COMPUTER, FACEBOOK`.
+    # - `:store_path` - The path to store the file at within the specified file store.
+    # - `:store_location` - The file is not copied by default. It remains in the original location. If you wish you have the file copied onto your own storage, you can specify where we should put the copy. The only value at the moment is `S3`.
+    # - `:store_container` - The bucket or container in your specified `store_location`. Defaults to the container specified in the developer portal. Does not apply to Dropbox storage.
+    # - `:store_access` - Should the underlying file be publicly available on its S3 link. Options are `public` and `private`, defaults to 'private'.
+    # - `:dragdrop` - (`true` or `false`) Whether or not to allow drag-and-drop uploads.
+    # - `:drag_text` - The text of the dragdrop pane.
+    # - `:drag_class` - The class of the dragdrop pane.
+    # - `:onchange` - The onchange event.
+    # - `:max_size` - The maximum file size allowed, in bytes.
+    # - `:max_files` - The maximum number of files.
+    # - `:open_to` - Open the picker to the given service. Ex: `COMPUTER`.
+    # - `:class` - Add a class to the input.
+    # - `:value` - Define the value of the input
+    #
+    # #### Examples
+    #
+    #     filepicker_field_tag('user[filepicker_url]')
+    #     # => <input data-fp-apikey="..." id="user_filepicker_url" name="user[filepicker_url]" type="filepicker" />
+    #
+    def filepicker_field_tag(name, options = {})
+      define_input_options(options)
+      tag :input, { 'type' => type, 'name' => name, 'id' => sanitize_to_id(name) }.update(input_options.stringify_keys)
+    end
+
+    # Creates a button allowing the user to download a file
+    # (or upload it to any of the supported services). Set the content of
+    # the button on the `text` parameter. The `url` of the content you want the user to save.
+    # Define the `mimetype` of the content. Accepts a optional `options` parameter.
+    #
+    # #### Options
+    #
+    # - `:container` - Where to show the file picker dialog can be `modal`,
+    # `window` or the id of an iframe on the page.
+    # - `:services` - What services your users can upload to. Ex: `BOX, COMPUTER, FACEBOOK`.
+    # - `:save_as_name` - A recommended file name. The user can override this.
+    #
+    # #### Examples
+    #
+    #     filepicker_save_button "Save", @user.filepicker_url, "image/jpg"
+    #     # => <button data-fp-apikey="..." data-fp-mimetype="image/jpg" data-fp-url="https://www.filepicker.io/api/file/hFHUCB3iTxyMzseuWOgG" name="button" type="submit">save</button>
+    #
+    def filepicker_save_button(text, url, mimetype, options = {})
+      export_widget(text, url, mimetype, options) do
+        button_tag(text, options)
+      end
+    end
+
+    # Creates a link allowing the user to download a file
+    # (or upload it to any of the supported services). Set the content of
+    # the link on the `text` parameter. The `url` of the content you want the user to save.
+    # Define the `mimetype` of the content. Accepts a optional `options` parameter.
+    #
+    # #### Options
+    #
+    # - `:container` - Where to show the file picker dialog can be `modal`,
+    # `window` or the id of an iframe on the page.
+    # - `:services` - What services your users can upload to. Ex: `BOX, COMPUTER, FACEBOOK`.
+    # - `:save_as_name` - A recommended file name. The user can override this.
+    #
+    # #### Examples
+    #
+    #     filepicker_save_link "Save", @user.filepicker_url, "image/jpg"
+    #     # => <a data-fp-apikey="..." data-fp-mimetype="image/jpg" data-fp-url="https://www.filepicker.io/api/file/hFHUCB3iTxyMzseuWOgG" href="#" id="filepicker_export_widget_link">save</a>
+    #
+    def filepicker_save_link(text, url, mimetype, options = {})
+      export_widget(text, url, mimetype, options) do
+        options[:id] = options.fetch(:id, 'filepicker_export_widget_link')
+        link_to text, '#', options
+      end
+    end
+
+    # Creates a image tag of the `url`. Accepts the options to work on filepicker.io,
+    # see the valid options on `filepicker_image_url` documentation. Accepts html options to the image tag,
+    # see the [image_tag](http://api.rubyonrails.org/classes/ActionView/Helpers/AssetTagHelper.html#method-i-image_tag)
+    # documentation for the valid options.
+    #
+    # #### Examples
+    #
+    #      filepicker_image_tag @user.filepicker_url, w: 160, h: 160, fit: 'clip'
+    #      # => <img src="https://www.filepicker.io/api/file/hFHUCB3iTxyMzseuWOgG/convert?w=160&h=160&fit=clip" />
+    #
+    def filepicker_image_tag(url, image_options={}, image_tag_options={})
+      image_tag(filepicker_image_url(url, image_options), image_tag_options)
+    end
+
+    # Creates the full path of the image to the specified `url` accepts optional `options`
+    # hash for configuration.
+    #
+    # #### Options
+    #
+    # - `:w` - Resize the image to this width.
+    #
+    # - `:h` - Resize the image to this height.
+    #
+    # - `:fit` - Specifies how to resize the image. Possible values are:
+    #     - `:clip` - Resizes the image to fit within the specified parameters without
+    #             distorting, cropping, or changing the aspect ratio, this is the default.
+    #     - `:crop` - Resizes the image to fit the specified parameters exactly by
+    #             removing any parts of the image that don't fit within the boundaries
+    #     - `:scales` - Resizes the image to fit the specified parameters exactly by
+    #               scaling the image to the desired size
+    # - `:align` - Determines how the image is aligned when resizing and using the "fit" parameter.
+    #         Check API for details.
+    #
+    # - `:rotate` - Rotate the image. Default is no rotation. Possible values are:
+    #     - `:exif` - will rotate the image automatically based on the exif data in the image.
+    #     -  Other valid values are integers between 0 and 359, for degrees of rotation.
+    #
+    # - `:crop` - Crops the image to a specified rectangle. The input to this parameter
+    #        should be 4 numbers for `x,y,width,height` - for example,
+    #        `10, 20, 200, 250` would select the 200x250 pixel rectangle starting
+    #        from 10 pixels from the left edge and 20 pixels from the top edge of the
+    #        image.
+    #
+    # - `:crop_first` - Makes sure the image is cropped before any other
+    #                   conversion parameters are executed.
+    #                   The only value for this parameter is `true`.
+    #
+    # - `:format` - Specifies what format the image should be converted to, if any.
+    #          Possible values are `jpg` and `png`. For `jpg` conversions, you
+    #          can additionally specify a quality parameter.
+    #
+    # - `:quality` - For jpeg conversion, specifies the quality of the resultant image.
+    #           Quality should be an integer between 1 and 100
+    #
+    # - `:watermark` - Adds the specified absolute url as a watermark on the image.
+    #
+    # - `:watersize` - This size of the watermark, as a percentage of the base
+    #             image (not the original watermark).
+    #
+    # - `:waterposition` - Where to put the watermark relative to the base image.
+    #                 Possible values for vertical position are `top`,`middle`,
+    #                 `bottom` and `left`,`center`,`right`, for horizontal
+    #                 position. The two can be combined by separating vertical
+    #                 and horizontal with a comma. The default behavior
+    #                 is bottom,right
+    #
+    # - `:cache` - Specifies if the image should be cached or not.
+    #
+    # #### Examples
+    #
+    #      filepicker_image_url @user.filepicker_url, w: 160, h: 160, fit: 'clip'
+    #      # => https://www.filepicker.io/api/file/hFHUCB3iTxyMzseuWOgG/convert?w=160&h=160&fit=clip
+    #
+    def filepicker_image_url(url, options = {})
+      FilepickerImageUrl.new(url, options).execute
+    end
+
+    class FilepickerImageUrl
+
+      CONVERT_OPTIONS = [:w, :h, :fit, :align, :rotate, :crop, :format,
+                         :quality, :watermark, :watersize, :waterposition,
+                         :crop_first]
+      VALID_OPTIONS   = CONVERT_OPTIONS + [:cache]
+
+      def initialize(url, options = {})
+        @url, @options = url, options
+      end
+
+      def execute
+        base_url = url_with_path.split('?').first
+        query_params = all_options.to_query
+
+        [base_url, query_params.presence].compact.join('?')
+      end
+
+      private
+
+        attr_reader :url, :options
+
+        def valid_options
+          options.select { |option| VALID_OPTIONS.include?(option) }
+        end
+
+        def convert_options
+          options.select { |option| CONVERT_OPTIONS.include?(option) }
+        end
+
+        def all_options
+          [original_url_options, valid_options, policy_config].inject(&:merge)
+        end
+
+        def original_url_options
+          query_string = url_with_path.split('?')[1]
+
+          if query_string
+            Rack::Utils.parse_nested_query(query_string)
+          else
+            {}
+          end
+        end
+
+        def cdn_host
+          @cdn_host ||= ::Rails.application.config.filepicker_rails.cdn_host
+        end
+
+        def cdn_url
+          if cdn_host
+            uri = URI.parse(url)
+            url.gsub("#{uri.scheme}://#{uri.host}", cdn_host)
+          else
+            url
+          end
+        end
+
+        def policy_config
+          Policy.apply
+        end
+
+        def url_with_path
+          @url_with_path ||= if append_convert_on_url_path?
+            "#{cdn_url}/convert"
+          else
+            cdn_url
+          end
+        end
+
+        def append_convert_on_url_path?
+          convert_options.any? && !cdn_url.match('/convert')
+        end
+    end
+    private_constant :FilepickerImageUrl
+
+    private
+
+      def export_widget(text, url, mimetype, options, &block)
+        options[:data] ||= {}
+        container = options.delete(:container)
+        services = options.delete(:services)
+        save_as = options.delete(:save_as_name)
+
+        options[:data]['fp-url'] = url
+        options[:data]['fp-apikey'] = ::Rails.application.config.filepicker_rails.api_key
+        options[:data]['fp-mimetype'] = mimetype
+        options[:data]['fp-option-container'] = container if container
+        options[:data]['fp-option-services'] = Array(services).join(",") if services
+        options[:data]['fp-option-defaultSaveasName'] = save_as if save_as
+        block.call
+      end
+  end
+end

data/app/helpers/filepicker_rails/form_helper.rb

@@ -0,0 +1,71 @@
+module FilepickerRails
+  module FormHelper
+
+    include FilepickerRails::Tag
+
+    # Creates a filepicker field, accepts optional `options` hash for configuration.
+    #
+    # #### Options
+    #
+    # - `:button_text` - The text of the upload button.
+    # - `:button_class` - The class of the upload button.
+    # - `:extensions` - The extensions of file types you want to support for this upload. Ex: `.png,.jpg`.
+    # - `:mimetypes` - The file types you want to support for this upload. Ex: `image/png,text/*`.
+    # - `:container` - Where to show the file picker dialog can be `modal`, `window` or the id of an iframe on the page.
+    # - `:multiple` - (true or false) Whether or not multiple uploads can be saved at once.
+    # - `:services` - What services your users can upload to. Ex: `BOX, COMPUTER, FACEBOOK`.
+    # - `:store_path` - The path to store the file at within the specified file store.
+    # - `:store_location` - The file is not copied by default. It remains in the original location. If you wish you have the file copied onto your own storage, you can specify where we should put the copy. The only value at the moment is `S3`.
+    # - `:store_container` - The bucket or container in your specified `store_location`. Defaults to the container specified in the developer portal. Does not apply to Dropbox storage.
+    # - `:store_access` - Should the underlying file be publicly available on its S3 link. Options are `public` and `private`, defaults to 'private'.
+    # - `:dragdrop` - (`true` or `false`) Whether or not to allow drag-and-drop uploads.
+    # - `:drag_text` - The text of the dragdrop pane.
+    # - `:drag_class` - The class of the dragdrop pane.
+    # - `:onchange` - The onchange event.
+    # - `:max_size` - The maximum file size allowed, in bytes.
+    # - `:max_files` - The maximum number of files.
+    # - `:open_to` - Open the picker to the given service. Ex: `COMPUTER`.
+    # - `:class` - Add a class to the input.
+    # - `:value` - Define the value of the input
+    #
+    # #### Examples
+    #
+    #     filepicker_field(:filepicker_url)
+    #     # => <input data-fp-apikey="..." id="user_filepicker_url" name="user[filepicker_url]" type="filepicker" />
+    #
+    # This is mixed on form for to be used like.
+    #
+    #     <%= form_for @user do |f| %>
+    #       <%= f.filepicker_field :filepicker_url %>
+    #       <%= f.submit %>
+    #     <% end %>
+    #
+    def filepicker_field(method, options = {})
+      define_input_options(options)
+      @method = method
+      if rails_greater_than_4?
+        rails_greater_than_4_input
+      else
+        rails_input
+      end
+    end
+
+    private
+
+      attr_reader :method, :object_name, :template
+
+      def rails_greater_than_4_input
+        tag = ActionView::Helpers::Tags::TextField.new(object_name, method, template, objectify_options(input_options))
+        tag.send(:add_default_name_and_id, input_options)
+        tag.render
+      end
+
+      def rails_input
+        ActionView::Helpers::InstanceTag.new(object_name, method, template).to_input_field_tag(type, input_options)
+      end
+
+      def rails_greater_than_4?
+        ::Rails.version.to_i >= 4
+      end
+  end
+end

data/lib/filepicker-rails.rb

@@ -0,0 +1,7 @@
+require "filepicker_rails/configuration"
+require "filepicker_rails/policy"
+require "filepicker_rails/engine"
+require "filepicker_rails/tag"
+
+module FilepickerRails
+end

data/lib/filepicker_rails/configuration.rb

@@ -0,0 +1,77 @@
+module FilepickerRails
+  class Configuration
+
+    # Define your API Key to be used.
+    #
+    # #### Examples
+    #
+    # This is to be used on the `config/application.rb`:
+    #
+    #      config.filepicker_rails.api_key = 'Your filepicker.io API Key'
+    #
+    attr_writer :api_key
+
+    # Define your Secret key to be used on Policy.
+    #
+    # More info about Policy on [Ink documentation](https://developers.filepicker.io/docs/security/)
+    #
+    # #### Examples
+    #
+    # This is to be used on the `config/application.rb`:
+    #
+    #      config.filepicker_rails.secret_key = 'Your filepicker.io Secret Key'
+    #
+    attr_writer :secret_key
+
+    # @private
+    attr_reader :secret_key
+
+    # Set your CDN Path to be used
+    #
+    # More info about CDN on [Ink documentation](https://developers.filepicker.io/docs/cdn/)
+    #
+    # #### Examples
+    #
+    # This is to be used on the `config/application.rb`:
+    #
+    #      config.filepicker_rails.cdn_host = 'Your CDN host name'
+    #
+    attr_writer :cdn_host
+
+    # @private
+    attr_reader :cdn_host
+
+    # @private
+    def api_key
+      @api_key or raise "Set config.filepicker_rails.api_key"
+    end
+
+    # Define the expire time when using Policy.
+    #
+    # By default the expiry time is 10 minutes.
+    # If you need to change the expiry time this should be an integer and
+    # it is expressed in seconds since the [Epoch](http://en.wikipedia.org/wiki/Unix_time).
+    #
+    # #### Examples
+    #
+    # This is to be used on the `config/application.rb`:
+    #
+    #      config.filepicker_rails.expiry = -> { (Time.zone.now + 5.minutes).to_i }
+    #      # Define the expiry time to 5 minutes
+    #
+    # If you need always the same url, a static expiry time, to do some cache.
+    # You can set a date starting of the Epoch.
+    #
+    #     config.filepicker_rails.expiry = -> { 100.years.since(Time.at(0)).to_i }
+    #
+    def expiry=(expiry)
+      raise ArgumentError, 'Must be a callable' unless expiry.respond_to?(:call)
+      @expiry = expiry
+    end
+
+    # @private
+    def expiry
+      @expiry ||= -> { Time.zone.now.to_i + 600 }
+    end
+  end
+end

data/lib/filepicker_rails/engine.rb

@@ -0,0 +1,17 @@
+module FilepickerRails
+  # @private
+  class Engine < ::Rails::Engine
+    config.filepicker_rails = FilepickerRails::Configuration.new
+    isolate_namespace FilepickerRails
+
+    initializer "filepicker_rails.form_builder" do
+      ActionView::Helpers::FormBuilder.send(:include, FilepickerRails::FormHelper)
+    end
+
+    initializer 'filepicker_rails.action_controller' do |app|
+      ActiveSupport.on_load(:action_controller) do
+        helper FilepickerRails::ApplicationHelper
+      end
+    end
+  end
+end

data/lib/filepicker_rails/policy.rb

@@ -0,0 +1,46 @@
+require 'base64'
+require 'openssl'
+
+module FilepickerRails
+  class Policy
+    attr_accessor :expiry, :call, :handle, :maxsize, :minsize, :path
+
+    def initialize(options = {})
+      [:expiry, :call, :handle, :maxsize, :minsize, :path].each do |input|
+        send("#{input}=", options[input]) unless options[input].nil?
+      end
+    end
+
+    def policy
+      Base64.urlsafe_encode64(json_policy)
+    end
+
+    def signature
+      OpenSSL::HMAC.hexdigest('sha256', ::Rails.application.config.filepicker_rails.secret_key, policy)
+    end
+
+    def self.apply(call = [:read, :convert], keys = ['policy', 'signature'])
+      return {} unless ::Rails.application.config.filepicker_rails.secret_key.present?
+      grant = Policy.new
+      grant.call = call
+      {
+        keys[0] => grant.policy,
+        keys[1] => grant.signature
+      }
+    end
+
+    private
+    def json_policy
+      hash = Hash.new
+
+      @expiry ||= ::Rails.application.config.filepicker_rails.expiry.call
+
+      [:expiry, :call, :handle, :maxsize, :minsize, :path].each do |input|
+        hash[input] = send(input) unless send(input).nil?
+      end
+
+      hash.to_json
+    end
+  end
+  private_constant :Policy
+end

data/lib/filepicker_rails/tag.rb

@@ -0,0 +1,45 @@
+module FilepickerRails
+  # @private
+  module Tag
+
+    FILEPICKER_OPTIONS_TO_DASHERIZE = [:button_text, :button_class, :mimetypes,
+                                       :extensions, :container, :services,
+                                       :drag_text, :drag_class, :store_path,
+                                       :store_location, :store_access,
+                                       :store_container, :multiple]
+
+    FILEPICKER_OPTIONS_TO_CAMELIZE = [:max_size, :max_files, :open_to]
+
+    private
+
+      attr_reader :input_options, :type
+
+      def define_input_options(options)
+        @type = options.delete(:dragdrop) ? 'filepicker-dragdrop' : 'filepicker'
+        @input_options = retrieve_legacy_filepicker_options(options)
+        @input_options['data-fp-apikey'] ||= ::Rails.application.config.filepicker_rails.api_key
+        @input_options.merge!(secure_filepicker) unless @input_options['data-fp-policy'].present?
+        @input_options['type'] = @type
+        @input_options
+      end
+
+      def filepicker_prefix
+        'data-fp-'
+      end
+
+      def retrieve_legacy_filepicker_options(options)
+        mappings = {}
+        FILEPICKER_OPTIONS_TO_DASHERIZE.each do |option|
+          mappings[option] = "#{filepicker_prefix}#{option.to_s.dasherize}"
+        end
+        FILEPICKER_OPTIONS_TO_CAMELIZE.each do |option|
+          mappings[option] = "#{filepicker_prefix}#{option.to_s.camelize(:lower)}"
+        end
+        Hash[options.map {|k, v| [mappings[k] || k, v] }]
+      end
+
+      def secure_filepicker
+        Policy.apply([:pick, :store], ['data-fp-policy', 'data-fp-signature'])
+      end
+  end
+end

data/lib/filepicker_rails/version.rb

@@ -0,0 +1,3 @@
+module FilepickerRails
+  VERSION = "2.1.0"
+end

metadata

@@ -0,0 +1,181 @@
+--- !ruby/object:Gem::Specification
+name: filestack-rails
+version: !ruby/object:Gem::Version
+  version: 2.1.0
+platform: ruby
+authors:
+- Filestack
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-04-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Makes integrating Filestack with rails easy
+email:
+- contact@filestack.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/helpers/filepicker_rails/application_helper.rb
+- app/helpers/filepicker_rails/form_helper.rb
+- lib/filepicker-rails.rb
+- lib/filepicker_rails/configuration.rb
+- lib/filepicker_rails/engine.rb
+- lib/filepicker_rails/policy.rb
+- lib/filepicker_rails/tag.rb
+- lib/filepicker_rails/version.rb
+homepage: https://github.com/filestack/filestack-rails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: Makes integrating Filestack with rails easy
+test_files: []