File: phorge.rb

package info (click to toggle)
gitlab 17.6.5-19
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 629,368 kB
  • sloc: ruby: 1,915,304; javascript: 557,307; sql: 60,639; xml: 6,509; sh: 4,567; makefile: 1,239; python: 406
file content (64 lines) | stat: -rw-r--r-- 2,187 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# frozen_string_literal: true

module Integrations
  class Phorge < BaseIssueTracker
    include HasIssueTrackerFields
    include HasAvatar

    PHORGE_FIELDS = %w[project_url issues_url].freeze

    validates :project_url, :issues_url, presence: true, public_url: true, if: :activated?

    # See https://we.phorge.it/source/phorge/browse/master/src/infrastructure/markup/rule/PhabricatorObjectRemarkupRule.php
    # for a canonical source of the regular expression used to parse Phorge
    # object references.
    #
    # > The "(?<![#@-])" prevents us from linking "#abcdef" or similar, and
    # > "ABC-T1" (see T5714), and from matching "@T1" as a task (it is a user)
    # > (see T9479).
    #
    # Note that object references in Phorge are prefixed with letters unique
    # to their underlying application, so T123 (a Maniphest task) is
    # distinct from D123 (a Differential patch). Keeping the T as part of
    # the task ID is appropriate here as it leaves room for expanding
    # reference parsing/linking to other types of Phorge entities.
    #
    # Also note, a prefix of # is being allowed here due to: 1) an assumed
    # likelihood of use; and b) lack of collision with native GitLab issues
    # since all Phorge identifiers have the application specific alpha prefix.
    def reference_pattern(*)
      @reference_pattern ||= /\b(?<![@-])(?<issue>T\d+)\b/
    end

    def self.title
      'Phorge'
    end

    def self.description
      s_("IssueTracker|Use Phorge as this project's issue tracker.")
    end

    def self.help
      docs_link = ActionController::Base.helpers.link_to(
        '',
        Rails.application.routes.url_helpers.help_page_url('user/project/integrations/phorge.md'),
        target: '_blank',
        rel: 'noopener noreferrer'
      )
      tag_pair_docs_link = tag_pair(docs_link, :link_start, :link_end)

      safe_format(
        s_("IssueTracker|Use Phorge as this project's issue tracker. %{link_start}Learn more.%{link_end}"),
        tag_pair_docs_link
      )
    end

    def self.to_param
      'phorge'
    end

    def self.fields
      super.select { |field| PHORGE_FIELDS.include?(field.name) }
    end
  end
end