groupdocs 1.2.2 → 1.2.3

data/lib/groupdocs/document.rb

@@ -140,6 +140,34 @@ module GroupDocs
       signed_documents
     end
 
+    #
+    # Returns a document metadata by given path.
+    #
+    # @param [String] path Full path to document
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::Document::View>]
+    #
+    def self.metadata!(path, access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/doc/{{client_id}}/files/#{path}"
+      end.execute!
+
+      Document::MetaData.new do |metadata|
+        metadata.id = json[:id]
+        metadata.guid = json[:guid]
+        metadata.page_count = json[:page_count]
+        metadata.views_count = json[:views_count]
+        if json[:last_view]
+          metadata.last_view = json[:last_view]
+          metadata.last_view.document = new(file: Storage::File.new(json))
+        end
+      end
+    end
+
     # @attr [GroupDocs::Storage::File] file
     attr_accessor :file
     # @attr [Time] process_date

data/lib/groupdocs/version.rb

@@ -1,3 +1,3 @@
 module GroupDocs
-  VERSION = '1.2.2'
+  VERSION = '1.2.3'
 end # GroupDocs

data/spec/groupdocs/document_spec.rb

@@ -121,6 +121,31 @@ describe GroupDocs::Document do
     end
   end
 
+  describe ',metadata!' do
+    before(:each) do
+      mock_api_server(load_json('document_metadata'))
+    end
+
+    it 'accepts access credentials hash' do
+      lambda do
+        described_class.metadata!('document_one.doc', client_id: 'client_id', private_key: 'private_key')
+      end.should_not raise_error(ArgumentError)
+    end
+
+    it 'returns GroupDocs::Document::MetaData object' do
+      described_class.metadata!('document_one.doc').should be_a(GroupDocs::Document::MetaData)
+    end
+
+    it 'sets last view as GroupDocs::Document::View object if document was viewed at least once' do
+      described_class.metadata!('document_one.doc').last_view.should be_a(GroupDocs::Document::View)
+    end
+
+    it 'does not set last view if document has never been viewed' do
+      mock_api_server('{ "status": "Ok", "result": { "last_view": null }}')
+      described_class.metadata!('document_one.doc').last_view.should be_nil
+    end
+  end
+
   it { should have_accessor(:file)           }
   it { should have_accessor(:process_date)   }
   it { should have_accessor(:outputs)        }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: groupdocs
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.2.3
   prerelease: 
 platform: ruby
 authors:
@@ -422,7 +422,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -621879364264010468
+      hash: 568401921435177902
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -431,7 +431,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -621879364264010468
+      hash: 568401921435177902
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24