Class: Gitlab::PaginatedResponse

Inherits:
Object
  • Object
show all
Defined in:
lib/gitlab/paginated_response.rb

Overview

Wrapper class of paginated response.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(array) ⇒ PaginatedResponse


8
9
10
# File 'lib/gitlab/paginated_response.rb', line 8

def initialize(array)
  @array = array
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(name, *args, &block) ⇒ Object


20
21
22
23
24
25
26
# File 'lib/gitlab/paginated_response.rb', line 20

def method_missing(name, *args, &block)
  if @array.respond_to?(name)
    @array.send(name, *args, &block)
  else
    super
  end
end

Instance Attribute Details

#clientObject

Returns the value of attribute client


6
7
8
# File 'lib/gitlab/paginated_response.rb', line 6

def client
  @client
end

Instance Method Details

#==(other) ⇒ Object


12
13
14
# File 'lib/gitlab/paginated_response.rb', line 12

def ==(other)
  @array == other
end

#auto_paginateObject


45
46
47
48
49
50
51
52
53
54
55
56
57
# File 'lib/gitlab/paginated_response.rb', line 45

def auto_paginate
  response = block_given? ? nil : []
  each_page do |page|
    if block_given?
      page.each do |item|
        yield item
      end
    else
      response += page
    end
  end
  response
end

#each_page {|current| ... } ⇒ Object

Yields:

  • (current)

36
37
38
39
40
41
42
43
# File 'lib/gitlab/paginated_response.rb', line 36

def each_page
  current = self
  yield current
  while current.has_next_page?
    current = current.next_page
    yield current
  end
end

#first_pageObject


95
96
97
98
99
100
# File 'lib/gitlab/paginated_response.rb', line 95

def first_page
  return nil if @client.nil? || !has_first_page?

  path = @links.first.sub(/#{@client.endpoint}/, '')
  @client.get(path)
end

#first_page?Boolean Also known as: has_first_page?


90
91
92
# File 'lib/gitlab/paginated_response.rb', line 90

def first_page?
  !(@links.nil? || @links.first.nil?)
end

#inspectObject


16
17
18
# File 'lib/gitlab/paginated_response.rb', line 16

def inspect
  @array.inspect
end

#last_pageObject


83
84
85
86
87
88
# File 'lib/gitlab/paginated_response.rb', line 83

def last_page
  return nil if @client.nil? || !has_last_page?

  path = @links.last.sub(/#{@client.endpoint}/, '')
  @client.get(path)
end

#last_page?Boolean Also known as: has_last_page?


78
79
80
# File 'lib/gitlab/paginated_response.rb', line 78

def last_page?
  !(@links.nil? || @links.last.nil?)
end

#next_pageObject


107
108
109
110
111
112
# File 'lib/gitlab/paginated_response.rb', line 107

def next_page
  return nil if @client.nil? || !has_next_page?

  path = @links.next.sub(/#{@client.endpoint}/, '')
  @client.get(path)
end

#next_page?Boolean Also known as: has_next_page?


102
103
104
# File 'lib/gitlab/paginated_response.rb', line 102

def next_page?
  !(@links.nil? || @links.next.nil?)
end

#paginate_with_limit(limit) ⇒ Object


59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
# File 'lib/gitlab/paginated_response.rb', line 59

def paginate_with_limit(limit)
  response = block_given? ? nil : []
  count = 0
  each_page do |page|
    if block_given?
      page.each do |item|
        yield item
        count += 1
        break if count >= limit
      end
    else
      response += page[0, limit - count]
      count = response.length
    end
    break if count >= limit
  end
  response
end

#parse_headers!(headers) ⇒ Object


32
33
34
# File 'lib/gitlab/paginated_response.rb', line 32

def parse_headers!(headers)
  @links = PageLinks.new headers
end

#prev_pageObject


119
120
121
122
123
124
# File 'lib/gitlab/paginated_response.rb', line 119

def prev_page
  return nil if @client.nil? || !has_prev_page?

  path = @links.prev.sub(/#{@client.endpoint}/, '')
  @client.get(path)
end

#prev_page?Boolean Also known as: has_prev_page?


114
115
116
# File 'lib/gitlab/paginated_response.rb', line 114

def prev_page?
  !(@links.nil? || @links.prev.nil?)
end

#respond_to_missing?(method_name, include_private = false) ⇒ Boolean


28
29
30
# File 'lib/gitlab/paginated_response.rb', line 28

def respond_to_missing?(method_name, include_private = false)
  super || @array.respond_to?(method_name, include_private)
end