cloudpt-api 0.0.1

data/lib/cloudpt-api/util/util.rb

@@ -0,0 +1,27 @@
+module Cloudpt
+  module API
+
+    module Util
+
+      class << self
+
+        def escape(string)
+          string.gsub(/([^ a-zA-Z0-9\.\\\-\/\_]+)/) do
+            '%' + $1.unpack('H2' * $1.bytesize).join('%').upcase
+          end.gsub(' ', '%20')
+        end
+
+        def query(data)
+          data.inject([]) { |memo, entry| memo.push(entry.join('=')); memo }.join('&')
+        end
+
+        def remove_double_slashes(path)
+          path.gsub('//', '/')
+        end
+
+      end
+
+    end
+
+  end
+end

data/lib/cloudpt-api/version.rb

@@ -0,0 +1,5 @@
+module Cloudpt
+  module API
+    VERSION = "0.0.1"
+  end
+end

data/spec/connection.sample.yml

@@ -0,0 +1,5 @@
+app_key:    # CONSUMER KEY
+app_secret: # CONSUMER SECRET
+token:      # ACCESS TOKEN
+secret:     # ACCESS SECRET
+mode:       # 'sandbox' or 'cloudpt'

data/spec/lib/cloudpt-api/client_spec.rb

@@ -0,0 +1,208 @@
+# encoding: utf-8
+require "spec_helper"
+
+describe Cloudpt::API::Client do
+
+  before do
+    # pending
+    @client = Cloudpt::Spec.instance
+  end
+
+  describe "#initialize" do
+
+    it "has a handle to the connection" do
+      @client.connection.should be_an_instance_of(Cloudpt::API::Connection)
+    end
+
+  end
+
+  describe "#account" do
+
+    it "retrieves the account object" do
+      response = @client.account
+      response.should be_an_instance_of(Cloudpt::API::Object)
+    end
+
+  end
+
+  describe "#find" do
+
+    before do
+      @filename = "#{Cloudpt::Spec.test_dir}/spec-find-file-test-#{Time.now.to_i}.txt"
+      @file = @client.upload @filename, "spec file"
+
+      @dirname = "#{Cloudpt::Spec.test_dir}/spec-find-dir-test-#{Time.now.to_i}"
+      @dir = @client.mkdir @dirname
+    end
+
+    it "returns a single file" do
+      response = @client.find(@filename)
+      response.path.should == @file.path
+      response.should be_an_instance_of(Cloudpt::API::File)
+    end
+
+    it "returns a single directory" do
+      response = @client.find(@dirname)
+      response.path.should == @dir.path
+      response.should be_an_instance_of(Cloudpt::API::Dir)
+    end
+
+  end
+
+  describe "#list" do
+    it "lists root" do
+      result = @client.list("")
+      result.should be_an_instance_of(Array)
+    end
+  end
+
+  describe "#ls" do
+
+    it "returns an array of files and dirs" do
+      result = @client.ls
+      result.should be_an_instance_of(Array)
+    end
+
+    it "returns a single item array of if we ls a file" do
+      result     = @client.ls(Cloudpt::Spec.test_dir)
+      first_file = result.detect { |f| f.class == Cloudpt::API::File }
+      result     = @client.ls first_file.path
+      result.should be_an_instance_of(Array)
+    end
+
+  end
+
+  describe "#mkdir" do
+
+    it "returns an array of files and dirs" do
+      dirname  = "#{Cloudpt::Spec.test_dir}/test-dir-#{Cloudpt::Spec.namespace}"
+      response = @client.mkdir dirname
+      response.path.should == dirname
+      response.should be_an_instance_of(Cloudpt::API::Dir)
+    end
+
+    it "creates dirs with tricky characters" do
+      dirname  = "#{Cloudpt::Spec.test_dir}/test-dir |!@\#$%^&*{b}[].;'.,<>?: #{Cloudpt::Spec.namespace}"
+      response = @client.mkdir dirname
+      response.path.should == dirname.gsub(/[\\\:\?\*\<\>\"\|]+/, '')
+      response.should be_an_instance_of(Cloudpt::API::Dir)
+    end
+
+    it "creates dirs with utf8 characters" do
+      dirname  = "#{Cloudpt::Spec.test_dir}/test-dir łółą #{Cloudpt::Spec.namespace}"
+      response = @client.mkdir dirname
+      response.path.should == dirname
+      response.should be_an_instance_of(Cloudpt::API::Dir)
+    end
+
+  end
+
+  describe "#upload" do
+
+    it "puts the file in Cloudpt" do
+      filename = "#{Cloudpt::Spec.test_dir}/test-#{Cloudpt::Spec.namespace}.txt"
+      response = @client.upload filename, "Some file"
+      response.path.should == filename
+      response.bytes.should == 9
+    end
+
+    it "uploads the file with tricky characters" do
+      filename = "#{Cloudpt::Spec.test_dir}/test ,|!@\#$%^&*{b}[].;'.,<>?:-#{Cloudpt::Spec.namespace}.txt"
+      response = @client.upload filename, "Some file"
+      response.path.should == filename
+      response.bytes.should == 9
+    end
+
+    it "uploads the file with utf8" do
+      filename = "#{Cloudpt::Spec.test_dir}/test łołąó-#{Cloudpt::Spec.namespace}.txt"
+      response = @client.upload filename, "Some file"
+      response.path.should == filename
+      response.bytes.should == 9
+    end
+  end
+
+  describe "#search" do
+
+    let(:term) { "searchable-test-#{Cloudpt::Spec.namespace}" }
+
+    before do
+      filename = "#{Cloudpt::Spec.test_dir}/searchable-test-#{Cloudpt::Spec.namespace}.txt"
+      @client.upload filename, "Some file"
+    end
+
+    after do
+      @response.size.should == 1
+      @response.first.class.should == Cloudpt::API::File
+    end
+
+    it "finds a file" do
+      @response = @client.search term, :path => "#{Cloudpt::Spec.test_dir}"
+    end
+
+    it "works if leading slash is present in path" do
+      @response = @client.search term, :path => "/#{Cloudpt::Spec.test_dir}"
+    end
+
+  end
+
+  describe "#copy_from_copy_ref" do
+
+    it "copies a file from a copy_ref" do
+      filename = "test/searchable-test-#{Cloudpt::Spec.namespace}.txt"
+      @client.upload filename, "Some file"
+      response = @client.search "searchable-test-#{Cloudpt::Spec.namespace}", :path => 'test'      
+      ref = response.first.copy_ref['copy_ref']
+      @client.copy_from_copy_ref ref, "#{filename}.copied"
+      response = @client.search "searchable-test-#{Cloudpt::Spec.namespace}.txt.copied", :path => 'test'   
+      response.size.should == 1
+      response.first.class.should == Cloudpt::API::File
+    end
+
+  end
+
+  describe "#download" do
+
+    it "downloads a file from Cloudpt" do
+      @client.upload "#{Cloudpt::Spec.test_dir}/test.txt", "Some file"
+      file = @client.download "#{Cloudpt::Spec.test_dir}/test.txt"
+      file.should == "Some file"
+    end
+
+    it "raises a 404 when a file is not found in Cloudpt" do
+      lambda {
+        @client.download "#{Cloudpt::Spec.test_dir}/no.txt"
+      }.should raise_error(Cloudpt::API::Error::NotFound)
+    end
+
+  end
+
+  describe "#delta" do
+    it "returns a cursor and list of files" do
+      filename = "#{Cloudpt::Spec.test_dir}/delta-test-#{Cloudpt::Spec.namespace}.txt"
+      @client.upload filename, 'Some file'
+      response = @client.delta
+      cursor, files = response.cursor, response.entries
+      cursor.should be_an_instance_of(String)
+      files.should be_an_instance_of(Array)
+      files.last.should be_an_instance_of(Cloudpt::API::File)
+    end
+
+    it "returns the files that have changed since the cursor was made" do
+      filename = "#{Cloudpt::Spec.test_dir}/delta-test-#{Cloudpt::Spec.namespace}.txt"
+      delete_filename = "#{Cloudpt::Spec.test_dir}/delta-test-delete-#{Cloudpt::Spec.namespace}.txt"
+      @client.upload delete_filename, 'Some file'
+      response = @client.delta
+      cursor, files = response.cursor, response.entries
+      files.last.path.should == delete_filename
+      files.last.destroy
+      @client.upload filename, 'Another file'
+      response = @client.delta(cursor)
+      cursor, files = response.cursor, response.entries
+      files.length.should == 2
+      files.first.is_deleted.should == true
+      files.first.path.should == delete_filename
+      files.last.path.should == filename
+    end
+  end
+
+end

data/spec/lib/cloudpt-api/connection_spec.rb

@@ -0,0 +1,82 @@
+require "spec_helper"
+
+describe Cloudpt::API::Connection do
+
+  before do
+    @connection = Cloudpt::API::Connection.new(:token  => Cloudpt::Spec.token,
+                                               :secret => Cloudpt::Spec.secret)
+  end
+
+  describe "#request" do
+
+    it "returns a parsed response when the response is a 200" do
+      response = mock :code => 200, :body => '{ "a":1}'
+      response = @connection.request { response }
+      response.should be_an_instance_of(Hash)
+    end
+
+    it "raises a Cloudpt::API::Error::Unauthorized when the response is a 401" do
+      response = mock :code => 401, :body => '{ "a":1}'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error::Unauthorized)
+    end
+
+    it "raises a Cloudpt::API::Error::Forbidden when the response is a 403" do
+      response = mock :code => 403, :body => '{ "a":1}'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error::Forbidden)
+    end
+
+    it "raises a Cloudpt::API::Error::NotFound when the response is a 404" do
+      response = mock :code => 404, :body => '{ "a":1}'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error::NotFound)
+    end
+
+    it "raises a Cloudpt::API::Error when the response is a 3xx" do
+      response = mock :code => 301, :body => '{ "a":1}'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error::Redirect)
+    end
+
+    it "raises a Cloudpt::API::Error when the response is a 5xx" do
+      response = mock :code => 500, :body => '{ "a":1}'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error)
+    end
+
+    it "raises a Cloudpt::API::Error when the response is a 400" do
+      response = mock :code => 400, :body => '{ "error": "bad request" }'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error)
+    end
+
+    it "raises a Cloudpt::API::Error when the response is a 406" do
+      response = mock :code => 406, :body => '{ "error": "bad request" }'
+      lambda do
+        @connection.request { response }
+      end.should raise_error(Cloudpt::API::Error)
+    end
+
+    it "returns the raw response if :raw => true is provided" do
+      response = mock :code => 200, :body => '{ "something": "more" }'
+      response = @connection.request(:raw => true) { response }
+      response.should == '{ "something": "more" }'
+    end
+
+  end
+
+  describe "#consumer" do
+
+    it "returns an appropriate consumer object" do
+      @connection.consumer(:main).should be_a(::OAuth::Consumer)
+    end
+
+  end
+end

data/spec/lib/cloudpt-api/dir_spec.rb

@@ -0,0 +1,44 @@
+require "spec_helper"
+
+describe Cloudpt::API::Dir do
+
+  before do
+    @client = Cloudpt::Spec.instance
+    @dirname = "#{Cloudpt::Spec.test_dir}/spec-dir-test-#{Time.now.to_i}"
+    @dir = @client.mkdir @dirname
+  end
+
+  after do
+    # @dir.delete
+  end
+
+  describe "#copy" do
+
+    it "copies the dir properly" do
+      new_dirname = @dirname + "-copied"
+      @dir.copy new_dirname
+      @dir.path.should == new_dirname
+    end
+
+  end
+
+  describe "#move" do
+
+    it "moves the dir properly" do
+      new_dirname = @dirname + "-copied"
+      @dir.move new_dirname
+      @dir.path.should == new_dirname
+    end
+
+  end
+
+  describe "#destroy" do
+
+    it "destroys the dir properly" do
+      @dir.destroy
+      @dir.is_deleted.should == true
+    end
+
+  end
+
+end

data/spec/lib/cloudpt-api/file_spec.rb

@@ -0,0 +1,126 @@
+require "spec_helper"
+
+describe Cloudpt::API::File do
+
+  before do
+    @client = Cloudpt::Spec.instance
+    @filename = "#{Cloudpt::Spec.test_dir}/spec-test-#{Time.now.to_i}.txt"
+    @file = @client.upload @filename, "spec file"
+  end
+
+  after do
+    # @file.delete
+  end
+
+  describe "#copy" do
+
+    it "copies the file properly" do
+      new_filename = @filename + ".copied"
+      @file.copy new_filename
+      @file.path.should == new_filename
+    end
+
+  end
+  
+  describe "#move" do
+
+    it "moves the file properly" do
+      new_filename = @filename + ".copied"
+      @file.move new_filename
+      @file.path.should == new_filename
+    end
+
+  end
+
+  describe "#destroy" do
+
+    it "destroys the file properly" do
+      @file.destroy
+      @file.is_deleted.should == true
+    end
+
+  end
+
+  describe "#revisions" do
+
+    it "retrieves all revisions as an Array of File objects" do
+      @client.upload @file.path, "Updated content"
+
+      revisions = @file.revisions
+      revisions.size.should == 2
+      revisions.collect { |f| f.class }.should == [Cloudpt::API::File, Cloudpt::API::File]
+    end
+
+  end
+
+  describe "#restore" do
+
+    it "restores the file to a specific revision" do
+      old_rev = @file.rev
+
+      @client.upload @file.path, "Updated content"
+
+      file = @filename.split('/').last
+
+      found = @client.find(@file.path)
+
+      found.rev.should_not == old_rev
+
+      newer_rev = found.rev
+
+      @file.restore(old_rev)
+
+      found = @client.find(@file.path)
+
+      found.rev.should_not == old_rev
+      found.rev.should_not == newer_rev
+
+    end
+
+  end
+
+  describe "#share_url" do
+
+    it "returns an Url object" do
+
+      result = @file.share_url
+      result.should be_an_instance_of(Cloudpt::API::Object)
+      result.keys.sort.should == ['expires', 'url']
+
+    end
+
+  end
+
+  describe "#copy_ref" do
+    
+    it "returns a copy_ref object" do
+      
+      result = @file.copy_ref
+      result.should be_an_instance_of(Cloudpt::API::Object)
+      result.keys.sort.should == ['copy_ref', 'expires']
+      
+    end
+    
+  end
+
+  describe "#direct_url" do
+
+    it "returns an Url object" do
+
+      result = @file.direct_url
+      result.should be_an_instance_of(Cloudpt::API::Object)
+      result.keys.sort.should == ['expires', 'url']
+
+    end
+
+  end
+
+  describe "#download" do
+
+    it "should download the file" do
+      @file.download.should == 'spec file'
+    end
+
+  end
+
+end