Class: Travis::Client::Repository

Inherits:
Entity
  • Object
show all
Includes:
States
Defined in:
lib/travis/client/repository.rb

Defined Under Namespace

Classes: Key

Constant Summary

Constants included from States

States::STATES

Constants inherited from Entity

Entity::MAP

Instance Attribute Summary collapse

Attributes inherited from Entity

#attributes, #curry, #id, #session

Instance Method Summary collapse

Methods included from States

#canceled?, #color, #created?, #errored?, #failed?, #finished?, #green?, #passed?, #pending?, #queued?, #ready?, #red?, #running?, #started?, #unsuccessful?, #yellow?

Methods inherited from Entity

#[], #[]=, aka, #attribute_names, attributes, #cancelable?, cast_id, #complete?, has, id?, id_field, #include?, #inspect, inspect_info, #load, many, #missing?, one, preloadable, preloadable?, relations, #relations, #reload, #restartable?, subclass_for, subclasses, time, #to_h, #update_attributes, weak?

Constructor Details

#initializeRepository

Returns a new instance of Repository.



61
62
63
64
# File 'lib/travis/client/repository.rb', line 61

def initialize(*)
  super
  attributes['active'] = attributes['private'] = attributes['admin'] = nil
end

Instance Attribute Details

#descriptionObject (readonly)

Returns the value of attribute description.



1
2
3
# File 'lib/travis/client/repository.rb', line 1

def description
  @description
end

#last_buildObject (readonly)



90
91
92
93
94
95
96
97
98
99
100
101
102
# File 'lib/travis/client/repository.rb', line 90

def last_build
  return unless last_build_id
  attributes['last_build'] ||= begin
    last_build               = session.find_one(Build, last_build_id)
    last_build.number        = last_build_number
    last_build.state         = last_build_state
    last_build.duration      = last_build_duration
    last_build.started_at    = last_build_started_at
    last_build.finished_at   = last_build_finished_at
    last_build.repository_id = id
    last_build
  end
end

#slugObject (readonly)

Returns the value of attribute slug.



1
2
3
# File 'lib/travis/client/repository.rb', line 1

def slug
  @slug
end

Instance Method Details

#active?Boolean

Returns:

  • (Boolean)


205
206
207
208
209
# File 'lib/travis/client/repository.rb', line 205

def active?
  # TODO remove once active is properly synced and exposed by api
  return active unless active.nil?
  last_build_id?
end

#admin?(user = session.user) ⇒ Boolean

Returns:

  • (Boolean)


211
212
213
# File 'lib/travis/client/repository.rb', line 211

def admin?(user = session.user)
  user.admin_access? self
end

#branch(name) ⇒ Object



126
127
128
129
130
131
132
# File 'lib/travis/client/repository.rb', line 126

def branch(name)
  attributes['branches']       ||= {}
  attributes['branches'][name] ||= begin
    build = attributes['last_on_branch'].detect { |b| b.commit.branch == name.to_s } if attributes['last_on_branch']
    build || session.get("/repos/#{id}/branches/#{name}")['branch']
  end
end

#branchesObject



122
123
124
# File 'lib/travis/client/repository.rb', line 122

def branches
  last_on_branch.map { |b| { b.commit.branch => b } }.inject(:merge)
end

#build(number) ⇒ Object



109
110
111
# File 'lib/travis/client/repository.rb', line 109

def build(number)
  builds(:number => number.to_s).first
end

#builds(params = nil) ⇒ Object



104
105
106
107
# File 'lib/travis/client/repository.rb', line 104

def builds(params = nil)
  return each_build unless params
  session.find_many(Build, params.merge(:repository_id => id))
end

#caches(params = {}) ⇒ Object



197
198
199
# File 'lib/travis/client/repository.rb', line 197

def caches(params = {})
  session.get("/repos/#{id}/caches", params)['caches']
end

#delete_caches(params = {}) ⇒ Object



201
202
203
# File 'lib/travis/client/repository.rb', line 201

def delete_caches(params = {})
  session.delete("/repos/#{id}/caches", params)['caches']
end

#disableObject



159
160
161
# File 'lib/travis/client/repository.rb', line 159

def disable
  set_hook(false)
end

#each_build(params = nil, &block) ⇒ Object



134
135
136
137
138
139
140
141
142
143
144
# File 'lib/travis/client/repository.rb', line 134

def each_build(params = nil, &block)
  return enum_for(__method__, params) unless block_given?
  params ||= {}
  chunk = builds(params)
  until chunk.empty?
    chunk.each(&block)
    number = chunk.last.number
    chunk  = number == '1' ? [] : builds(params.merge(:after_number => number))
  end
  self
end

#enableObject



163
164
165
# File 'lib/travis/client/repository.rb', line 163

def enable
  set_hook(true)
end

#encrypt(value) ⇒ Object



85
86
87
# File 'lib/travis/client/repository.rb', line 85

def encrypt(value)
  key.encrypt(value)
end

#job(number) ⇒ Object



146
147
148
149
150
151
152
# File 'lib/travis/client/repository.rb', line 146

def job(number)
  build_number = number.to_s[/^\d+/] or return nil
  build        = build(build_number) or return nil
  job          = build.jobs.detect { |j| j.number == number } if number != build_number
  job        ||= build.jobs.first if build and build.jobs.size == 1
  job
end

#last_on_branch(name = nil) ⇒ Object



117
118
119
120
# File 'lib/travis/client/repository.rb', line 117

def last_on_branch(name = nil)
  return branch(name) if name
  attributes['last_on_branch'] ||= session.get('branches', :repository_id => id)['branches']
end

#member?Boolean

Returns:

  • (Boolean)


175
176
177
# File 'lib/travis/client/repository.rb', line 175

def member?
  session.user.repositories.include? self
end

#nameObject



73
74
75
# File 'lib/travis/client/repository.rb', line 73

def name
  slug[/[^\/]+$/]
end

#ownerObject



183
184
185
# File 'lib/travis/client/repository.rb', line 183

def owner
  session.(owner_name)
end

#owner_nameObject



179
180
181
# File 'lib/travis/client/repository.rb', line 179

def owner_name
  slug[/^[^\/]+/]
end

#public_keyObject Also known as: key



66
67
68
69
70
71
# File 'lib/travis/client/repository.rb', line 66

def public_key
  attributes["public_key"] ||= begin
    payload = session.get_raw("/repos/#{id}/key")
    Key.new(payload.fetch('key'))
  end
end

#public_key=(key) ⇒ Object Also known as: key=



77
78
79
80
# File 'lib/travis/client/repository.rb', line 77

def public_key=(key)
  key = Key.new(key) unless key.is_a? Key
  set_attribute(:public_key, key)
end

#pull?(user = session.user) ⇒ Boolean

Returns:

  • (Boolean)


219
220
221
# File 'lib/travis/client/repository.rb', line 219

def pull?(user = session.user)
  user.pull_access? self
end

#push?(user = session.user) ⇒ Boolean

Returns:

  • (Boolean)


215
216
217
# File 'lib/travis/client/repository.rb', line 215

def push?(user = session.user)
  user.push_access? self
end

#pusher_channelsObject



167
168
169
170
171
172
173
# File 'lib/travis/client/repository.rb', line 167

def pusher_channels
  attributes['pusher_channels'] ||= if session.private_channels?
    ["user-#{session.user.id}", "repo-#{id}"]
  else
    ["common"]
  end
end

#recent_buildsObject



113
114
115
# File 'lib/travis/client/repository.rb', line 113

def recent_builds
  builds({})
end

#set_hook(flag) ⇒ Object



154
155
156
157
# File 'lib/travis/client/repository.rb', line 154

def set_hook(flag)
  result = session.put_raw('/hooks/', :hook => { :id => id, :active => flag })
  result['result']
end

#settingsObject



187
188
189
190
191
192
193
194
195
# File 'lib/travis/client/repository.rb', line 187

def settings
  attributes['settings'] ||= begin
    settings = session.get("/repos/#{id}/settings")['settings']
    settings.repository = self
    settings
  end
rescue Travis::Client::NotFound
  raise Travis::Client::Error, "not allowed to access settings"
end