cloudapp-service 1.0.0.beta.1

data/spec/cassettes/view_drop.yml

@@ -0,0 +1,174 @@
+---
+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.008812'
+      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:50 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:
+      - ! '"e99f62e3f2bdb84c23f5e4072ad6d53a"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      X-Runtime:
+      - '0.038310'
+      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/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:51 GMT
+- request:
+    method: post
+    uri: https://api.getcloudapp.com/drops
+    body:
+      encoding: UTF-8
+      string: ! '{"name":null,"private":true,"trash":false,"bookmark_url":"http://cl.ly","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:
+      - ! '"188c220a63dd6f84e99c636f9cde2b5c"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      Set-Cookie:
+      - _engine_session=BAh7BkkiD3Nlc3Npb25faWQGOgZFRkkiJTNhMjc2YTNiNWY3ZmVkN2U5Y2ZmNTU4YjNlY2E2NzNjBjsAVA%3D%3D--cd71d5b8f83a5628f1bd299d79bce081d406413b;
+        path=/; HttpOnly
+      X-Runtime:
+      - '0.047050'
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      Content-Length:
+      - '995'
+      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"}]}]}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:51 GMT
+- request:
+    method: get
+    uri: https://api.getcloudapp.com/drops/21907682
+    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:
+      - ! '"188c220a63dd6f84e99c636f9cde2b5c"'
+      Server:
+      - thin 1.4.1 codename Chromeo
+      X-Runtime:
+      - '0.017271'
+      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/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"}]}]}}'
+    http_version: 
+  recorded_at: Tue, 11 Sep 2012 15:46:51 GMT
+recorded_with: VCR 2.0.1

data/spec/cloudapp/authorized_representation_spec.rb

@@ -0,0 +1,32 @@
+require 'helper'
+
+require 'cloudapp/service/authorized_representation'
+
+describe CloudApp::AuthorizedRepresentation do
+  let(:representation) { stub :representation, __response__: response }
+  let(:response)       { stub :response, status: status }
+  let(:status)         { 200 }
+  let(:href) { stub }
+  subject    { representation }
+  before do
+    representation.extend CloudApp::AuthorizedRepresentation
+  end
+
+  describe '#authorized?' do
+    it { should be_authorized }
+
+    context 'unauthorized status' do
+      let(:status) { 401 }
+      it { should_not be_authorized }
+    end
+  end
+
+  describe '#unauthorized?' do
+    it { should_not be_unauthorized }
+
+    context 'unauthorized status' do
+      let(:status) { 401 }
+      it { should be_unauthorized }
+    end
+  end
+end

data/spec/cloudapp/collection_json/item_spec.rb

@@ -0,0 +1,45 @@
+require 'helper'
+
+require 'cloudapp/collection_json/item'
+
+describe CloudApp::CollectionJson::Item do
+  let(:item_data) {{ 'data' => [] }}
+  subject    { CloudApp::CollectionJson::Item.new item_data }
+
+  its(:href)  { should be_nil }
+  its(:links) { should be_empty }
+  its(:data)  { should be_empty }
+
+  context 'with an href' do
+    let(:href) { stub :href }
+    before do item_data['href'] = href end
+    its(:href) { should eq(href) }
+  end
+
+  context 'with links' do
+    let(:links) {[
+      { 'rel'  => 'canonical', 'href'  => 'link1' },
+      { 'rel'  => 'alternate', 'href'  => 'link2' }
+    ]}
+    before do item_data['links'] = links end
+
+    its(:links) { should have(2).items }
+
+    it 'presents links' do
+      subject.links.find {|link| link.rel == 'canonical' }.
+        href.should eq('link1')
+      subject.links.find {|link| link.rel == 'alternate' }.
+        href.should eq('link2')
+    end
+  end
+
+  context 'with data' do
+    let(:data) {[
+      { 'name' => 'attr1', 'value' => 'value1' },
+      { 'name' => 'attr2', 'value' => 'value2' }
+    ]}
+    before do item_data['data'] = data end
+
+    its(:data) { should eq('attr1' => 'value1', 'attr2' => 'value2') }
+  end
+end

data/spec/cloudapp/collection_json/representation_spec.rb

@@ -0,0 +1,118 @@
+require 'helper'
+
+require 'cloudapp/collection_json/representation'
+
+describe CloudApp::CollectionJson::Representation do
+  let(:response)       { stub :response, status: status }
+  let(:status)         { 200 }
+  let(:representation) {{
+    'collection' => {
+      'href'  => href,
+      'items' => []
+    }
+  }}
+  let(:href) { stub }
+  subject    { representation }
+  before do
+    representation.extend CloudApp::CollectionJson::Representation
+    representation.stub __response__: response
+  end
+
+  its(:href) { should eq(href) }
+
+  describe '#collection_links' do
+    its(:collection_links) { should be_empty }
+
+    context 'with collection links' do
+      let(:links) {[
+        { 'rel' => 'next', 'href' => '/next' },
+        { 'rel' => 'prev', 'href' => '/prev' }
+      ]}
+      before do representation['collection']['links'] = links end
+
+      its(:collection_links) { should have(2).items }
+
+      it 'presents links' do
+        subject.collection_links.find {|link| link.rel == 'next' }.
+          href.should eq('/next')
+        subject.collection_links.find {|link| link.rel == 'prev' }.
+          href.should eq('/prev')
+      end
+    end
+  end
+
+  describe '#items' do
+    it 'is empty' do
+      subject.items(stub(:item_source)).should be_empty
+    end
+
+    context 'with items' do
+      let(:items)       {[ stub(:item1),      stub(:item2) ]}
+      let(:item_data)   {[ stub(:item_data1), stub(:item_data2) ]}
+      let(:item_source) { ->(item) {
+        if item == item_data[0]
+          items[0]
+        elsif item == item_data[1]
+          items[1]
+        end
+      }}
+      before do representation['collection']['items'] = item_data end
+
+      it 'should have items' do
+        subject.items(item_source).should eq(items)
+      end
+    end
+  end
+
+  describe '#templates' do
+    it 'is nil' do
+      subject.template(stub(:template_source)).should be_nil
+    end
+
+    context 'with a template' do
+      let(:template)        { stub :template }
+      let(:template_data)   { stub :template_data }
+      let(:template_source) { ->(item) { template if item == template_data }}
+      before do representation['collection']['template'] = template_data end
+
+      it 'finds the template' do
+        subject.template(template_source).should eq(template)
+      end
+    end
+  end
+
+  describe '#queries' do
+    it 'is nil' do
+      subject.queries(stub(:query_source)).should be_nil
+    end
+
+    context 'with queries' do
+      let(:queries)      {[ stub(:query1),      stub(:query2) ]}
+      let(:query_data)   {[ stub(:query_data1), stub(:query_data2) ]}
+      let(:query_source) { ->(query) { queries.at(query_data.index(query)) }}
+      before do representation['collection']['queries'] = query_data end
+
+      it 'should have queries' do
+        subject.queries(query_source).should eq(queries)
+      end
+    end
+  end
+
+  describe '#query' do
+    it 'is nil' do
+      subject.query('rel', stub(:query_source)).should be_nil
+    end
+
+    context 'with queries' do
+      let(:queries)      {[ stub(:query1, rel: 'one'),
+                            stub(:query2, rel: 'two') ]}
+      let(:query_data)   {[ stub(:query_data1), stub(:query_data2) ]}
+      let(:query_source) { ->(query) { queries.at(query_data.index(query)) }}
+      before do representation['collection']['queries'] = query_data end
+
+      it 'finds the query by rel' do
+        subject.query('one', query_source).should eq(queries.first)
+      end
+    end
+  end
+end

data/spec/cloudapp/collection_json/template_spec.rb

@@ -0,0 +1,53 @@
+require 'helper'
+require 'cloudapp/collection_json/item'
+
+require 'cloudapp/collection_json/template'
+
+describe CloudApp::CollectionJson::Template do
+  let(:template_data) {{ 'data' => [] }}
+  subject { CloudApp::CollectionJson::Template.new template_data }
+
+  its(:rel)     { should be_nil }
+  its(:enctype) { should be_nil }
+
+
+  context 'with a rel' do
+    let(:rel) { stub :rel }
+    before do template_data['rel'] = rel end
+
+    its(:rel) { should eq(rel) }
+  end
+
+  context 'with an encoding type' do
+    let(:enctype) { stub :enctype }
+    before do template_data['enctype'] = enctype end
+
+    its(:enctype) { should eq(enctype) }
+  end
+
+  describe '#fill' do
+    let(:email) { 'arthur@dent.com' }
+    let(:template_data) {{
+      'data' => [
+        { 'name' => 'email', 'value' => '' },
+        { 'name' => 'age',   'value' => 29 }
+      ]
+    }}
+
+    it 'returns a filled template' do
+      expected = { 'email' => email, 'age' => 29 }
+      subject.fill('email' => email).should eq(expected)
+    end
+
+    it 'leaves data untouched' do
+      subject.fill('email' => email)
+      subject.data.should eq('email' => '', 'age' => 29)
+    end
+
+    it 'ignores attributes not in the template' do
+      expected = { 'email' => email, 'age' => 29 }
+      new_data = { 'email' => email, 'ignore' => 'me' }
+      subject.fill(new_data).should eq(expected)
+    end
+  end
+end

data/spec/cloudapp/drop_collection_spec.rb

@@ -0,0 +1,148 @@
+require 'helper'
+require 'ostruct'
+
+require 'cloudapp/service/drop_collection'
+
+describe CloudApp::DropCollection do
+  let(:representation) { stub :representation, unauthorized?: false,
+                                               items:         items }
+  let(:service)        { stub :service }
+  let(:items)          {[ stub(:item1), stub(:item2) ]}
+  let(:drop_class)     { stub(:drop_class, new: :drop) }
+  subject { CloudApp::DropCollection.new representation, service, drop_class }
+
+  describe 'collection' do
+    it 'is a collection of drops' do
+      subject.size.should eq(2)
+    end
+
+    it 'decodes each drop' do
+      items.each do |drop|
+        drop_class.should_receive(:new).once.
+          with(drop, kind_of(CloudApp::DropCollection))
+      end
+      subject
+    end
+  end
+
+  describe '#authorized?' do
+    let(:authorized) { stub :authorized }
+    before do representation.stub(authorized?: authorized) end
+
+    it 'delegates to representation' do
+      subject.authorized?.should eq(authorized)
+    end
+  end
+
+  describe '#unauthorized?' do
+    let(:unauthorized) { stub :unauthorized }
+    before do representation.stub(unauthorized?: unauthorized) end
+
+    it 'delegates to representation' do
+      subject.unauthorized?.should eq(unauthorized)
+    end
+  end
+
+  describe '#follow' do
+    let(:link_representation) {
+      stub :link_representation, unauthorized?: false,
+                                 items:         []
+    }
+    subject {
+      CloudApp::DropCollection.
+        new(representation, service, drop_class).
+        follow('yes')
+    }
+
+    before do
+      link = stub :link
+      link.should_receive(:follow).once.and_return(link_representation)
+      representation.should_receive(:link).once.and_return(link)
+    end
+
+    it { subject.should be_a(CloudApp::DropCollection) }
+    its(:representation) { should eq(link_representation) }
+    its(:drop_class)     { should eq(drop_class) }
+
+    it 'passes along service' do
+      service.should_receive(:trash_drop)
+      subject.trash stub.as_null_object
+    end
+  end
+
+  describe '#has_link?' do
+    context 'with link' do
+      before do
+        representation.should_receive(:link).
+          once.
+          with('yes').
+          and_return(stub(:link))
+      end
+
+      it 'returns false' do
+        subject.has_link?('yes').should eq(true)
+      end
+    end
+
+    context 'without link' do
+      before do
+        representation.should_receive(:link).
+          once.
+          with('no').
+          and_yield
+      end
+
+      it 'returns true' do
+        subject.has_link?('no').should eq(false)
+      end
+    end
+  end
+
+  describe '#privatize' do
+    it 'privatizes the given drop' do
+      href = stub :href
+      service.should_receive(:privatize_drop).once.with(href)
+      subject.privatize stub(:drop, href: href)
+    end
+  end
+
+  describe '#publicize' do
+    it 'publicizes the given drop' do
+      href = stub :href
+      service.should_receive(:publicize_drop).once.with(href)
+      subject.publicize stub(:drop, href: href)
+    end
+  end
+
+  describe '#trash' do
+    it 'trashes the given drop' do
+      href = stub :href
+      service.should_receive(:trash_drop).once.with(href)
+      subject.trash stub(:drop, href: href)
+    end
+  end
+
+  describe '#recover' do
+    it 'recovers the given drop' do
+      href = stub :href
+      service.should_receive(:recover_drop).once.with(href)
+      subject.recover stub(:drop, href: href)
+    end
+  end
+
+  describe '#delete' do
+    it 'deletes the given drop' do
+      href = stub :href
+      service.should_receive(:delete_drop).once.with(href)
+      subject.delete stub(:drop, href: href)
+    end
+  end
+
+  describe '#delete'
+
+  context 'unauthorized' do
+    before do representation.stub(unauthorized?: true) end
+
+    it { should be_empty }
+  end
+end