summaryrefslogtreecommitdiff
path: root/lib/gitlab/view/presenter/base.rb
blob: a2d217fb42f55883f86b16c0df82811f9df965b7 (plain)
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
65
66
67
68
69
70
71
# frozen_string_literal: true

module Gitlab
  module View
    module Presenter
      CannotOverrideMethodError = Class.new(StandardError)

      module Base
        extend ActiveSupport::Concern

        include Gitlab::Routing
        include Gitlab::Allowable

        # Presenters should always access the subject through an explicit getter defined with
        # `presents ..., as:`, the `__subject__` method is only intended for internal use.
        def __subject__
          @subject
        end

        def can?(user, action, overridden_subject = nil)
          super(user, action, overridden_subject || __subject__)
        end

        # delegate all #can? queries to the subject
        def declarative_policy_delegate
          __subject__
        end

        def present(**attributes)
          self
        end

        def url_builder
          Gitlab::UrlBuilder.instance
        end

        def is_a?(type)
          super || __subject__.is_a?(type)
        end

        def web_url
          url_builder.build(__subject__)
        end

        def web_path
          url_builder.build(__subject__, only_path: true)
        end

        class_methods do
          def presenter?
            true
          end

          def presents(*target_classes, as: nil)
            if target_classes.any? { |k| k.is_a?(Symbol) }
              raise ArgumentError, "Unsupported target class type: #{target_classes}."
            end

            if self < ::Gitlab::View::Presenter::Delegated
              target_classes.each { |k| delegator_target(k) }
            elsif self < ::Gitlab::View::Presenter::Simple
              # no-op
            end

            define_method(as) { __subject__ } if as
          end
        end
      end
    end
  end
end