commits_helper.rb 7.9 KB
Newer Older
G
gitlabhq 已提交
1
module CommitsHelper
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
  # Returns a link to the commit author. If the author has a matching user and
  # is a member of the current @project it will link to the team member page.
  # Otherwise it will link to the author email as specified in the commit.
  #
  # options:
  #  avatar: true will prepend the avatar image
  #  size:   size of the avatar image in px
  def commit_author_link(commit, options = {})
    commit_person_link(commit, options.merge(source: :author))
  end

  # Just like #author_link but for the committer.
  def commit_committer_link(commit, options = {})
    commit_person_link(commit, options.merge(source: :committer))
  end

18 19 20 21 22
  def commit_to_html(commit, ref, project)
    render 'projects/commits/commit',
      commit: commit,
      ref: ref,
      project: project
23
  end
24

25 26 27 28 29
  # Breadcrumb links for a Project and, if applicable, a tree path
  def commits_breadcrumbs
    return unless @project && @ref

    # Add the root project link and the arrow icon
30
    crumbs = content_tag(:li, class: 'breadcrumb-item') do
V
Vinnie Okada 已提交
31 32
      link_to(
        @project.path,
33
        project_commits_path(@project, @ref)
V
Vinnie Okada 已提交
34
      )
35 36 37 38 39 40
    end

    if @path
      parts = @path.split('/')

      parts.each_with_index do |part, i|
41
        crumbs << content_tag(:li, class: 'breadcrumb-item') do
42
          # The text is just the individual part, but the link needs all the parts before it
V
Vinnie Okada 已提交
43 44
          link_to(
            part,
45
            project_commits_path(
V
Vinnie Okada 已提交
46 47 48 49
              @project,
              tree_join(@ref, parts[0..i].join('/'))
            )
          )
50 51 52 53 54 55 56
        end
      end
    end

    crumbs.html_safe
  end

57 58 59 60 61 62
  # Return Project default branch, if it present in array
  # Else - first branch in array (mb last actual branch)
  def commit_default_branch(project, branches)
    branches.include?(project.default_branch) ? branches.delete(project.default_branch) : branches.pop
  end

M
Mayra Cabrera 已提交
63
  # Returns a link formatted as a commit branch link
64
  def commit_branch_link(url, text)
65
    link_to(url, class: 'badge badge-gray ref-name branch-link') do
66
      sprite_icon('branch', size: 12, css_class: 'fork-svg') + "#{text}"
67 68 69
    end
  end

70 71
  # Returns the sorted alphabetically links to branches, separated by a comma
  def commit_branches_links(project, branches)
72
    branches.sort.map do |branch|
73 74 75 76
      commit_branch_link(project_ref_path(project, branch), branch)
    end.join(' ').html_safe
  end

M
Mayra Cabrera 已提交
77
  # Returns a link formatted as a commit tag link
78
  def commit_tag_link(url, text)
79
    link_to(url, class: 'badge badge-gray ref-name') do
80
      sprite_icon('tag', size: 12, css_class: 'append-right-5 vertical-align-middle') + "#{text}"
81
    end
82 83
  end

H
Hannes Rosenögger 已提交
84 85 86
  # Returns the sorted links to tags, separated by a comma
  def commit_tags_links(project, tags)
    sorted = VersionSorter.rsort(tags)
87
    sorted.map do |tag|
88 89
      commit_tag_link(project_ref_path(project, tag), tag)
    end.join(' ').html_safe
H
Hannes Rosenögger 已提交
90 91
  end

92
  def link_to_browse_code(project, commit)
93
    return unless current_controller?(:commits)
94

95
    if @path.blank?
96 97
      url = project_tree_path(project, commit)
      tooltip = _("Browse Files")
98
    elsif @repo.blob_at(commit.id, @path)
99 100
      url = project_blob_path(project, tree_join(commit.id, @path))
      tooltip = _("Browse File")
101
    elsif @path.present?
102 103 104 105 106 107
      url = project_tree_path(project, tree_join(commit.id, @path))
      tooltip = _("Browse Directory")
    end

    link_to url, class: "btn btn-default has-tooltip", title: tooltip, data: { container: "body" } do
      sprite_icon('folder-open')
108 109 110
    end
  end

111
  def revert_commit_link(commit, continue_to_path, btn_class: nil, has_tooltip: true)
112
    commit_action_link('revert', commit, continue_to_path, btn_class: btn_class, has_tooltip: has_tooltip)
113 114
  end

115
  def cherry_pick_commit_link(commit, continue_to_path, btn_class: nil, has_tooltip: true)
116
    commit_action_link('cherry-pick', commit, continue_to_path, btn_class: btn_class, has_tooltip: has_tooltip)
117 118
  end

119
  def commit_signature_badge_classes(additional_classes)
120
    %w(btn gpg-status-box) + Array(additional_classes)
121 122
  end

123 124 125 126 127 128 129 130 131 132 133
  protected

  # Private: Returns a link to a person. If the person has a matching user and
  # is a member of the current @project it will link to the team member page.
  # Otherwise it will link to the person email as specified in the commit.
  #
  # options:
  #  source: one of :author or :committer
  #  avatar: true will prepend the avatar image
  #  size:   size of the avatar image in px
  def commit_person_link(commit, options = {})
134
    user = commit.public_send(options[:source]) # rubocop:disable GitlabSecurity/PublicSend
135

136 137
    source_name  = clean(commit.public_send(:"#{options[:source]}_name"))  # rubocop:disable GitlabSecurity/PublicSend
    source_email = clean(commit.public_send(:"#{options[:source]}_email")) # rubocop:disable GitlabSecurity/PublicSend
D
Dmitriy Zaporozhets 已提交
138

D
Douwe Maan 已提交
139
    person_name = user.try(:name) || source_name
D
Dmitriy Zaporozhets 已提交
140

141 142
    text =
      if options[:avatar]
143
        content_tag(:span, person_name, class: "commit-#{options[:source]}-name")
144 145 146
      else
        person_name
      end
147

148 149
    link_options = {
      class: "commit-#{options[:source]}-link",
150
    }
151 152 153 154
    unless options[:has_tooltip] == false
      link_options[:class] << ' has-tooltip'
      link_options[:title] = source_email
    end
155

156
    if user.nil?
157
      mail_to(source_email, text, link_options)
158
    else
159
      link_to(text, user_path(user), link_options)
160 161
    end
  end
162

163 164 165 166 167 168
  def commit_action_link(action, commit, continue_to_path, btn_class: nil, has_tooltip: true)
    return unless current_user

    tooltip = "#{action.capitalize} this #{commit.change_type_title(current_user)} in a new merge request" if has_tooltip
    btn_class = "btn btn-#{btn_class}" unless btn_class.nil?

169
    if can_collaborate_with_project?(@project)
170 171 172 173 174 175 176
      link_to action.capitalize, "#modal-#{action}-commit", 'data-toggle' => 'modal', 'data-container' => 'body', title: (tooltip if has_tooltip), class: "#{btn_class} #{'has-tooltip' if has_tooltip}"
    elsif can?(current_user, :fork_project, @project)
      continue_params = {
        to: continue_to_path,
        notice: "#{edit_in_new_fork_notice} Try to #{action} this commit again.",
        notice_now: edit_in_new_fork_notice_now
      }
177
      fork_path = project_forks_path(@project,
178 179 180 181 182 183 184
        namespace_key: current_user.namespace.id,
        continue: continue_params)

      link_to action.capitalize, fork_path, class: btn_class, method: :post, 'data-toggle' => 'tooltip', 'data-container' => 'body', title: (tooltip if has_tooltip)
    end
  end

185 186 187
  def view_file_button(commit_sha, diff_new_path, project, replaced: false)
    title = replaced ? _('View replaced file @ ') : _('View file @ ')

V
Vinnie Okada 已提交
188
    link_to(
189
      project_blob_path(project,
190
                                  tree_join(commit_sha, diff_new_path)),
N
Nur Rony 已提交
191
      class: 'btn view-file js-view-file'
V
Vinnie Okada 已提交
192
    ) do
193
      raw(title) + content_tag(:span, Commit.truncate_sha(commit_sha),
194
                                       class: 'commit-sha')
S
skv 已提交
195 196
    end
  end
197

D
Douwe Maan 已提交
198
  def view_on_environment_button(commit_sha, diff_new_path, environment)
199 200 201 202 203
    return unless environment && commit_sha

    external_url = environment.external_url_for(diff_new_path, commit_sha)
    return unless external_url

204
    link_to(external_url, class: 'btn btn-file-option has-tooltip', target: '_blank', rel: 'noopener noreferrer', title: "View on #{environment.formatted_external_url}", data: { container: 'body' }) do
205 206 207 208
      icon('external-link')
    end
  end

209 210 211
  def truncate_sha(sha)
    Commit.truncate_sha(sha)
  end
212 213 214 215

  def clean(string)
    Sanitize.clean(string, remove_contents: true)
  end
216 217 218 219 220 221 222 223 224 225 226

  def limited_commits(commits)
    if commits.size > MergeRequestDiff::COMMITS_SAFE_SIZE
      [
        commits.first(MergeRequestDiff::COMMITS_SAFE_SIZE),
        commits.size - MergeRequestDiff::COMMITS_SAFE_SIZE
      ]
    else
      [commits, 0]
    end
  end
227 228 229

  def commit_path(project, commit, merge_request: nil)
    if merge_request&.persisted?
M
micael.bergeron 已提交
230
      diffs_project_merge_request_path(project, merge_request, commit_id: commit.id)
231
    else
M
micael.bergeron 已提交
232
      project_commit_path(project, commit)
233 234
    end
  end
G
gitlabhq 已提交
235
end