Class: Gini::Api::Document

Inherits:
Object
  • Object
show all
Defined in:
lib/gini-api/document.rb

Overview

Contains document related data from uploaded or fetched document

Defined Under Namespace

Classes: Extractions, Layout

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(api, location, from_data = nil) ⇒ Document

Instantiate a new Gini::Api::Document object from URL

Parameters:

  • api (Gini::Api::Client) —

    Gini::Api::Client object

  • location (String) —

    Document URL

  • from_data (Hash) (defaults to: nil) —

    Hash with doc data (from search for example)



18
19
20
21
22
23
 
# File 'lib/gini-api/document.rb', line 18

def initialize(api, location, from_data = nil)
  @api      = api
  @location = location

  update(from_data)
end

Instance Attribute Details

#duration ⇒ Object

Returns the value of attribute duration.



10
11
12
 
# File 'lib/gini-api/document.rb', line 10

def duration
  @duration
end

Instance Method Details

#extractions ⇒ Gini::Api::Document::Extractions

Initialize extractions from @_links and return Gini::Api::Extractions object

Returns:



93
94
95
 
# File 'lib/gini-api/document.rb', line 93

def extractions
  @extractions ||= Gini::Api::Document::Extractions.new(@api, @_links[:extractions])
end

#layout ⇒ Gini::Api::Document::Layout

Initialize layout from @_links and return Gini::Api::Layout object

Returns:



101
102
103
 
# File 'lib/gini-api/document.rb', line 101

def layout
  @layout ||= Gini::Api::Document::Layout.new(@api, @_links[:layout])
end

#pages ⇒ Object

Override @pages instance variable. Removes key :pageNumber, key :images and starts by index 0. Page 1 becomes index 0



108
109
110
 
# File 'lib/gini-api/document.rb', line 108

def pages
  @pages.map { |page| page[:images] }
end

#poll(interval = 0.5) ⇒ Object

Poll document progress and return when state equals COMPLETED Known states are PENDING, COMPLETED and ERROR

Parameters:

  • interval (Float) (defaults to: 0.5) —

    API polling interval



60
61
62
63
64
65
66
67
68
 
# File 'lib/gini-api/document.rb', line 60

def poll(interval = 0.5)
  EM.run do
    EM.add_periodic_timer(interval) do
      update
      EM.stop if @progress =~ /(COMPLETED|ERROR)/
      yield self if block_given?
    end
  end
end

#processed ⇒ data

Get processed document

Returns:

  • (data) —

    The binary representation of the processed document (pdf, jpg, png, …)



74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/gini-api/document.rb', line 74

def processed
  response = @api.request(
    :get,
    @_links[:processed],
    headers: { accept: 'application/octet-stream' }
  )
  unless response.status == 200
    raise Gini::Api::DocumentError.new(
      "Failed to fetch processed document (code=#{response.status})",
      response
    )
  end
  response.body
end

#submit_feedback(label, value) ⇒ Object

Submit feedback on extraction label

Parameters:

  • label (String) —

    Extraction label to submit feedback on

  • value (String) —

    The new value for the given label



117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
 
# File 'lib/gini-api/document.rb', line 117

def submit_feedback(label, value)
  unless extractions.send(label.to_sym)
    raise Gini::Api::DocumentError.new("Unknown label #{label}: Not found")
  end
  response = @api.request(
    :put,
    "#{@_links[:extractions]}/#{label}",
    headers: { 'content-type' => @api.version_header[:accept] },
    body: { value: value }.to_json
  )
  unless response.status == 204
    raise Gini::Api::DocumentError.new(
      "Failed to submit feedback for label #{label} (code=#{response.status})",
      response
    )
  end
end

#update(from_data = nil) ⇒ Object

Fetch document resource and populate instance variables

Parameters:

  • from_data (Hash) (defaults to: nil) —

    Ruby hash with doc data



29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/gini-api/document.rb', line 29

def update(from_data = nil)
  data = {}

  if from_data.nil?
    response = @api.request(:get, @location)
    unless response.status == 200
      raise Gini::Api::DocumentError.new(
        "Failed to fetch document data (code=#{response.status})",
        response
      )
    end
    data = response.parsed
  else
    data = from_data
  end

  data.each do |k, v|
    instance_variable_set("@#{k}", v)

    # We skip pages as it's rewritted by method pages()
    next if k == :pages

    self.class.send(:attr_reader, k)
  end
end