An error occurred fetching the project authors.
  1. 15 Nov, 2018 1 commit
    • Yorick Peterse's avatar
      Refactor how a few ActiveRecord enums are defined · 590ff80f
      Yorick Peterse authored
      In a few models we define ActiveRecord enums that are redefined in EE
      using the following pattern:
      
          enum :some_enum, {
            ...
          }.merge(EE_ENUM_VALUES)
      
      This particular approach is problematic to deal with, because it
      requires that we `prepend` and EE module _before_ defining the enum.
      This typically translates to the `prepend` being the first line in the
      model in EE, but this can easily lead to merge conflicts when developers
      add more `include` and/or `prepend` lines.
      
      As part of https://gitlab.com/gitlab-org/gitlab-ee/issues/8244 and
      https://gitlab.com/gitlab-org/gitlab-ee/issues/8241 we are moving
      `prepend` to the last line in a file, reducing the chances of running
      into merge conflicts. This poses a bit of a problem with the pattern
      above, because this pattern does not allow us to move the `prepend`
      further down a file.
      
      To resolve this problem, we simply move the Hash value of the enum to a
      separate class method. This method is defined in a separate module where
      necessary, allowing us to use it like so:
      
          enum :failure_reasons, ::SomeModelEnums.failure_reasons
      
      The method in turn is defined in a very straightforward manner:
      
          module SomeModelEnums
            def self.failure_reasons
              {
                ...
              }
            end
          end
      
      This makes it easy for EE to add values without requiring the `prepend`
      to be placed before the `enum` is defined.
      
      For more information, see the following issues and merge requests:
      
      * https://gitlab.com/gitlab-org/gitlab-ee/issues/8244
      * https://gitlab.com/gitlab-org/gitlab-ee/issues/8241
      * https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/8424
      590ff80f