commits_helper.rb 7.5 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 30
  # 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
    crumbs = content_tag(:li) 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) 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 65 66 67 68 69
  def commit_branch_link(url, text)
    link_to(url, class: 'label label-gray ref-name') do
      icon('code-fork') + " #{text}"
    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 79 80 81
  def commit_tag_link(url, text)
    link_to(url, class: 'label label-gray ref-name') do
      icon('tag') + " #{text}"
    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 96
    if @path.blank?
      return link_to(
97
        _("Browse Files"),
98
        project_tree_path(project, commit),
99 100
        class: "btn btn-default"
      )
101
    elsif @repo.blob_at(commit.id, @path)
102
      return link_to(
103
        _("Browse File"),
104
        project_blob_path(project,
105 106 107 108 109
                                    tree_join(commit.id, @path)),
        class: "btn btn-default"
      )
    elsif @path.present?
      return link_to(
110
        _("Browse Directory"),
111
        project_tree_path(project,
112 113 114
                                    tree_join(commit.id, @path)),
        class: "btn btn-default"
      )
115 116 117
    end
  end

118
  def revert_commit_link(commit, continue_to_path, btn_class: nil, has_tooltip: true)
119
    commit_action_link('revert', commit, continue_to_path, btn_class: btn_class, has_tooltip: has_tooltip)
120 121
  end

122
  def cherry_pick_commit_link(commit, continue_to_path, btn_class: nil, has_tooltip: true)
123
    commit_action_link('cherry-pick', commit, continue_to_path, btn_class: btn_class, has_tooltip: has_tooltip)
124 125
  end

126
  def commit_signature_badge_classes(additional_classes)
127
    %w(btn gpg-status-box) + Array(additional_classes)
128 129
  end

130 131 132 133 134 135 136 137 138 139 140
  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 = {})
141
    user = commit.public_send(options[:source]) # rubocop:disable GitlabSecurity/PublicSend
142

143 144
    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 已提交
145

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

148 149
    text =
      if options[:avatar]
150
        content_tag(:span, person_name, class: "commit-#{options[:source]}-name")
151 152 153
      else
        person_name
      end
154

155
    options = {
156
      class: "commit-#{options[:source]}-link has-tooltip",
157
      title: source_email
158 159
    }

160
    if user.nil?
161
      mail_to(source_email, text, options)
162
    else
163
      link_to(text, user_path(user), options)
164 165
    end
  end
166

167 168 169 170 171 172 173 174 175 176 177 178 179 180
  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?

    if can_collaborate_with_project?
      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
      }
181
      fork_path = project_forks_path(@project,
182 183 184 185 186 187 188
        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

189 190 191
  def view_file_button(commit_sha, diff_new_path, project, replaced: false)
    title = replaced ? _('View replaced file @ ') : _('View file @ ')

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

D
Douwe Maan 已提交
202
  def view_on_environment_button(commit_sha, diff_new_path, environment)
203 204 205 206 207
    return unless environment && commit_sha

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

208
    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
209 210 211 212
      icon('external-link')
    end
  end

213 214 215
  def truncate_sha(sha)
    Commit.truncate_sha(sha)
  end
216 217 218 219

  def clean(string)
    Sanitize.clean(string, remove_contents: true)
  end
220 221 222 223 224 225 226 227 228 229 230

  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
G
gitlabhq 已提交
231
end