groupdocs 0.1.0

data/spec/groupdocs/storage/folder_spec.rb

@@ -0,0 +1,310 @@
+require 'spec_helper'
+
+describe GroupDocs::Storage::Folder do
+
+  it_behaves_like GroupDocs::Api::Entity
+  include_examples GroupDocs::Api::Sugar::Lookup
+
+  describe '.create!' do
+    before(:each) do
+      mock_api_server(load_json('folder_create'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.create!('/Test', client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'raises error if path does not start with /' do
+      -> { described_class.create!('Test') }.should raise_error(ArgumentError)
+    end
+
+    it 'returns GroupDocs::Storage::Folder object' do
+      described_class.stub(find!: described_class.new(id: 1))
+      folder = described_class.create!('/Test')
+      folder.should be_a(GroupDocs::Storage::Folder)
+    end
+  end
+
+  describe '.list!' do
+    before(:each) do
+      mock_api_server(load_json('folder_list'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.list!('/', {}, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'allows passing path' do
+      -> { described_class.list!('/test') }.should_not raise_error(ArgumentError)
+    end
+
+    it 'allows passing options' do
+      -> { described_class.list!('/', page: 1, count: 1) }.should_not raise_error(ArgumentError)
+    end
+
+    it 'creates new instance of GroupDocs::Storage::Folder and calls #list!' do
+      folder = stub('folder')
+      GroupDocs::Storage::Folder.should_receive(:new).with(path: '/').and_return(folder)
+      folder.should_receive(:list!).with({}, {})
+      described_class.list!
+    end
+  end
+
+  it { should respond_to(:id)            }
+  it { should respond_to(:id=)           }
+  it { should respond_to(:size)          }
+  it { should respond_to(:size=)         }
+  it { should respond_to(:folder_count)  }
+  it { should respond_to(:folder_count=) }
+  it { should respond_to(:file_count)    }
+  it { should respond_to(:file_count=)   }
+  it { should respond_to(:created_on)    }
+  it { should respond_to(:created_on=)   }
+  it { should respond_to(:modified_on)   }
+  it { should respond_to(:modified_on=)  }
+  it { should respond_to(:url)           }
+  it { should respond_to(:url=)          }
+  it { should respond_to(:name)          }
+  it { should respond_to(:name=)         }
+  it { should respond_to(:version)       }
+  it { should respond_to(:version=)      }
+  it { should respond_to(:type)          }
+  it { should respond_to(:type=)         }
+  it { should respond_to(:access)        }
+  it { should respond_to(:access=)       }
+
+  describe '#created_on' do
+    it 'returns converted to Time object Unix timestamp' do
+      subject.created_on = 1330450135
+      subject.created_on.should be_a(Time)
+    end
+  end
+
+  describe '#modified_on' do
+    it 'returns converted to Time object Unix timestamp' do
+      subject.modified_on = 1330450135
+      subject.modified_on.should be_a(Time)
+    end
+  end
+
+  describe '#access' do
+    it 'returns converted to human-readable format access mode' do
+      subject.should_receive(:parse_access_mode).with(0).and_return(:private)
+      subject.access = 0
+      subject.access.should == :private
+    end
+  end
+
+  describe '#move!' do
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.move!('/Test', client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'raises error if path does not start with /' do
+      -> { subject.move!('Test2') }.should raise_error(ArgumentError)
+    end
+
+    it 'sends "Groupdocs-Move" header' do
+      mock_api_server(load_json('folder_move'), :'Groupdocs-Move' => 'Test1')
+      subject.stub(name: 'Test1')
+      subject.move!('/Test2')
+    end
+
+    it 'returns moved to folder path' do
+      mock_api_server(load_json('folder_move'))
+      moved = subject.move!('/Test2')
+      moved.should be_a(String)
+      moved.should == '/Test2'
+    end
+  end
+
+  describe '#rename!' do
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.rename!('Test2', client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'uses #move! to rename directory' do
+      subject.should_receive(:move!).with('/Test2', {}).and_return('/Test2')
+      subject.rename!('Test2')
+    end
+
+    it 'strips leading / symbol from new name' do
+      subject.stub(move!: '/Test2')
+      renamed = subject.rename!('Test2')
+      renamed.should be_a(String)
+      renamed.should == 'Test2'
+    end
+  end
+
+  describe '#copy!' do
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.copy!('/Test2', client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'raises error if path does not start with /' do
+      -> { subject.copy!('Test2') }.should raise_error(ArgumentError)
+    end
+
+    it 'sends "Groupdocs-Copy" header' do
+      mock_api_server(load_json('folder_move'), :'Groupdocs-Copy' => 'Test1')
+      subject.stub(name: 'Test1')
+      subject.copy!('/Test2')
+    end
+
+    it 'returns moved to folder path' do
+      mock_api_server(load_json('folder_move'))
+      moved = subject.copy!('/Test2')
+      moved.should be_a(String)
+      moved.should == '/Test2'
+    end
+  end
+
+  describe '#list!' do
+    before(:each) do
+      mock_api_server(load_json('folder_list'))
+      subject.stub(path: '/Test1')
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.list!({}, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'allows passing options' do
+      -> { subject.list!(page: 1, count: 1) }.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns array' do
+      subject.list!.should be_an(Array)
+    end
+
+    it 'returns empty array if nothing is listed in directory' do
+      mock_api_server('{"result": {"entities": []}, "status": "Ok"}')
+      subject.list!.should be_empty
+    end
+
+    it 'determines folders in response' do
+      subject.list!.detect do |entity|
+        entity.id == 1
+      end.should be_a(GroupDocs::Storage::Folder)
+    end
+
+    it 'determines files in response' do
+      subject.list!.detect do |entity|
+        entity.id == 2
+      end.should be_a(GroupDocs::Storage::File)
+    end
+  end
+
+  describe '#create!' do
+    before(:each) do
+      mock_api_server(load_json('folder_create'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.create!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'calls create! class method and pass parameters to it' do
+      subject = described_class.new(name: 'Test1')
+      described_class.should_receive(:create!).with('/Test1', {})
+      subject.create!
+    end
+  end
+
+  describe '#delete!' do
+    before(:each) do
+      mock_api_server(load_json('folder_delete'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.delete!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'determines path by name' do
+      subject.should_receive(:name).and_return('Test1')
+      subject.delete!
+    end
+  end
+
+  describe '#sharers!' do
+    before(:each) do
+      mock_api_server(load_json('folder_sharers_get'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.sharers!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns an array of GroupDocs::User objects' do
+      users = subject.sharers!
+      users.should be_an(Array)
+      users.each do |user|
+        user.should be_a(GroupDocs::User)
+      end
+    end
+  end
+
+  describe '#sharers_set!' do
+    before(:each) do
+      mock_api_server(load_json('folder_sharers_set'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.sharers_set!(%w(test1@email.com), client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns an array of GroupDocs::User objects' do
+      users = subject.sharers_set!(%w(test1@email.com))
+      users.should be_an(Array)
+      users.each do |user|
+        user.should be_a(GroupDocs::User)
+      end
+    end
+
+    it 'clears sharers if empty array is passed' do
+      subject.should_receive(:sharers_clear!)
+      subject.sharers_set!([])
+    end
+
+    it 'clears sharers if nil is passed' do
+      subject.should_receive(:sharers_clear!)
+      subject.sharers_set!(nil)
+    end
+  end
+
+  describe '#sharers_clear!' do
+    before(:each) do
+      mock_api_server(load_json('folder_sharers_remove'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.sharers_clear!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'clears sharers list and returns nil' do
+      subject.sharers_clear!.should be_nil
+    end
+  end
+end

data/spec/groupdocs/storage/package_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe GroupDocs::Storage::Package do
+
+  it_behaves_like GroupDocs::Api::Entity
+
+  it { should respond_to(:name)     }
+  it { should respond_to(:name=)    }
+  it { should respond_to(:objects)  }
+  it { should respond_to(:objects=) }
+
+  describe '#add' do
+    it 'adds objects to be packed later' do
+      subject.objects = ['object 1']
+      subject.objects.should_receive(:<<).with('object 2')
+      subject.add('object 2')
+    end
+
+    it 'is aliased to #<<' do
+      subject.should respond_to(:<<)
+      subject.method(:<<).should == subject.method(:add)
+    end
+  end
+
+  describe '#create!' do
+    before(:each) do
+      mock_api_server(load_json('package_create'))
+      subject.objects = [stub(name: 'object 1')]
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.create!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns URL for package downloading' do
+      subject.create!.should be_a(String)
+    end
+  end
+end

data/spec/groupdocs/storage_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe GroupDocs::Storage do
+  describe '.info!' do
+    before(:each) do
+      mock_api_server(load_json('storage_info'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.info!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns a hash of information' do
+      described_class.info!.should be_a(Hash)
+    end
+
+    it 'converts total space to MB' do
+      described_class.info![:total_space].should == '1024 MB'
+    end
+
+    it 'converts available space to MB' do
+      described_class.info![:available_space].should == '1020 MB'
+    end
+  end
+end

data/spec/groupdocs/user_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe GroupDocs::User do
+
+  it_behaves_like GroupDocs::Api::Entity
+
+  it { should respond_to(:id)             }
+  it { should respond_to(:id=)            }
+  it { should respond_to(:guid)           }
+  it { should respond_to(:guid=)          }
+  it { should respond_to(:nickname)       }
+  it { should respond_to(:nickname=)      }
+  it { should respond_to(:first_name)     }
+  it { should respond_to(:first_name=)    }
+  it { should respond_to(:last_name)      }
+  it { should respond_to(:last_name=)     }
+  it { should respond_to(:primary_email)  }
+  it { should respond_to(:primary_email=) }
+  it { should respond_to(:private_key)    }
+  it { should respond_to(:private_key=)   }
+  it { should respond_to(:password_salt)  }
+  it { should respond_to(:password_salt=) }
+  it { should respond_to(:claimed_id)     }
+  it { should respond_to(:claimed_id=)    }
+  it { should respond_to(:token)          }
+  it { should respond_to(:token=)         }
+  it { should respond_to(:storage)        }
+  it { should respond_to(:storage=)       }
+  it { should respond_to(:photo)          }
+  it { should respond_to(:photo=)         }
+  it { should respond_to(:active)         }
+  it { should respond_to(:active=)        }
+  it { should respond_to(:news_enabled)   }
+  it { should respond_to(:news_enabled=)  }
+  it { should respond_to(:signed_up_on)   }
+  it { should respond_to(:signed_up_on=)  }
+
+  it 'is compatible with response JSON' do
+    subject.should respond_to(:pkey=)
+    subject.should respond_to(:pswd_salt=)
+    subject.should respond_to(:signedupOn=)
+    subject.method(:pkey=).should == subject.method(:private_key=)
+    subject.method(:pswd_salt=).should == subject.method(:password_salt=)
+    subject.method(:signedupOn=).should == subject.method(:signed_up_on=)
+  end
+
+  describe '#signed_up_on' do
+    it 'returns converted to Time object Unix timestamp' do
+      subject.signed_up_on = 1330450135
+      subject.signed_up_on.should be_a(Time)
+    end
+  end
+end

data/spec/groupdocs_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+describe GroupDocs do
+
+  subject { described_class }
+  let(:client_id)   { '07aaaf95f8eb33a4' }
+  let(:private_key) { '5cb711b3a52ffc5d90ee8a0f79206f5a' }
+
+  describe '.configure' do
+    it { should respond_to(:configure) }
+
+    it 'calls block for self' do
+      subject.should_receive(:configure).and_yield(subject)
+      subject.configure do |api|
+        api.client_id   = client_id
+        api.private_key = private_key
+      end
+    end
+
+    it 'saves client ID for further access' do
+      subject.should_receive(:client_id=).with(client_id).and_return(client_id)
+      subject.configure do |api|
+        api.client_id = client_id
+      end
+      subject.client_id.should == client_id
+    end
+
+    it 'saves private key for further access' do
+      subject.should_receive(:private_key=).with(private_key).and_return(private_key)
+      subject.configure do |api|
+        api.private_key = private_key
+      end
+      subject.private_key.should == private_key
+    end
+  end
+
+  it { should respond_to(:client_id)    }
+  it { should respond_to(:client_id=)   }
+  it { should respond_to(:private_key)  }
+  it { should respond_to(:private_key=) }
+  it { should respond_to(:api_server)   }
+  it { should respond_to(:api_server=)  }
+  it { should respond_to(:api_version)  }
+  it { should respond_to(:api_version=) }
+
+  describe '#api_server' do
+    it 'returns default URL if it has not been overwritten' do
+      subject.api_server.should == 'https://api.groupdocs.com'
+    end
+
+    it 'returns custom overwritten URL' do
+      subject.api_server = 'https://dev-api.groupdocs.com'
+      subject.api_server.should == 'https://dev-api.groupdocs.com'
+    end
+  end
+end