ink_file_picker 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d22df05e49b4463a633bb87fbb978dae55653c9f
+  data.tar.gz: 590c40f9b6e7f1ff9f0d2669a29e68d7f6a9f64d
+SHA512:
+  metadata.gz: ee4b1ade5cb8f4ab41017a119384cc75029d13f11d338b9262096e3238c88ccc40cae29f6c0db0ecd39d077f666e5c7c5b4410ea6b1b972e53b2b3269f8422b8
+  data.tar.gz: d22c324c7ad0b417bdb0e32883c7190f00c3571ed9d68dd4e1bb0ec3c671b4096aa18b8821ff3613e1d6b8ff4cdc3877bcb1cb1cbe9627fc2245d7625dfa6e50

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bin/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ink_file_picker.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Thorbjørn Hermansen
+
+MIT License
+
+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,76 @@
+# InkFilePicker
+
+Ruby API client for Ink File Picker (known as filepicker.io).
+
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ink_file_picker'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ink_file_picker
+
+
+
+## Usage
+
+This client mirrors part of File Picker's JavaScript API.
+
+
+
+### Creating a client
+
+```ruby
+# Create a client which will sign URLs. You may drop secret if you have
+# not enabled this feature in your developer portal for your application.
+client = InkFilePicker.client(key: 'you-api-key', secret: 'your-secret')
+```
+
+### Storing a file
+```ruby
+response = client.store_file file_or_path, content_type
+response = client.store_url 'http://www.example.com/img.jpg'
+```
+
+### Removing a file
+```ruby
+response = client.remove url_or_handle_name
+```
+
+### Read operations
+```ruby
+url = client.convert_url url_or_handle_name, w: 100, h: 100
+url = client.convert_url url_or_handle_name, {w: 100, h: 100}, expiry: 10.minutes.from_now.to_i
+
+# Adds policy and signature, if secret given when client was created.
+url = client.retrieve_url url_or_handle_name
+url = client.retrieve_url url_or_handle_name, expiry: 10.minutes.from_now.to_i
+
+
+# Get simple stat on a file, like the Javascript client
+stat = client.stat url_or_handle_name
+
+dimentions = client.stat url_or_handle_name, {width: true, height: true}
+```
+
+### Errors
+
+When making requests to the API errors may occur. `InkFilePicker::ClientError` or `InkFilePicker::ServerError` will
+be raised if we are getting 4xx or 5xx responses back from File Picker. All errors inherits from `InkFilePicker::Error`.
+
+
+## Contributing
+
+1. Fork it (https://github.com/Skalar/ink_file_picker/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/ink_file_picker.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ink_file_picker/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ink_file_picker"
+  spec.version       = InkFilePicker::VERSION
+  spec.authors       = ["Thorbjørn Hermansen"]
+  spec.email         = ["thhermansen@gmail.com"]
+  spec.summary       = %q{Client for Ink File Picker}
+  #spec.description   = %q{TODO: Write a longer description. Optional.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activesupport", ">= 3.2.14", "< 5"
+  spec.add_dependency "faraday", "~> 0.9.0"
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", "~> 2.14.1"
+end

data/lib/ink_file_picker/assignable.rb

@@ -0,0 +1,21 @@
+module InkFilePicker
+  module Assignable
+
+    def []=(name, value)
+      public_send "#{name}=", value
+    end
+
+    def [](name)
+      public_send name
+    end
+
+
+    private
+
+    def assign(attributes)
+      attributes.each_pair do |name, value|
+        self[name] = value
+      end
+    end
+  end
+end

data/lib/ink_file_picker/client.rb

@@ -0,0 +1,183 @@
+require "faraday"
+
+module InkFilePicker
+  class Client
+    attr_accessor :configuration
+
+    def initialize(configuration)
+      self.configuration = Configuration.new configuration
+    end
+
+
+    # Public: Store a file from given URL.
+    #
+    # url                 - URL to resource
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns a hash representing the response where you can read for instance 'url'
+    def store_url(url, policy_attributes = {})
+      params = {key: configuration.key}
+
+      add_policy_to params, from: policy_attributes, ensure_included: {call: 'store'}
+
+      response = http_connection.post configuration.store_path do |request|
+        request.params = params
+        request.body = {url: url}
+      end
+
+      wrap_response_or_fail_unless_success! response
+    end
+
+    # Public: Store a file from given local file or path.
+    #
+    # file_or_path        - File or path to file
+    # content_type        - The file's content type
+    # filename            - The file's name, optional
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns a hash representing the response where you can read for instance 'url'
+    def store_file(file_or_path, content_type, filename = nil, policy_attributes = {})
+      file_upload = Faraday::UploadIO.new file_or_path, content_type, filename
+      params = {key: configuration.key}
+
+      add_policy_to params, from: policy_attributes, ensure_included: {call: 'store'}
+
+      response = http_connection.post configuration.store_path do |request|
+        request.params = params
+        request.body = {fileUpload: file_upload}
+      end
+
+      wrap_response_or_fail_unless_success! response
+    end
+
+    # Public: Removes a file from file picker.
+    #
+    # handle_or_url       - The handle or URL to the file
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns boolean value
+    def remove(handle_or_url, policy_attributes = {})
+      response = http_connection.delete remove_url(handle_or_url, policy_attributes)
+
+      wrap_response_or_fail_unless_success! response
+    end
+
+
+    # Public: Returns short stat for a file
+    #
+    # handle_or_url       - The handle or URL to the file
+    # params              - Request params, like {width: true, height: true} to get width and height info. May be empty for default response
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns hash of headers returned from file picker or false if request was unsuccessful
+    def stat(handle_or_url, params = {}, policy_attributes = {})
+      response = http_connection.get stat_url(handle_or_url, params, policy_attributes)
+
+      wrap_response_or_fail_unless_success! response
+    end
+
+    # Public: Generates a you can use for removing an asset on file picker.
+    #
+    # handle_or_url       - The handle or URL to the file
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns a URL to the converted image
+    def remove_url(handle_or_url, policy_attributes = {})
+      generate_url handle_or_url, {key: configuration.key}, policy_attributes, call: 'remove'
+    end
+
+    # Public: Generates a convert URL for given file.
+    #
+    # handle_or_url       - The handle or URL to the file
+    # params              - Convert params, like {w: 100, h:100}
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns a URL to the converted image
+    def convert_url(handle_or_url, params = {}, policy_attributes = {})
+      generate_url handle_or_url, params, policy_attributes, call: 'convert', url_action: 'convert'
+    end
+
+
+    # Public: Generates a URL for a given file
+    #
+    # handle_or_url       - The handle or URL to the file
+    # params              - Params to be added as get params, like {cache: true}
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # This method is not that usefull unless you have enabled security policy
+    #
+    # Returns a URL to the image
+    def retrieve_url(handle_or_url, params = {}, policy_attributes = {})
+      generate_url handle_or_url, params, policy_attributes, call: 'read'
+    end
+
+
+    # Public: Generates a stat URL for a given file
+    #
+    # handle_or_url       - The handle or URL to the file
+    # policy_attributes   - If you use security policies you may send in for instance {expire: 10.minutes.from_now} here
+    #
+    # Returns a URL to the image you can do a HEAD request to in order to get stats
+    def stat_url(handle_or_url, params, policy_attributes = {})
+      generate_url handle_or_url, params, policy_attributes, call: 'stat', url_action: 'metadata'
+    end
+
+
+
+
+
+    # Public: Creates a policy with default configuration set in this client.
+    #
+    # Returns Policy object
+    def policy(attributes)
+      attributes.reverse_merge!(
+        secret: configuration.secret,
+        expiry: Time.now.to_i + configuration.default_expiry
+      )
+
+      Policy.new attributes
+    end
+
+
+
+
+
+    def http_connection
+      @http_connection ||= Faraday.new(url: configuration.filepicker_url) do |builder|
+        builder.request :multipart
+        builder.request :url_encoded
+        builder.adapter configuration.http_adapter || Faraday.default_adapter
+      end
+    end
+
+
+    private
+
+    def generate_url(handle_or_url, params, policy_attributes, options)
+      file_handle = FileHandle.new handle_or_url, configuration.cdn_url
+
+      add_policy_to params, from: policy_attributes, ensure_included: {handle: file_handle.handle, call: options[:call]}
+
+      url = UrlBuilder.new(file_url: file_handle.url, action: options[:url_action], params: params).to_s
+    end
+
+    def add_policy_to(params, options = {})
+      policy_attributes = (options[:from] || {}).merge options[:ensure_included]
+      params.merge! policy(policy_attributes)
+    end
+
+    # Private: Inspects response for error and raise a InkFilePicker error if client/server error.
+    def wrap_response_or_fail_unless_success!(response)
+      case response.status
+      when 200...300
+        Response.new response
+      when 400...500
+        fail ClientError.new response.body, response
+      when 500...600
+        fail ServerError.new response.body, response
+      else
+        fail Error, "Response was neither a success, nor within http status 400...600. Response was: '#{response.inspect}'."
+      end
+    end
+  end
+end

data/lib/ink_file_picker/configuration.rb

@@ -0,0 +1,32 @@
+module InkFilePicker
+  class Configuration
+    include Assignable
+
+    API_DEFAULTS = {
+      secret: nil,
+      default_expiry: 600, # in 10 hours
+      cdn_url: 'https://www.filepicker.io/api/file/',
+      filepicker_url: 'https://www.filepicker.io',
+      store_path: '/api/store/S3',
+      http_adapter: :net_http
+    }
+
+    attr_accessor :key, :secret, :default_expiry, :cdn_url, :filepicker_url, :store_path, :http_adapter
+
+    def initialize(attributes = {})
+      assign API_DEFAULTS
+      assign attributes
+
+      verify!
+    end
+
+
+    private
+
+    def verify!
+      if key.blank?
+        fail ArgumentError, "An API key must be provided"
+      end
+    end
+  end
+end

data/lib/ink_file_picker/errors.rb

@@ -0,0 +1,36 @@
+module InkFilePicker
+  module ErrorWithOriginal
+    attr_reader :msg, :related
+
+    def initialize(msg, related)
+      @msg = msg
+      @related = related
+    end
+
+    def to_s
+      "#{self.class.name}: Message: '#{msg}'. Related object: '#{related.inspect}'."
+    end
+    alias inspect to_s
+  end
+
+
+  # Public: Base class for errors related to InkFilePicker.
+  class Error < StandardError
+  end
+
+  # Public: Got a request error back trying to do a request
+  #
+  # This includes wire errors like timeouts etc, and server errors
+  # like 5xx. Inspect error_or_response for more information.
+  #
+  class ServerError < Error
+    include ErrorWithOriginal
+  end
+
+  # Public: Got an error where the client seems to be doing something wrong
+  #
+  # These errors mainly comes from http 4xx errors.
+  class ClientError < Error
+    include ErrorWithOriginal
+  end
+end

data/lib/ink_file_picker/file_handle.rb

@@ -0,0 +1,32 @@
+require 'uri'
+
+module InkFilePicker
+  # Public: Simple class for working with file URL and file handles.
+  #
+  # Does conversions like url to handle and from a handle to url
+  class FileHandle
+    attr_accessor :handle, :url, :cdn_url
+
+    def initialize(handle_or_url, cdn_url)
+      self.cdn_url = cdn_url
+      self.handle = extract_handle handle_or_url
+      self.url = build_url_from_handle
+    end
+
+
+
+    private
+
+    def build_url_from_handle
+      joins_with = cdn_url.ends_with?('/') ? '' : '/'
+      [cdn_url, handle].join joins_with
+    end
+
+    def extract_handle(handle_or_url)
+      uri = URI.parse handle_or_url
+      uri.path.split('/').last
+    rescue URI::InvalidURIError
+      handle_or_url
+    end
+  end
+end

data/lib/ink_file_picker/policy.rb

@@ -0,0 +1,50 @@
+require 'base64'
+require 'openssl'
+
+module InkFilePicker
+  class Policy
+    include Assignable
+
+    POLICY_ATTRIBUTES = %w[expiry call handle max_size min_size path container].freeze
+
+    attr_accessor :secret, *POLICY_ATTRIBUTES
+
+    def initialize(attributes)
+      assign attributes
+    end
+
+
+
+    def policy
+      Base64.urlsafe_encode64 policy_json
+    end
+
+    def signature
+      OpenSSL::HMAC.hexdigest 'sha256', secret, policy
+    end
+
+
+    def to_hash
+      return {} if secret.blank?
+
+      {
+        policy: policy,
+        signature: signature
+      }
+    end
+
+
+
+    def policy_json
+      out = {}
+
+      POLICY_ATTRIBUTES.each do |attr_name|
+        if value = self[attr_name] and value.present?
+          out[attr_name] = value
+        end
+      end
+
+      out.to_json
+    end
+  end
+end

data/lib/ink_file_picker/response.rb

@@ -0,0 +1,23 @@
+module InkFilePicker
+  # Public: Simple decorator class for response.
+  #
+  # Decorates the response with hash like access to the
+  # parsed body, which is expected to be JSON.
+  class Response
+    attr_reader :http_response
+
+    delegate :success?, to: :http_response
+
+    def initialize(http_response)
+      @http_response = http_response
+    end
+
+    def [](key)
+      parsed_body[key.to_s]
+    end
+
+    def parsed_body
+      @parsed_body ||= JSON.parse http_response.body
+    end
+  end
+end

data/lib/ink_file_picker/url_builder.rb

@@ -0,0 +1,20 @@
+module InkFilePicker
+  # Public: Takes a file url, adds action to the path (if any), and includes params.
+  class UrlBuilder
+    include Assignable
+
+    attr_accessor :file_url, :action, :params
+
+    def initialize(attributes = {})
+      assign attributes
+    end
+
+    def url
+      url = [file_url, action].compact.join '/'
+      url = [url, params.to_param].join '?' if params.any?
+
+      url
+    end
+    alias to_s url
+  end
+end

data/lib/ink_file_picker/version.rb

@@ -0,0 +1,3 @@
+module InkFilePicker
+  VERSION = "0.0.1"
+end

data/lib/ink_file_picker.rb

@@ -0,0 +1,25 @@
+require "ink_file_picker/version"
+
+require "active_support/all"
+require "ink_file_picker/errors"
+
+module InkFilePicker
+  extend ActiveSupport::Autoload
+
+  autoload :Assignable
+  autoload :Configuration
+  autoload :FileHandle
+  autoload :UrlBuilder
+  autoload :Response
+  autoload :Client
+  autoload :Policy
+
+  # Public: Creates a new Ink File Picker Client.
+  #
+  # configuration - configuration for the client with an API key
+  #
+  # Returns InkFilePicker::Client
+  def self.client(configuration)
+    Client.new configuration
+  end
+end

data/spec/ink_file_picker/client_spec.rb

@@ -0,0 +1,410 @@
+require 'spec_helper'
+
+describe InkFilePicker::Client do
+  let(:attributes) do
+    {
+      key: 'key',
+      secret: '6U5CWAU57NAHDC2ICXQKMXYZ4Q',
+      http_adapter: :test
+    }
+  end
+
+  subject { described_class.new attributes }
+
+  describe "#store_url" do
+    let(:url) { 'https://s3.amazonaws.com/test.jpg' }
+    let(:response) { '{"url": "https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr", "size": 234, "type": "image/jpeg", "filename": "test.jpg", "key": "WmFxB2aSe20SGT2kzSsr_test.jpg"}' }
+
+    context "without secret" do
+      before { subject.configuration.secret = nil }
+
+      it "posts to filepicker" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.post(subject.configuration.store_path + '?key=key', {url: url}) { [200, {}, response] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.store_url url
+
+        stubs.verify_stubbed_calls
+        expect(response['url']).to eq 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr'
+        expect(response[:url]).to eq 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr'
+        expect(response.http_response).to be_a Faraday::Response
+      end
+    end
+
+    context "with secret" do
+      it "includes policy and signature" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          store_path = subject.configuration.store_path + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdG9yZSJ9&signature=60cb43bb945543d7fdbd2662ae21d5c53e28529720263619cfebc3509e820807'
+          stub.post(store_path, {url: url}) { [200, {}, response] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.store_url url, expiry: 1394363896
+
+        stubs.verify_stubbed_calls
+        expect(response['url']).to eq 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr'
+      end
+
+      it "handles client errors correctly" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          store_path = subject.configuration.store_path + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdG9yZSJ9&signature=60cb43bb945543d7fdbd2662ae21d5c53e28529720263619cfebc3509e820807'
+          stub.post(store_path, {url: url}) { [403, {}, '[uuid=AF614DF7F9594A87] This action has been secured by the developer of this website. Error: The signature was not valid'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        expect { subject.store_url url, expiry: 1394363896 }.to raise_error InkFilePicker::ClientError
+      end
+
+      it "handles server errors correctly" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          store_path = subject.configuration.store_path + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdG9yZSJ9&signature=60cb43bb945543d7fdbd2662ae21d5c53e28529720263619cfebc3509e820807'
+          stub.post(store_path, {url: url}) { [502, {}, 'Bad Gateway'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        expect { subject.store_url url, expiry: 1394363896 }.to raise_error InkFilePicker::ServerError
+      end
+    end
+  end
+
+  describe "#store_file" do
+    let(:path) { File.join(File.dirname(__FILE__), '../fixtures', 'skalar.png') }
+    let(:file) { File.open path }
+    let!(:file_upload) { Faraday::UploadIO.new file, 'image/png' }
+    let(:response) { '{"url": "https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr", "size": 234, "type": "image/jpeg", "filename": "test.jpg", "key": "WmFxB2aSe20SGT2kzSsr_test.jpg"}' }
+
+    context "without secret" do
+      before { subject.configuration.secret = nil }
+
+      it "uploads the given file as file" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.post(subject.configuration.store_path + '?key=key', {fileUpload: file_upload}) { [200, {}, response] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+        Faraday::UploadIO.stub(:new).and_return file_upload # Need same object, so request equals the stub
+
+        response = subject.store_file file, 'image/png'
+
+        stubs.verify_stubbed_calls
+        expect(response['url']).to eq 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr'
+      end
+
+      it "uploads the given file as path" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.post(subject.configuration.store_path + '?key=key', {fileUpload: file_upload}) { [200, {}, response] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+        Faraday::UploadIO.stub(:new).and_return file_upload # Need same object, so request equals the stub
+
+        response = subject.store_file path, 'image/png'
+
+        stubs.verify_stubbed_calls
+        expect(response['url']).to eq 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr'
+      end
+    end
+
+    context "with secret" do
+      it "uploads the given file as file" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.post(subject.configuration.store_path + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdG9yZSJ9&signature=60cb43bb945543d7fdbd2662ae21d5c53e28529720263619cfebc3509e820807', {fileUpload: file_upload}) { [200, {}, response] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+        Faraday::UploadIO.stub(:new).and_return file_upload # Need same object, so request equals the stub
+
+        response = subject.store_file file, 'image/png', nil, expiry: 1394363896
+
+        stubs.verify_stubbed_calls
+        expect(response['url']).to eq 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr'
+      end
+
+      it "handles client errors correctly" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          store_path = subject.configuration.store_path + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdG9yZSJ9&signature=60cb43bb945543d7fdbd2662ae21d5c53e28529720263619cfebc3509e820807'
+          stub.post(store_path) { [403, {}, '[uuid=AF614DF7F9594A87] This action has been secured by the developer of this website. Error: The signature was not valid'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        expect { subject.store_file file, 'image/png', nil, expiry: 1394363896 }.to raise_error InkFilePicker::ClientError
+      end
+
+      it "handles server errors correctly" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          store_path = subject.configuration.store_path + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdG9yZSJ9&signature=60cb43bb945543d7fdbd2662ae21d5c53e28529720263619cfebc3509e820807'
+          stub.post(store_path) { [502, {}, 'Bad Gateway'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        expect { subject.store_file file, 'image/png', nil, expiry: 1394363896 }.to raise_error InkFilePicker::ServerError
+      end
+    end
+  end
+
+  describe "#remove" do
+    let(:file_url) { 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr' }
+
+    context "without secret" do
+      before { subject.configuration.secret = nil }
+
+      it "makes a delete request with url" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.delete(file_url + '?key=key') { [200, {}, 'success'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.remove file_url
+
+        stubs.verify_stubbed_calls
+        expect(response).to be_true
+      end
+
+      it "makes delete request with file handle name" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.delete(file_url + '?key=key') { [200, {}, 'success'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.remove 'WmFxB2aSe20SGT2kzSsr'
+
+        stubs.verify_stubbed_calls
+        expect(response).to be_true
+      end
+
+      it "handles server errors correctly" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.delete(file_url + '?key=key') { [502, {}, 'Bad Gateway'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        expect { subject.remove 'WmFxB2aSe20SGT2kzSsr' }.to raise_error InkFilePicker::ServerError
+      end
+    end
+
+    context "with secret" do
+      it "includes policy and signature" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.delete(file_url + '?key=key&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJyZW1vdmUiLCJoYW5kbGUiOiJXbUZ4QjJhU2UyMFNHVDJrelNzciJ9&signature=a557d55a680892235619ff0bec6c7254fbb8088e53a53d923b4fad1d39df3955') { [200, {}, 'success'] }
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.remove file_url, expiry: 1394363896
+
+        stubs.verify_stubbed_calls
+        expect(response).to be_true
+      end
+    end
+  end
+
+  describe "#stat" do
+    let(:file_url) { 'https://www.filepicker.io/api/file/WmFxB2aSe20SGT2kzSsr' }
+
+    it "handles server errors correctly" do
+      stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+        stub.get(file_url + '/metadata') { [502, {}, 'Bad Gateway'] }
+      end
+
+      stubbed_connection = Faraday.new do |builder|
+        builder.adapter :test, stubs
+      end
+
+      subject.stub(:http_connection).and_return stubbed_connection
+
+      expect { subject.stat 'WmFxB2aSe20SGT2kzSsr' }.to raise_error InkFilePicker::ServerError
+    end
+
+    context "with secret" do
+      it "includes policy and signature" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.get(file_url + '/metadata' + '?policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdGF0IiwiaGFuZGxlIjoiV21GeEIyYVNlMjBTR1Qya3pTc3IifQ%3D%3D&signature=d70d11f59750903c628f4e35ecc15ef504d71b1ed104c653fe57b2231a7d667c') do
+            [200, {}, '{"mimetype": "image/jpeg", "uploaded": 13.0}']
+          end
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.stat file_url, {}, expiry: 1394363896
+
+        stubs.verify_stubbed_calls
+        expect(response['uploaded']).to eq 13.0
+      end
+
+      it "forwards get params" do
+        stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+          stub.get(file_url + '/metadata' + '?heigth=true&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJzdGF0IiwiaGFuZGxlIjoiV21GeEIyYVNlMjBTR1Qya3pTc3IifQ%3D%3D&signature=d70d11f59750903c628f4e35ecc15ef504d71b1ed104c653fe57b2231a7d667c&width=true') do
+            [200, {}, '{"width": 100, "height": 100}']
+          end
+        end
+
+        stubbed_connection = Faraday.new do |builder|
+          builder.adapter :test, stubs
+        end
+
+        subject.stub(:http_connection).and_return stubbed_connection
+
+        response = subject.stat file_url, {width: true, heigth: true}, expiry: 1394363896
+
+        stubs.verify_stubbed_calls
+        expect(response['width']).to eq 100
+      end
+    end
+  end
+
+  describe "#convert_url" do
+    let(:handle) { 'PHqJHHWpRAGUsIfyx0og' }
+    let(:url) { "https://www.filepicker.io/api/file/#{handle}" }
+
+    context "without secret" do
+      before { subject.configuration.secret = nil }
+
+      it "builds expected convert URL when given a URL" do
+        expect(subject.convert_url url, w: 300, h: 200).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og/convert?h=200&w=300'
+      end
+
+      it "builds expected convert URL when given a handle" do
+        expect(subject.convert_url handle, w: 300, h: 200).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og/convert?h=200&w=300'
+      end
+    end
+
+    context "with secret" do
+      it "builds expected convert URL when given a URL" do
+        expect(subject.convert_url url, {w: 300, h: 200}, expiry: 1394363896).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og/convert?h=200&policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJjb252ZXJ0IiwiaGFuZGxlIjoiUEhxSkhIV3BSQUdVc0lmeXgwb2cifQ%3D%3D&signature=b370d4ae604c7917c169fe5b10a6274683bb82056c7b80993a7601d486b89d22&w=300'
+      end
+    end
+  end
+
+  describe "#retrieve_url" do
+    let(:handle) { 'PHqJHHWpRAGUsIfyx0og' }
+    let(:url) { "https://www.filepicker.io/api/file/#{handle}" }
+
+    context "without secret" do
+      before { subject.configuration.secret = nil }
+
+      it "builds expected retrieve URL when given a URL" do
+        expect(subject.retrieve_url url).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og'
+      end
+
+      it "builds expected retrieve URL when given a handle" do
+        expect(subject.retrieve_url handle).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og'
+      end
+
+      it "can include params like cache set to true" do
+        expect(subject.retrieve_url handle, cache: true).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og?cache=true'
+      end
+    end
+
+    context "with secret" do
+      it "builds expected retrieve URL when given a URL" do
+        expect(subject.retrieve_url url, {}, expiry: 1394363896).to eq 'https://www.filepicker.io/api/file/PHqJHHWpRAGUsIfyx0og?policy=eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJyZWFkIiwiaGFuZGxlIjoiUEhxSkhIV3BSQUdVc0lmeXgwb2cifQ%3D%3D&signature=6bba22df7390a44a13329d2f2ca8317c48317fe6612b21f957670969a074f778'
+      end
+    end
+  end
+
+
+
+  describe "#configuration" do
+    it "has key set" do
+      expect(subject.configuration.key).to eq 'key'
+    end
+
+    it "has secret set" do
+      expect(subject.configuration.secret).to eq '6U5CWAU57NAHDC2ICXQKMXYZ4Q'
+    end
+  end
+
+  describe "#policy" do
+    let(:policy_attributes) { {call: 'read'} }
+    let(:policy) { double }
+
+    describe "expiry" do
+      context "is given" do
+        it "uses given value" do
+          InkFilePicker::Policy.should_receive(:new).with(hash_including(call: 'read', expiry: 60)).and_return policy
+
+          expect(subject.policy policy_attributes.merge(expiry: 60)).to eq policy
+        end
+      end
+
+      context "not given" do
+        before { Time.stub_chain(:now, :to_i).and_return 1 }
+
+        it "uses default_expiry from config" do
+          subject.configuration.stub(:default_expiry).and_return 600
+
+          InkFilePicker::Policy.should_receive(:new).with(hash_including(call: 'read', expiry: 601)).and_return policy
+
+          expect(subject.policy policy_attributes).to eq policy
+        end
+      end
+    end
+  end
+end

data/spec/ink_file_picker/configuration_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe InkFilePicker::Configuration do
+  let(:attributes) do
+    {
+      key: 'key',
+      secret: 'secret'
+    }
+  end
+
+  subject { described_class.new attributes }
+
+  its(:key) { should eq 'key' }
+  its(:secret) { should eq 'secret' }
+  its(:default_expiry) { should eq 600 }
+  its(:cdn_url) { should eq 'https://www.filepicker.io/api/file/' }
+
+  describe "#initialize" do
+    it "fails when no key is given" do
+      expect { described_class.new }.to raise_error ArgumentError
+    end
+  end
+end

data/spec/ink_file_picker/file_handle_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe InkFilePicker::FileHandle do
+  let(:cdn_url) { 'https://www.filepicker.io/api/file/' }
+  let(:handle) { 'PHqJHHWpRAGUsIfyx0og' }
+  let(:url) { "https://www.filepicker.io/api/file/#{handle}" }
+
+
+  describe "#url" do
+    it "url passes through if the cdn url is the same as given URL" do
+      expect(described_class.new(url, cdn_url).url).to eq url
+    end
+
+    it "builds a file URL given only a file handle" do
+      expect(described_class.new(handle, cdn_url).url).to eq url
+    end
+
+    it "ensures that we use CDN" do
+      expect(described_class.new(url, 'http://cdn.com/').url).to eq "http://cdn.com/#{handle}"
+    end
+  end
+
+  describe "handle" do
+    it "returns expected handle from URL" do
+      expect(described_class.new(url, cdn_url).handle).to eq handle
+    end
+  end
+end

data/spec/ink_file_picker/policy_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe InkFilePicker::Policy do
+  let(:secret) { '6U5CWAU57NAHDC2ICXQKMXYZ4Q' }
+
+  subject do
+    described_class.new(
+      secret: secret,
+      call: 'read',
+      expiry: 1394363896
+    )
+  end
+
+  its(:policy) { should eq 'eyJleHBpcnkiOjEzOTQzNjM4OTYsImNhbGwiOiJyZWFkIn0=' }
+  its(:signature) { should eq '4c50ca71d9e123274a01eb00a7facd52069e07c2e9312517f55bf1b94447792e' }
+
+  describe "#to_hash" do
+    it "contains policy and signature when secret is given" do
+      expect(subject.to_hash).to eq({
+        policy: subject.policy,
+        signature: subject.signature
+      })
+    end
+
+    it "returns an empty hash when no secret is given" do
+      subject.secret = nil
+      expect(subject.to_hash).to eq({})
+    end
+  end
+end

data/spec/ink_file_picker_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe InkFilePicker do
+  describe ".client" do
+    it "takes given arguments and initializes a client" do
+      client = double
+      attributes = {some: 'attributes'}
+
+      InkFilePicker::Client.should_receive(:new).with(attributes).and_return client
+
+      expect(described_class.client(attributes)).to eq client
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'bundler/setup'
+require 'ink_file_picker'
+
+RSpec.configure do |c|
+  c.treat_symbols_as_metadata_keys_with_true_values = true
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: ink_file_picker
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Thorbjørn Hermansen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+description: 
+email:
+- thhermansen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- ink_file_picker.gemspec
+- lib/ink_file_picker.rb
+- lib/ink_file_picker/assignable.rb
+- lib/ink_file_picker/client.rb
+- lib/ink_file_picker/configuration.rb
+- lib/ink_file_picker/errors.rb
+- lib/ink_file_picker/file_handle.rb
+- lib/ink_file_picker/policy.rb
+- lib/ink_file_picker/response.rb
+- lib/ink_file_picker/url_builder.rb
+- lib/ink_file_picker/version.rb
+- spec/fixtures/skalar.png
+- spec/ink_file_picker/client_spec.rb
+- spec/ink_file_picker/configuration_spec.rb
+- spec/ink_file_picker/file_handle_spec.rb
+- spec/ink_file_picker/policy_spec.rb
+- spec/ink_file_picker_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+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.0.0
+signing_key: 
+specification_version: 4
+summary: Client for Ink File Picker
+test_files:
+- spec/fixtures/skalar.png
+- spec/ink_file_picker/client_spec.rb
+- spec/ink_file_picker/configuration_spec.rb
+- spec/ink_file_picker/file_handle_spec.rb
+- spec/ink_file_picker/policy_spec.rb
+- spec/ink_file_picker_spec.rb
+- spec/spec_helper.rb