Class: Gitlab::Git::Commit

Inherits:
Object
  • Object
show all
Extended by:
WrapsGitalyErrors
Includes:
EncodingHelper, Utils::StrongMemoize
Defined in:
lib/gitlab/git/commit.rb

Constant Summary collapse

MAX_COMMIT_MESSAGE_DISPLAY_SIZE =
10.megabytes
MIN_SHA_LENGTH =
7
SERIALIZE_KEYS =
[
  :id, :message, :parent_ids,
  :authored_date, :author_name, :author_email,
  :committed_date, :committer_name, :committer_email
].freeze

Constants included from EncodingHelper

EncodingHelper::ENCODING_CONFIDENCE_THRESHOLD

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from WrapsGitalyErrors

wrapped_gitaly_errors

Methods included from Utils::StrongMemoize

#clear_memoization, #strong_memoize, #strong_memoized?

Methods included from EncodingHelper

#binary_io, #detect_binary?, #detect_libgit2_binary?, #encode!, #encode_binary, #encode_utf8

Constructor Details

#initialize(repository, raw_commit, head = nil, lazy_load_parents: false) ⇒ Commit

Returns a new instance of Commit.


184
185
186
187
188
189
190
191
192
# File 'lib/gitlab/git/commit.rb', line 184

def initialize(repository, raw_commit, head = nil, lazy_load_parents: false)
  raise "Nil as raw commit passed" unless raw_commit

  @repository = repository
  @head = head
  @lazy_load_parents = lazy_load_parents

  init_commit(raw_commit)
end

Instance Attribute Details

#headObject

Returns the value of attribute head


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

def head
  @head
end

#raw_commitObject

Returns the value of attribute raw_commit


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

def raw_commit
  @raw_commit
end

Class Method Details

.batch_by_oid(repo, oids) ⇒ Object

Only to be used when the object ids will not necessarily have a relation to each other. The last 10 commits for a branch for example, should go through .where


153
154
155
156
157
# File 'lib/gitlab/git/commit.rb', line 153

def batch_by_oid(repo, oids)
  wrapped_gitaly_errors do
    repo.gitaly_commit_client.list_commits_by_oid(oids)
  end
end

.batch_signature_extraction(repository, commit_ids) ⇒ Object


167
168
169
# File 'lib/gitlab/git/commit.rb', line 167

def batch_signature_extraction(repository, commit_ids)
  repository.gitaly_commit_client.get_commit_signatures(commit_ids)
end

.between(repo, base, head) ⇒ Object

Get commits between two revspecs See also #repository.commits_between

Ex.

Commit.between(repo, '29eda46b', 'master')

112
113
114
115
116
# File 'lib/gitlab/git/commit.rb', line 112

def between(repo, base, head)
  wrapped_gitaly_errors do
    repo.gitaly_commit_client.between(base, head)
  end
end

.decorate(repository, commit, ref = nil) ⇒ Object


142
143
144
# File 'lib/gitlab/git/commit.rb', line 142

def decorate(repository, commit, ref = nil)
  Gitlab::Git::Commit.new(repository, commit, ref)
end

.extract_signature_lazily(repository, commit_id) ⇒ Object


159
160
161
162
163
164
165
# File 'lib/gitlab/git/commit.rb', line 159

def extract_signature_lazily(repository, commit_id)
  BatchLoader.for(commit_id).batch(key: repository) do |commit_ids, loader, args|
    batch_signature_extraction(args[:key], commit_ids).each do |commit_id, signature_data|
      loader.call(commit_id, signature_data)
    end
  end
end

.find(repo, commit_id = "HEAD") ⇒ Object

Get single commit

Ex.

Commit.find(repo, '29eda46b')

Commit.find(repo, 'master')

Gitaly migration: gitlab.com/gitlab-org/gitaly/issues/321


57
58
59
60
61
62
63
64
65
66
67
68
69
# File 'lib/gitlab/git/commit.rb', line 57

def find(repo, commit_id = "HEAD")
  # Already a commit?
  return commit_id if commit_id.is_a?(Gitlab::Git::Commit)

  # This saves us an RPC round trip.
  return unless valid?(commit_id)

  commit = find_commit(repo, commit_id)

  decorate(repo, commit) if commit
rescue Gitlab::Git::CommandError, Gitlab::Git::Repository::NoRepository, ArgumentError
  nil
end

.find_all(repo, options = {}) ⇒ Object

Returns commits collection

Ex.

Commit.find_all(
  repo,
  ref: 'master',
  max_count: 10,
  skip: 5,
  order: :date
)

+options+ is a Hash of optional arguments to git
  :ref is the ref from which to begin (SHA1 or name)
  :max_count is the maximum number of commits to fetch
  :skip is the number of commits to skip
  :order is the commits order and allowed value is :none (default), :date,
     :topo, or any combination of them (in an array). Commit ordering types
     are documented here: https://git-scm.com/docs/git-log#_commit_ordering

136
137
138
139
140
# File 'lib/gitlab/git/commit.rb', line 136

def find_all(repo, options = {})
  wrapped_gitaly_errors do
    Gitlab::GitalyClient::CommitService.new(repo).find_all_commits(options)
  end
end

.find_commit(repo, commit_id) ⇒ Object


71
72
73
74
75
# File 'lib/gitlab/git/commit.rb', line 71

def find_commit(repo, commit_id)
  wrapped_gitaly_errors do
    repo.gitaly_commit_client.find_commit(commit_id)
  end
end

.get_message(repository, commit_id) ⇒ Object


171
172
173
174
175
176
177
# File 'lib/gitlab/git/commit.rb', line 171

def get_message(repository, commit_id)
  BatchLoader.for(commit_id).batch(key: repository) do |commit_ids, loader, args|
    get_messages(args[:key], commit_ids).each do |commit_id, message|
      loader.call(commit_id, message)
    end
  end
end

.get_messages(repository, commit_ids) ⇒ Object


179
180
181
# File 'lib/gitlab/git/commit.rb', line 179

def get_messages(repository, commit_ids)
  repository.gitaly_commit_client.get_commit_messages(commit_ids)
end

.last(repo) ⇒ Object

Get last commit for HEAD

Ex.

Commit.last(repo)

82
83
84
# File 'lib/gitlab/git/commit.rb', line 82

def last(repo)
  find(repo)
end

.last_for_path(repo, ref, path = nil, literal_pathspec: false) ⇒ Object

Get last commit for specified path and ref

Ex.

Commit.last_for_path(repo, '29eda46b', 'app/models')

Commit.last_for_path(repo, 'master', 'Gemfile')

93
94
95
96
97
98
99
100
101
102
103
104
# File 'lib/gitlab/git/commit.rb', line 93

def last_for_path(repo, ref, path = nil, literal_pathspec: false)
  # rubocop: disable Rails/FindBy
  # This is not where..first from ActiveRecord
  where(
    repo: repo,
    ref: ref,
    path: path,
    limit: 1,
    literal_pathspec: literal_pathspec
  ).first
  # rubocop: enable Rails/FindBy
end

.shas_with_signatures(repository, shas) ⇒ Object


146
147
148
# File 'lib/gitlab/git/commit.rb', line 146

def shas_with_signatures(repository, shas)
  Gitlab::GitalyClient::CommitService.new(repository).filter_shas_with_signatures(shas)
end

.where(options) ⇒ Object

Get commits collection

Ex.

Commit.where(
  repo: repo,
  ref: 'master',
  path: 'app/models',
  limit: 10,
  offset: 5,
)

42
43
44
45
46
47
# File 'lib/gitlab/git/commit.rb', line 42

def where(options)
  repo = options.delete(:repo)
  raise 'Gitlab::Git::Repository is required' unless repo.respond_to?(:log)

  repo.log(options)
end

Instance Method Details

#==(other) ⇒ Object


24
25
26
27
28
# File 'lib/gitlab/git/commit.rb', line 24

def ==(other)
  return false unless other.is_a?(Gitlab::Git::Commit)

  id && id == other.id
end

#author_emailObject


314
315
316
# File 'lib/gitlab/git/commit.rb', line 314

def author_email
  encode! @author_email
end

#author_nameObject


310
311
312
# File 'lib/gitlab/git/commit.rb', line 310

def author_name
  encode! @author_name
end

#authored_dateObject


242
243
244
245
246
# File 'lib/gitlab/git/commit.rb', line 242

def authored_date
  strong_memoize(:authored_date) do
    init_date_from_gitaly(raw_commit.author) if raw_commit
  end
end

#commit_tree_entry(path) ⇒ Object


340
341
342
343
344
345
346
347
348
349
350
351
352
353
# File 'lib/gitlab/git/commit.rb', line 340

def commit_tree_entry(path)
  # We're only interested in metadata, so limit actual data to 1 byte
  # since Gitaly doesn't support "send no data" option.
  entry = @repository.gitaly_commit_client.tree_entry(id, path, 1)
  return unless entry

  # To be compatible with the rugged format
  entry = entry.to_h
  entry.delete(:data)
  entry[:name] = File.basename(path)
  entry[:type] = entry[:type].downcase

  entry
end

#committed_dateObject


236
237
238
239
240
# File 'lib/gitlab/git/commit.rb', line 236

def committed_date
  strong_memoize(:committed_date) do
    init_date_from_gitaly(raw_commit.committer) if raw_commit
  end
end

#committer_emailObject


322
323
324
# File 'lib/gitlab/git/commit.rb', line 322

def committer_email
  encode! @committer_email
end

#committer_nameObject


318
319
320
# File 'lib/gitlab/git/commit.rb', line 318

def committer_name
  encode! @committer_name
end

#created_atObject


217
218
219
# File 'lib/gitlab/git/commit.rb', line 217

def created_at
  committed_date
end

#dateObject


279
280
281
# File 'lib/gitlab/git/commit.rb', line 279

def date
  committed_date
end

#deltasObject


256
257
258
259
260
261
# File 'lib/gitlab/git/commit.rb', line 256

def deltas
  @deltas ||= begin
    deltas = @repository.gitaly_commit_client.commit_deltas(self)
    deltas.map { |delta| Gitlab::Git::Diff.new(delta) }
  end
end

#diff_from_parent(options = {}) ⇒ Object

Returns a diff object for the changes from this commit's first parent. If there is no parent, then the diff is between this commit and an empty repo. See Repository#diff for keys allowed in the options hash.


252
253
254
# File 'lib/gitlab/git/commit.rb', line 252

def diff_from_parent(options = {})
  @repository.gitaly_commit_client.diff_from_parent(self, options)
end

#different_committer?Boolean

Was this commit committed by a different person than the original author?

Returns:

  • (Boolean)

222
223
224
# File 'lib/gitlab/git/commit.rb', line 222

def different_committer?
  author_name != committer_name || author_email != committer_email
end

#diffs(options = {}) ⇒ Object


283
284
285
# File 'lib/gitlab/git/commit.rb', line 283

def diffs(options = {})
  Gitlab::Git::DiffCollection.new(diff_from_parent(options), options)
end

#gitaly_commit?Boolean

Returns:

  • (Boolean)

330
331
332
# File 'lib/gitlab/git/commit.rb', line 330

def gitaly_commit?
  raw_commit.is_a?(Gitaly::GitCommit)
end

#has_zero_stats?Boolean

Returns:

  • (Boolean)

263
264
265
266
267
# File 'lib/gitlab/git/commit.rb', line 263

def has_zero_stats?
  stats.total == 0
rescue
  true
end

#init_commit(raw_commit) ⇒ Object


194
195
196
197
198
199
200
201
202
203
# File 'lib/gitlab/git/commit.rb', line 194

def init_commit(raw_commit)
  case raw_commit
  when Hash
    init_from_hash(raw_commit)
  when Gitaly::GitCommit
    init_from_gitaly(raw_commit)
  else
    raise "Invalid raw commit type: #{raw_commit.class}"
  end
end

#merge_commit?Boolean

Returns:

  • (Boolean)

326
327
328
# File 'lib/gitlab/git/commit.rb', line 326

def merge_commit?
  parent_ids.size > 1
end

#messageObject


306
307
308
# File 'lib/gitlab/git/commit.rb', line 306

def message
  encode! @message
end

#no_commit_messageObject


269
270
271
# File 'lib/gitlab/git/commit.rb', line 269

def no_commit_message
  "No commit message"
end

#parent_idObject


232
233
234
# File 'lib/gitlab/git/commit.rb', line 232

def parent_id
  parent_ids.first
end

#parent_idsObject


226
227
228
229
230
# File 'lib/gitlab/git/commit.rb', line 226

def parent_ids
  return @parent_ids unless @lazy_load_parents

  @parent_ids ||= @repository.commit(id).parent_ids
end

#parentsObject


287
288
289
# File 'lib/gitlab/git/commit.rb', line 287

def parents
  parent_ids.map { |oid| self.class.find(@repository, oid) }.compact
end

#ref_names(repo) ⇒ Object

Get ref names collection

Ex.

commit.ref_names(repo)

300
301
302
303
304
# File 'lib/gitlab/git/commit.rb', line 300

def ref_names(repo)
  refs(repo).map do |ref|
    ref.sub(%r{^refs/(heads|remotes|tags)/}, "")
  end
end

#safe_messageObject


213
214
215
# File 'lib/gitlab/git/commit.rb', line 213

def safe_message
  @safe_message ||= message
end

#shaObject


205
206
207
# File 'lib/gitlab/git/commit.rb', line 205

def sha
  id
end

#short_id(length = 10) ⇒ Object


209
210
211
# File 'lib/gitlab/git/commit.rb', line 209

def short_id(length = 10)
  id.to_s[0..length]
end

#statsObject


291
292
293
# File 'lib/gitlab/git/commit.rb', line 291

def stats
  Gitlab::Git::CommitStats.new(@repository, self)
end

#to_gitaly_commitObject


355
356
357
358
359
360
361
362
363
364
365
366
367
# File 'lib/gitlab/git/commit.rb', line 355

def to_gitaly_commit
  return raw_commit if gitaly_commit?

  message_split = raw_commit.message.split("\n", 2)
  Gitaly::GitCommit.new(
    id: raw_commit.oid,
    subject: message_split[0] ? message_split[0].chomp.b : "",
    body: raw_commit.message.b,
    parent_ids: raw_commit.parent_ids,
    author: gitaly_commit_author_from_raw(raw_commit.author),
    committer: gitaly_commit_author_from_raw(raw_commit.committer)
  )
end

#to_hashObject


273
274
275
276
277
# File 'lib/gitlab/git/commit.rb', line 273

def to_hash
  serialize_keys.map.with_object({}) do |key, hash|
    hash[key] = send(key) # rubocop:disable GitlabSecurity/PublicSend
  end
end

#tree_entry(path) ⇒ Object


334
335
336
337
338
# File 'lib/gitlab/git/commit.rb', line 334

def tree_entry(path)
  return unless path.present?

  commit_tree_entry(path)
end