Class: CommitRange

Inherits:
Object
  • Object
show all
Includes:
ActiveModel::Conversion, Referable
Defined in:
app/models/commit_range.rb

Overview

CommitRange makes it easier to work with commit ranges

Examples:

range = CommitRange.new('f3f85602...e86e1013', project)
range.exclude_start?  # => false
range.to_s            # => "f3f85602...e86e1013"

range = CommitRange.new('f3f856029bc5f966c5a7ee24cf7efefdd20e6019..e86e1013709735be5bb767e2b228930c543f25ae', project)
range.exclude_start?  # => true
range.to_param        # => {from: "f3f856029bc5f966c5a7ee24cf7efefdd20e6019^", to: "e86e1013709735be5bb767e2b228930c543f25ae"}
range.to_s            # => "f3f85602..e86e1013"

# Assuming the specified project has a repository containing both commits:
range.valid_commits? # => true

Constant Summary collapse

REF_PATTERN =

The beginning and ending refs can be named or SHAs, and the range notation can be double- or triple-dot.

/[0-9a-zA-Z][0-9a-zA-Z_.-]*[0-9a-zA-Z\^]/.freeze
PATTERN =
/#{REF_PATTERN}\.{2,3}#{REF_PATTERN}/.freeze
STRICT_PATTERN =

In text references, the beginning and ending refs can only be SHAs between 7 and 40 hex characters.

/\h{7,40}\.{2,3}\h{7,40}/.freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Referable

#referable_inspect, #to_reference_base

Constructor Details

#initialize(range_string, project) ⇒ CommitRange

Initialize a CommitRange

range_string - The String commit range. project - The Project model.

Raises ArgumentError if `range_string` does not match `PATTERN`.


62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# File 'app/models/commit_range.rb', line 62

def initialize(range_string, project)
  @project = project

  range_string = range_string.strip

  unless range_string =~ /\A#{PATTERN}\z/
    raise ArgumentError, "invalid CommitRange string format: #{range_string}"
  end

  @ref_from, @notation, @ref_to = range_string.split(/(\.{2,3})/, 2)

  if project.valid_repo?
    @commit_from = project.commit(@ref_from)
    @commit_to   = project.commit(@ref_to)
  end

  if valid_commits?
    @ref_from = Commit.truncate_sha(sha_from) if sha_from.start_with?(@ref_from)
    @ref_to   = Commit.truncate_sha(sha_to)   if sha_to.start_with?(@ref_to)
  end
end

Instance Attribute Details

#commit_fromObject (readonly)

Returns the value of attribute commit_from


23
24
25
# File 'app/models/commit_range.rb', line 23

def commit_from
  @commit_from
end

#commit_toObject (readonly) Also known as: commit_end

Returns the value of attribute commit_to


23
24
25
# File 'app/models/commit_range.rb', line 23

def commit_to
  @commit_to
end

#notationObject (readonly)

Returns the value of attribute notation


23
24
25
# File 'app/models/commit_range.rb', line 23

def notation
  @notation
end

#projectObject

The Project model


27
28
29
# File 'app/models/commit_range.rb', line 27

def project
  @project
end

#ref_fromObject (readonly)

Returns the value of attribute ref_from


24
25
26
# File 'app/models/commit_range.rb', line 24

def ref_from
  @ref_from
end

#ref_toObject (readonly)

Returns the value of attribute ref_to


24
25
26
# File 'app/models/commit_range.rb', line 24

def ref_to
  @ref_to
end

Class Method Details


52
53
54
# File 'app/models/commit_range.rb', line 52

def self.link_reference_pattern
  @link_reference_pattern ||= super("compare", /(?<commit_range>#{PATTERN})/)
end

.reference_patternObject

Pattern used to extract commit range references from text

This pattern supports cross-project references.


45
46
47
48
49
50
# File 'app/models/commit_range.rb', line 45

def self.reference_pattern
  @reference_pattern ||= %r{
    (?:#{Project.reference_pattern}#{reference_prefix})?
    (?<commit_range>#{STRICT_PATTERN})
  }x
end

.reference_prefixObject


38
39
40
# File 'app/models/commit_range.rb', line 38

def self.reference_prefix
  '@'
end

Instance Method Details

#commit_startObject


154
155
156
157
158
159
160
161
162
# File 'app/models/commit_range.rb', line 154

def commit_start
  return unless sha_start

  if exclude_start?
    @commit_start ||= project.commit(sha_start)
  else
    commit_from
  end
end

#exclude_start?Boolean

Returns:

  • (Boolean)

122
123
124
# File 'app/models/commit_range.rb', line 122

def exclude_start?
  @notation == '..'
end

#inspectObject


84
85
86
# File 'app/models/commit_range.rb', line 84

def inspect
  %(#<#{self.class}:#{object_id} #{self}>)
end

#persisted?Boolean

Returns:

  • (Boolean)

132
133
134
# File 'app/models/commit_range.rb', line 132

def persisted?
  true
end

104
105
106
107
108
109
110
111
112
113
# File 'app/models/commit_range.rb', line 104

def reference_link_text(from = nil)
  project_reference = project.to_reference_base(from)
  reference         = ref_from + notation + ref_to

  if project_reference.present?
    project_reference + self.class.reference_prefix + reference
  else
    reference
  end
end

#sha_fromObject


136
137
138
139
140
# File 'app/models/commit_range.rb', line 136

def sha_from
  return unless @commit_from

  @commit_from.id
end

#sha_startObject


148
149
150
151
152
# File 'app/models/commit_range.rb', line 148

def sha_start
  return unless sha_from

  exclude_start? ? sha_from + '^' : sha_from
end

#sha_toObject Also known as: sha_end


142
143
144
145
146
# File 'app/models/commit_range.rb', line 142

def sha_to
  return unless @commit_to

  @commit_to.id
end

#to_paramObject

Return a Hash of parameters for passing to a URL helper

See `namespace_project_compare_url`


118
119
120
# File 'app/models/commit_range.rb', line 118

def to_param
  { from: sha_start, to: sha_to }
end

#to_reference(from = nil, full: false) ⇒ Object


94
95
96
97
98
99
100
101
102
# File 'app/models/commit_range.rb', line 94

def to_reference(from = nil, full: false)
  project_reference = project.to_reference_base(from, full: full)

  if project_reference.present?
    project_reference + self.class.reference_prefix + self.id
  else
    self.id
  end
end

#to_sObject Also known as: id


88
89
90
# File 'app/models/commit_range.rb', line 88

def to_s
  sha_from + notation + sha_to
end

#valid_commits?Boolean

Check if both the starting and ending commit IDs exist in a project's repository

Returns:

  • (Boolean)

128
129
130
# File 'app/models/commit_range.rb', line 128

def valid_commits?
  commit_start.present? && commit_end.present?
end