groupdocs 0.1.0

data/spec/groupdocs/errors_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+%w(NoClientIdError NoPrivateKeyError UnsupportedMethodError BadResponseError).each do |error|
+  describe GroupDocs::Errors.const_get(error) do
+    it { should be_a(StandardError) }
+  end
+end

data/spec/groupdocs/job_spec.rb

@@ -0,0 +1,196 @@
+require 'spec_helper'
+
+describe GroupDocs::Job do
+
+  it_behaves_like GroupDocs::Api::Entity
+  include_examples GroupDocs::Api::Helpers::Status
+
+  describe '.all!' do
+    before(:each) do
+      mock_api_server(load_json('jobs_get'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.all!({}, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'accepts options hash' do
+      lambda do
+        described_class.all!(page: 1, count: 2)
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns an array of GroupDocs::Job objects' do
+      jobs = described_class.all!
+      jobs.should be_an(Array)
+      jobs.each do |job|
+        job.should be_a(GroupDocs::Job)
+      end
+    end
+  end
+
+  describe '.create!' do
+    before(:each) do
+      mock_api_server(load_json('job_create'))
+    end
+
+    let(:actions) { %w(convert compress_zip) }
+
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.create!({ actions: %w(convert) }, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'raises error if actions are passed' do
+      -> { described_class.create!({}) }.should raise_error(ArgumentError)
+    end
+
+    it 'convert actions to byte flag' do
+      described_class.should_receive(:convert_actions).with(actions).and_return(5)
+      described_class.create!(actions: actions)
+    end
+
+    it 'converts array of out formats to string' do
+      formats = %w(pdf txt)
+      formats.should_receive(:join).with(?;)
+      described_class.create!(actions: actions, out_formats: formats)
+    end
+
+    it 'returns GroupDocs::Job object' do
+      described_class.create!(actions: actions).should be_a(GroupDocs::Job)
+    end
+  end
+
+  it { should respond_to(:id)         }
+  it { should respond_to(:id=)        }
+  it { should respond_to(:documents)  }
+  it { should respond_to(:documents=) }
+
+  describe '#documents=' do
+    let(:response) do
+      [{ id: 1, guid: 'fhy9yh94u238dgf', status: 0, outputs: [] },
+       { id: 2, guid: 'ofh9rhy9rfohf9s', status: 2, outputs: [] }]
+    end
+
+    it 'saves documents as array of GroupDocs::Document objects' do
+      subject.documents = response
+      documents = subject.documents
+      documents.should be_an(Array)
+      documents.each do |document|
+        document.should be_a(GroupDocs::Document)
+      end
+    end
+  end
+
+  describe '#documents!' do
+    before(:each) do
+      mock_api_server(load_json('job_documents'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.documents!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns array of GroupDocs::Document objects' do
+      documents = subject.documents!
+      documents.should be_an(Array)
+      documents.each do |document|
+        document.should be_a(GroupDocs::Document)
+      end
+    end
+  end
+
+  describe '#add_document!' do
+    before(:each) do
+      mock_api_server(load_json('job_file_add'))
+    end
+
+    let(:document) do
+      GroupDocs::Document.new(file: GroupDocs::Storage::File.new)
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.add_document!(document, {}, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'accepts options hash' do
+      lambda do
+        subject.add_document!(document, output_formats: %w(pdf txt))
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'raises error if document is not an instance of GroupDocs::Document' do
+      -> { subject.add_document!('Document') }.should raise_error(ArgumentError)
+    end
+
+    it 'returns document ID' do
+      subject.add_document!(document).should be_an(Integer)
+    end
+  end
+
+  describe '#add_datasource!' do
+    let(:document) do
+      GroupDocs::Document.new(file: GroupDocs::Storage::File.new)
+    end
+
+    let(:datasource) do
+      GroupDocs::DataSource.new
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.add_datasource!(document, datasource, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'raises error if document is not an instance of GroupDocs::Document' do
+      -> { subject.add_datasource!('Document') }.should raise_error(ArgumentError)
+    end
+
+    it 'raises error if datasource is not an instance of GroupDocs::DataSource' do
+      -> { subject.add_datasource!(document, 'DataSource') }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe '#add_url!' do
+    before(:each) do
+      mock_api_server(load_json('job_add_url'))
+    end
+
+    let(:url) { 'http://www.google.com' }
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.add_url!(url, {}, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'accepts options hash' do
+      lambda do
+        subject.add_url!(url, out_formats: %W(pdf txt))
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns document ID' do
+      subject.add_url!(url).should be_an(Integer)
+    end
+  end
+
+  describe '#update!' do
+    before(:each) do
+      mock_api_server(load_json('job_update'))
+    end
+
+    it 'parses status' do
+      subject.should_receive(:parse_status).with(:draft).and_return(-1)
+      subject.update!(status: :draft)
+    end
+  end
+end

data/spec/groupdocs/questionnaire/execution_spec.rb

@@ -0,0 +1,136 @@
+require 'spec_helper'
+
+describe GroupDocs::Questionnaire::Execution do
+
+  it_behaves_like GroupDocs::Api::Entity
+
+  describe 'STATUSES' do
+    it 'contains hash of execution statuses' do
+      described_class::STATUSES.should == {
+        draft:     0,
+        submitted: 1,
+        executed:  2,
+        approved:  3,
+        rejected:  4,
+        closed:    5,
+      }
+    end
+  end
+
+  describe '.all!' do
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.all!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'just calls GroupDocs::Questionnaire.executions! method' do
+      GroupDocs::Questionnaire.should_receive(:executions!).with({})
+      described_class.all!
+    end
+  end
+
+  it { should respond_to(:id)               }
+  it { should respond_to(:id=)              }
+  it { should respond_to(:ownerId)          }
+  it { should respond_to(:ownerId=)         }
+  it { should respond_to(:questionnaireId)  }
+  it { should respond_to(:questionnaireId=) }
+  it { should respond_to(:executiveId)      }
+  it { should respond_to(:executiveId=)     }
+  it { should respond_to(:approverId)       }
+  it { should respond_to(:approverId=)      }
+  it { should respond_to(:datasourceId)     }
+  it { should respond_to(:datasourceId=)    }
+  it { should respond_to(:documentId)       }
+  it { should respond_to(:documentId=)      }
+  it { should respond_to(:status)           }
+  it { should respond_to(:status=)          }
+  it { should respond_to(:guid)             }
+  it { should respond_to(:guid=)            }
+
+  it 'has human-readable accessors' do
+    subject.should respond_to(:owner_id)
+    subject.should respond_to(:owner_id=)
+    subject.should respond_to(:questionnaire_id)
+    subject.should respond_to(:questionnaire_id=)
+    subject.should respond_to(:executive_id)
+    subject.should respond_to(:executive_id=)
+    subject.should respond_to(:approver_id)
+    subject.should respond_to(:approver_id=)
+    subject.should respond_to(:datasource_id)
+    subject.should respond_to(:datasource_id=)
+    subject.should respond_to(:document_id)
+    subject.should respond_to(:document_id=)
+    subject.method(:owner_id).should          == subject.method(:ownerId)
+    subject.method(:owner_id=).should         == subject.method(:ownerId=)
+    subject.method(:questionnaire_id).should  == subject.method(:questionnaireId)
+    subject.method(:questionnaire_id=).should == subject.method(:questionnaireId=)
+    subject.method(:executive_id).should      == subject.method(:executiveId)
+    subject.method(:executive_id=).should     == subject.method(:executiveId=)
+    subject.method(:approver_id).should       == subject.method(:approverId)
+    subject.method(:approver_id=).should      == subject.method(:approverId=)
+    subject.method(:datasource_id).should     == subject.method(:datasourceId)
+    subject.method(:datasource_id=).should    == subject.method(:datasourceId=)
+    subject.method(:document_id).should       == subject.method(:documentId)
+    subject.method(:document_id=).should      == subject.method(:documentId=)
+  end
+
+  describe '#status=' do
+    it 'saves status in machine readable format if symbol is passed' do
+      subject.status = :executed
+      subject.instance_variable_get(:@status).should == 2
+    end
+
+    it 'does nothing if parameter is not symbol' do
+      subject.status = 2
+      subject.instance_variable_get(:@status).should == 2
+    end
+
+    it 'raises error if status is unknown' do
+      -> { subject.status = :unknown }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe '#status' do
+    it 'returns status in human-readable format' do
+      subject.status = 2
+      subject.status.should == :executed
+    end
+  end
+
+  describe '#set_status!' do
+    before(:each) do
+      mock_api_server(load_json('questionnaire_execution_status_set'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.set_status!(:submitted, client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'updates status of execution object' do
+      lambda do
+        subject.set_status!(:submitted)
+      end.should change(subject, :status).to(:submitted)
+    end
+  end
+
+  describe '#update!' do
+    before(:each) do
+      mock_api_server(load_json('questionnaire_execution_update'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        subject.update!(client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'uses hashed version of self as request body' do
+      subject.should_receive(:to_hash).and_return({})
+      subject.update!
+    end
+  end
+end

data/spec/groupdocs/questionnaire/page_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe GroupDocs::Questionnaire::Page do
+
+  it_behaves_like GroupDocs::Api::Entity
+
+  it { should respond_to(:questions)  }
+  it { should respond_to(:questions=) }
+  it { should respond_to(:number)     }
+  it { should respond_to(:number=)    }
+  it { should respond_to(:title)      }
+  it { should respond_to(:title=)     }
+
+  describe '#questions=' do
+    it 'converts each question to GroupDocs::Questionnaire::Question object if hash is passed' do
+      subject.questions = [{ field: 'Field1', text: 'Text1', def_answer: 'A1' }]
+      questions = subject.questions
+      questions.should be_an(Array)
+      questions.each do |question|
+        question.should be_a(GroupDocs::Questionnaire::Question)
+      end
+    end
+
+    it 'saves each question if it is GroupDocs::Questionnaire::Question object' do
+      question1 = GroupDocs::Questionnaire::Question.new(field: 'field1')
+      question2 = GroupDocs::Questionnaire::Question.new(field: 'field2')
+      subject.questions = [question1, question2]
+      subject.questions.should include(question1)
+      subject.questions.should include(question2)
+    end
+
+    it 'does nothing if nil is passed' do
+      lambda do
+        subject.questions = nil
+      end.should_not change(subject, :questions)
+    end
+  end
+
+  describe '#add_question' do
+    it 'raises error if question is not GroupDocs::Questionnaire::Page object' do
+      -> { subject.add_question('Page') }.should raise_error(ArgumentError)
+    end
+
+    it 'saves question' do
+      question = GroupDocs::Questionnaire::Question.new
+      subject.add_question(question)
+      subject.questions.should == [question]
+    end
+  end
+end

data/spec/groupdocs/questionnaire/question/answer_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe GroupDocs::Questionnaire::Question::Answer do
+
+  it_behaves_like GroupDocs::Api::Entity
+
+  it { should respond_to(:text)   }
+  it { should respond_to(:text=)  }
+  it { should respond_to(:value)  }
+  it { should respond_to(:value=) }
+end

data/spec/groupdocs/questionnaire/question_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+
+describe GroupDocs::Questionnaire::Question do
+
+  it_behaves_like GroupDocs::Api::Entity
+
+  describe 'TYPES' do
+    it 'contains hash of field types' do
+      described_class::TYPES.should == {
+        simple:          0,
+        multiple_choice: 1,
+      }
+    end
+  end
+
+  it { should respond_to(:field)       }
+  it { should respond_to(:field=)      }
+  it { should respond_to(:text)        }
+  it { should respond_to(:text=)       }
+  it { should respond_to(:def_answer)  }
+  it { should respond_to(:def_answer=) }
+  it { should respond_to(:required)    }
+  it { should respond_to(:required=)   }
+  it { should respond_to(:type)        }
+  it { should respond_to(:type=)       }
+  it { should respond_to(:answers)     }
+  it { should respond_to(:answers=)    }
+
+  describe '#answers=' do
+    it 'converts each answer to GroupDocs::Questionnaire::Question::Answer object' do
+      subject.answers = [{ text: 'Text1', value: 'Value1' }, { text: 'Text2', value: 'Value2' }]
+      answers = subject.answers
+      answers.should be_an(Array)
+      answers.each do |answer|
+        answer.should be_a(GroupDocs::Questionnaire::Question::Answer)
+      end
+    end
+
+    it 'saves each answer if it is GroupDocs::Questionnaire::Question::Answer object' do
+      answer1 = GroupDocs::Questionnaire::Question::Answer.new(text: 'text1')
+      answer2 = GroupDocs::Questionnaire::Question::Answer.new(text: 'text2')
+      subject.answers = [answer1, answer2]
+      subject.answers.should include(answer1)
+      subject.answers.should include(answer2)
+    end
+
+    it 'does nothing if nil is passed' do
+      lambda do
+        subject.answers = nil
+      end.should_not change(subject, :answers)
+    end
+  end
+
+  describe '#add_answer' do
+    it 'raises error if answer is not GroupDocs::Questionnaire::Question::Answer object' do
+      -> { subject.add_answer('Answer') }.should raise_error(ArgumentError)
+    end
+
+    it 'saves answer' do
+      answer = GroupDocs::Questionnaire::Question::Answer.new(text: 'Text', value: 'Value')
+      subject.add_answer(answer)
+      subject.answers.should == [answer]
+    end
+  end
+
+  describe '#type=' do
+    it 'saves type in machine readable format if symbol is passed' do
+      subject.type = :multiple_choice
+      subject.instance_variable_get(:@type).should == 1
+    end
+
+    it 'does nothing if parameter is not symbol' do
+      subject.type = 1
+      subject.instance_variable_get(:@type).should == 1
+    end
+  end
+
+  describe '#type' do
+    it 'returns type in human-readable format' do
+      subject.type = 1
+      subject.type.should == :multiple_choice
+    end
+  end
+end