cloudapp-service 1.0.0.beta.1

data/lib/cloudapp/collection_json/template.rb

@@ -0,0 +1,17 @@
+module CloudApp
+  module CollectionJson
+    class Template < Item
+      attr_reader :rel, :enctype
+      def initialize(template_data)
+        super
+        @rel     = template_data.fetch('rel',     nil)
+        @enctype = template_data.fetch('enctype', nil)
+      end
+
+      def fill(template_data)
+        template_data = template_data.select {|key| data.has_key?(key) }
+        data.merge template_data
+      end
+    end
+  end
+end

data/lib/cloudapp/collection_json/tint.rb

@@ -0,0 +1,11 @@
+module CloudApp
+  module CollectionJson
+    Tint = Leadlight::Tint.new 'collection+json', status: [ :success, 401 ] do
+      match_content_type 'application/vnd.collection+json'
+      extend CollectionJson::Representation
+      collection_links.each do |link|
+        add_link link.href, link.rel
+      end
+    end
+  end
+end

data/lib/cloudapp/service.rb

@@ -0,0 +1,204 @@
+require 'leadlight'
+require 'typhoeus'
+require 'cloudapp/collection_json'
+require 'cloudapp/collection_json/tint'
+require 'cloudapp/service/authorized_representation'
+require 'cloudapp/service/drop'
+require 'cloudapp/service/drop_collection'
+
+module CloudApp
+  class Service
+    VERSION = '1.0.0.beta.1'
+
+    Leadlight.build_service(self) do
+      url 'https://api.getcloudapp.com'
+      tints << CollectionJson::Tint
+      tints << AuthorizedRepresentation::Tint
+
+      build_connection do |c|
+        c.adapter :typhoeus
+      end
+    end
+
+    def initialize
+      super
+      # logger.level = Logger::INFO
+      logger.level = Logger::WARN
+    end
+
+    def token=(token)
+      connection.token_auth token
+    end
+
+    def self.using_token(token)
+      new.tap do |service|
+        service.token = token
+      end
+    end
+
+    def self.token_for_account(email, password)
+      representation = new.account_token email, password
+      return if representation.unauthorized?
+
+      representation.items.first.data['token']
+    end
+
+    def account_token(email, password)
+      authenticate_response = root
+      data = authenticate_response.template.
+               fill('email' => email, 'password' => password)
+
+      post(authenticate_response.href, data) do |response|
+        return response
+      end
+    end
+
+    def drops(params = {})
+      params = params.each_with_object({}) {|(key, value), params|
+        params[key.to_s] = value
+      }
+
+      get('/') do |response|
+        return DropCollection.new(response, self) if response.unauthorized?
+
+        drops = response.link('drops').follow
+        return DropCollection.new(drops, self) if params.empty?
+
+        drops_query       = drops.query 'drops-list'
+        href              = Addressable::URI.parse drops_query.href
+        href.query_values = drops_query.fill params
+
+        get(href) do |response| return DropCollection.new(response, self) end
+      end
+    end
+
+    def drop(href)
+      DropCollection.new drops_at(href), self
+    end
+
+    def update(href, options = {})
+      collection = drops_at href
+      drop       = collection.items.first
+      path       = options.fetch :path, nil
+      attributes = drop.data.merge fetch_drop_attributes(options)
+      data       = collection.template.fill attributes
+
+      put(drop.href, data) do |collection|
+        if not path
+          return DropCollection.new collection, self
+        else
+          return DropCollection.new upload_file(path, collection), self
+        end
+      end
+    end
+
+    def bookmark(url, options = {})
+      attributes = fetch_drop_attributes options.merge(url: url)
+      collection = drops_at :root
+      data       = collection.template.fill(attributes)
+
+      post(collection.href, data) do |response|
+        return DropCollection.new response, self
+      end
+    end
+
+    def upload(path, options = {})
+      attributes = fetch_drop_attributes options.merge(path: path)
+      collection = drops_at :root
+      data       = collection.template.fill(attributes)
+
+      post(collection.href, data) do |collection|
+        return DropCollection.new upload_file(path, collection), self
+      end
+    end
+
+    def privatize_drop(href)
+      update href, private: true
+    end
+
+    def publicize_drop(href)
+      update href, private: false
+    end
+
+    def trash_drop(href)
+      update href, trash: true
+    end
+
+    def recover_drop(href)
+      update href, trash: false
+    end
+
+    def delete_drop(href)
+      delete(href) do |response|
+        return response
+      end
+    end
+
+  private
+
+    def drops_at(href, params = {})
+      params = params.each_with_object({}) {|(key, value), params|
+        params[key.to_s] = value
+      }
+
+      if href == :root
+        get('/') do |response|
+          return response if response.__response__.status == 401
+          href = response.link('drops').href
+        end
+      end
+
+      get(href) do |response|
+        return response if response.__response__.status == 401
+        if not params.empty?
+          drops_query = response.query('drops-list')
+          href        = Addressable::URI.parse drops_query.href
+          href.query_values = drops_query.fill params
+        else
+          return response
+        end
+      end
+
+      get(href) do |response|
+        return response if response.__response__.status == 401
+        return response
+      end
+    end
+
+    def fetch_drop_attributes(options)
+      path = options.delete :path
+      options[:file_size] = FileTest.size(path) if path
+      { url:       'bookmark_url',
+        file_size: 'file_size',
+        name:      'name',
+        private:   'private',
+        trash:     'trash'
+      }.each_with_object({}) {|(key, name), attributes|
+        attributes[name] = options.fetch(key) if options.has_key?(key)
+      }
+    end
+
+    def upload_file(path, collection)
+      uri     = Addressable::URI.parse collection.href
+      file    = File.open path
+      file_io = Faraday::UploadIO.new file, 'image/png'
+      fields  = collection.template.fill('file' => file_io)
+
+      conn = Faraday.new(url: uri.site) {|builder|
+        if collection.template.enctype == Faraday::Request::Multipart.mime_type
+          builder.request :multipart
+        end
+
+        builder.response :logger, logger
+        builder.adapter  :typhoeus
+      }
+
+      conn.post(uri.request_uri, fields).on_complete do |env|
+        location = Addressable::URI.parse env[:response_headers]['Location']
+        get(location) do |upload_response|
+          return upload_response
+        end
+      end
+    end
+  end
+end

data/lib/cloudapp/service/authorized_representation.rb

@@ -0,0 +1,17 @@
+require 'leadlight'
+
+module CloudApp
+  module AuthorizedRepresentation
+    Tint = Leadlight::Tint.new 'authorized', status: [ :success, 401 ] do
+      extend AuthorizedRepresentation
+    end
+
+    def authorized?
+      not unauthorized?
+    end
+
+    def unauthorized?
+      __response__.status == 401
+    end
+  end
+end

data/lib/cloudapp/service/drop.rb

@@ -0,0 +1,44 @@
+require 'date'
+require 'ostruct'
+
+module CloudApp
+  class Drop < OpenStruct
+    attr_accessor :href, :data
+
+    def initialize(collection_item, collection)
+      @href       = collection_item.href
+      @links      = collection_item.links
+      @data       = collection_item.data
+      @collection = collection
+      super @data
+    end
+
+    def name()     super || share_url   end
+    def private?() private == true      end
+    def public?() !private?             end
+    def trashed?() data['trash']        end
+    def created()  DateTime.parse(super) end
+
+    def share_url()     link_for_relation('canonical') end
+    def thumbnail_url() link_for_relation('icon')      end
+    def embed_url()     link_for_relation('embed')     end
+    def download_url()  link_for_relation('download')  end
+
+    def publicize() @collection.publicize(self) end
+    def privatize() @collection.privatize(self) end
+    def toggle_privacy
+      public? ? privatize : publicize
+    end
+
+    def trash()   @collection.trash(self)   end
+    def recover() @collection.recover(self) end
+    def delete()  @collection.delete(self)  end
+
+  protected
+
+    def link_for_relation(relation)
+      link = @links.find {|link| link.rel == relation }
+      link and link.href
+    end
+  end
+end

data/lib/cloudapp/service/drop_collection.rb

@@ -0,0 +1,39 @@
+require 'delegate'
+require 'forwardable'
+
+module CloudApp
+  class DropCollection < SimpleDelegator
+    extend Forwardable
+    def_delegators :representation, :authorized?, :unauthorized?
+
+    attr_reader :representation, :drop_class
+
+    def initialize(representation, service, drop_class = Drop)
+      @representation = representation
+      @service        = service
+      @drop_class     = drop_class
+      super drops
+    end
+
+    def follow(relation)
+      DropCollection.new representation.link(relation).follow, @service, drop_class
+    end
+
+    def has_link?(relation)
+      !representation.link(relation) { nil }.nil?
+    end
+
+    def privatize(drop) @service.privatize_drop drop.href end
+    def publicize(drop) @service.publicize_drop drop.href end
+    def trash(drop)     @service.trash_drop drop.href     end
+    def recover(drop)   @service.recover_drop drop.href   end
+    def delete(drop)    @service.delete_drop drop.href    end
+
+  protected
+
+    def drops
+      return [] if unauthorized?
+      @drops ||= representation.items.map {|drop| drop_class.new(drop, self) }
+    end
+  end
+end

data/spec/cassettes/account_token.yml

@@ -0,0 +1,88 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.getcloudapp.com/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - application/json, text/x-yaml, application/xml, application/xhtml+xml, text/html,
+        text/plain
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 401
+      message: Unauthorized
+    headers:
+      Cache-Control:
+      - no-cache
+      Content-Type:
+      - application/vnd.collection+json; charset=utf-8
+      Server:
+      - thin 1.4.1 codename Chromeo
+      Www-Authenticate:
+      - Token realm="CloudApp"
+      X-Runtime:
+      - '0.024863'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"collection":{"version":"1.0","href":"https://api.getcloudapp.com/account/token","links":[{"rel":"root","href":"https://api.getcloudapp.com/"}],"template":{"data":[{"name":"email","value":null},{"name":"password","value":null}]}}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:43 GMT
+- request:
+    method: post
+    uri: https://api.getcloudapp.com/account/token
+    body:
+      encoding: UTF-8
+      string: ! '{"email":"arthur@dent.com","password":"towel"}'
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json, text/x-yaml, application/xml, application/xhtml+xml, text/html,
+        text/plain
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Type:
+      - application/vnd.collection+json; charset=utf-8
+      Etag:
+      - ! '"4438a3f4f703a01c251b7ecc1feab772"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      Set-Cookie:
+      - _engine_session=BAh7CEkiFXVzZXJfY3JlZGVudGlhbHMGOgZFRkkiAYBhOGUwNDBkMDY3YWJkMTEyZGM1NTJhOTlkMjYyNmU1NzU0Y2FmZjc3MDEzZTc0ZDU5NTFjMTI2M2QxYTEyMGQxNThjZjI3ZDgzNmVmN2QyMmEwZjQzN2RlMjg3NGE3OWQwMWM4NWViOWFmYTVmMzQ1ZGFjZjQyZDAxNjlkMTY4MwY7AFRJIhh1c2VyX2NyZWRlbnRpYWxzX2lkBjsARmkDp4EBSSIPc2Vzc2lvbl9pZAY7AEZJIiVkMWNjNjJlNTcyNzE0YjYwODFhMjIwMGUyZTRiMzk4MgY7AFQ%3D--ea8789606501f7f43eef6667e1af82ebb52322eb;
+        path=/; HttpOnly
+      - user_credentials=a8e040d067abd112dc552a99d2626e5754caff77013e74d5951c1263d1a120d158cf27d836ef7d22a0f437de2874a79d01c85eb9afa5f345dacf42d0169d1683%3A%3A98727;
+        path=/; expires=Tue, 11-Dec-2012 15:46:44 GMT
+      X-Runtime:
+      - '0.007753'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"collection":{"version":"1.0","href":"https://api.getcloudapp.com/account/token","links":[{"rel":"root","href":"https://api.getcloudapp.com/"}],"items":[{"href":"https://api.getcloudapp.com/account/token","data":[{"name":"token","value":"abc123"}]}]}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:43 GMT
+recorded_with: VCR 2.0.1

data/spec/cassettes/create_bookmark.yml

@@ -0,0 +1,132 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.getcloudapp.com/
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - Token token="abc123"
+      Accept:
+      - application/json, text/x-yaml, application/xml, application/xhtml+xml, text/html,
+        text/plain
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Type:
+      - application/vnd.collection+json; charset=utf-8
+      Etag:
+      - ! '"44e8e003e0f1b5e38f7ca916ff4497d7"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      X-Runtime:
+      - '0.004864'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '139'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"collection":{"version":"1.0","href":"https://api.getcloudapp.com/","links":[{"rel":"drops","href":"https://api.getcloudapp.com/drops"}]}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:52 GMT
+- request:
+    method: get
+    uri: https://api.getcloudapp.com/drops
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - Token token="abc123"
+      Accept:
+      - application/json, text/x-yaml, application/xml, application/xhtml+xml, text/html,
+        text/plain
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Type:
+      - application/vnd.collection+json; charset=utf-8
+      Etag:
+      - ! '"71c7981a2f34f856e0c966b4bd9d410d"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      X-Runtime:
+      - '0.018958'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '2114'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"collection":{"version":"1.0","href":"https://api.getcloudapp.com/drops","links":[{"rel":"drops-stream","href":"https://api.getcloudapp.com/drops/stream"}],"queries":[{"href":"https://api.getcloudapp.com/drops","rel":"drops-list","data":[{"name":"filter","value":"active"},{"name":"limit","value":20}]}],"template":{"data":[{"name":"name","value":null},{"name":"private","value":true},{"name":"trash","value":false},{"name":"bookmark_url","value":null},{"name":"file_size","value":null}]},"items":[{"href":"https://api.getcloudapp.com/drops/21907682","links":[{"rel":"collection","href":"https://api.getcloudapp.com/drops"},{"rel":"canonical","href":"http://cl.ly/2x3S331L1a3o"},{"rel":"icon","href":"https://d9yac136u048z.cloudfront.net/images/thumbnails/bookmark.png"}],"data":[{"name":"id","value":21907682},{"name":"name","value":"http://cl.ly"},{"name":"private","value":true},{"name":"trash","value":false},{"name":"views","value":0},{"name":"created","value":"2012-09-11T15:46:52Z"}]},{"href":"https://api.getcloudapp.com/drops/21907679","links":[{"rel":"collection","href":"https://api.getcloudapp.com/drops"},{"rel":"canonical","href":"http://cl.ly/1G282W04401a"},{"rel":"icon","href":"https://d9yac136u048z.cloudfront.net/images/thumbnails/bookmark.png"}],"data":[{"name":"id","value":21907679},{"name":"name","value":"http://cl.ly"},{"name":"private","value":true},{"name":"trash","value":false},{"name":"views","value":0},{"name":"created","value":"2012-09-11T15:46:47Z"}]},{"href":"https://api.getcloudapp.com/drops/21907678","links":[{"rel":"collection","href":"https://api.getcloudapp.com/drops"},{"rel":"canonical","href":"http://cl.ly/image/1u232n412l14"},{"rel":"icon","href":"https://thumbs.getcloudapp.com/1u232n412l14"},{"rel":"embed","href":"http://cl.ly/image/1u232n412l14/favicon.ico"},{"rel":"download","href":"http://cl.ly/image/1u232n412l14/download/favicon.ico"}],"data":[{"name":"id","value":21907678},{"name":"name","value":"favicon.ico"},{"name":"private","value":true},{"name":"trash","value":false},{"name":"views","value":0},{"name":"created","value":"2012-09-11T15:46:45Z"}]}]}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:52 GMT
+- request:
+    method: post
+    uri: https://api.getcloudapp.com/drops
+    body:
+      encoding: UTF-8
+      string: ! '{"name":null,"private":true,"trash":false,"bookmark_url":"http://getcloudapp.com","file_size":null}'
+    headers:
+      Authorization:
+      - Token token="abc123"
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json, text/x-yaml, application/xml, application/xhtml+xml, text/html,
+        text/plain
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Cache-Control:
+      - max-age=0, private, must-revalidate
+      Content-Type:
+      - application/vnd.collection+json; charset=utf-8
+      Etag:
+      - ! '"3486b7b686f30b992ebca8d89b09cf01"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      Set-Cookie:
+      - _engine_session=BAh7BkkiD3Nlc3Npb25faWQGOgZFRkkiJWY5N2M3NmVkMjBlZTIzYmM0MjVjYTJiMDkyNjhmMzViBjsAVA%3D%3D--1940b1355947a4954f093626e9753a36f6550327;
+        path=/; HttpOnly
+      X-Runtime:
+      - '0.083921'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"collection":{"version":"1.0","href":"https://api.getcloudapp.com/drops","links":[{"rel":"drops-stream","href":"https://api.getcloudapp.com/drops/stream"}],"queries":[{"href":"https://api.getcloudapp.com/drops","rel":"drops-list","data":[{"name":"filter","value":"active"},{"name":"limit","value":20}]}],"template":{"data":[{"name":"name","value":null},{"name":"private","value":true},{"name":"trash","value":false},{"name":"bookmark_url","value":null},{"name":"file_size","value":null}]},"items":[{"href":"https://api.getcloudapp.com/drops/21907683","links":[{"rel":"collection","href":"https://api.getcloudapp.com/drops"},{"rel":"canonical","href":"http://cl.ly/0e0E2w0w0T0U"},{"rel":"icon","href":"https://d9yac136u048z.cloudfront.net/images/thumbnails/bookmark.png"}],"data":[{"name":"id","value":21907683},{"name":"name","value":"http://getcloudapp.com"},{"name":"private","value":true},{"name":"trash","value":false},{"name":"views","value":0},{"name":"created","value":"2012-09-11T15:46:54Z"}]}]}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:52 GMT
+recorded_with: VCR 2.0.1