openproject/modules/github_integration/app/models/github_pull_request.rb

#-- encoding: UTF-8

#-- copyright
# OpenProject is an open source project management software.
# Copyright (C) 2012-2021 the OpenProject GmbH
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
# Copyright (C) 2006-2013 Jean-Philippe Lang
# Copyright (C) 2010-2013 the ChiliProject Team
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
#
# See docs/COPYRIGHT.rdoc for more details.
#++

class GithubPullRequest < ApplicationRecord
  LABEL_KEYS = %w[color name].freeze

  has_and_belongs_to_many :work_packages
  has_many :github_check_runs, dependent: :destroy
  belongs_to :github_user, optional: true
  belongs_to :merged_by, optional: true, class_name: 'GithubUser'

  enum state: {
    open: 'open',
    closed: 'closed'
  }

  validates_presence_of :github_html_url,
                        :number,
                        :repository,
                        :state,
                        :title,
                        :github_updated_at
  validates_presence_of :body,
                        :comments_count,
                        :review_comments_count,
                        :additions_count,
                        :deletions_count,
                        :changed_files_count,
                        unless: :partial?
  validate :validate_labels_schema

  scope :without_work_package, -> { left_outer_joins(:work_packages).where(work_packages: { id: nil }) }
  scope :partial, -> {
    where(body: nil,
          comments_count: nil,
          review_comments_count: nil,
          additions_count: nil,
          deletions_count: nil,
          changed_files_count: nil)
  }

  ##
  # When a PR lives long enough and receives many pushes, the same check (say, a CI test run) can be run multiple times.
  # This method only returns the latest of each type of check_run.
  def latest_check_runs
    github_check_runs.select("DISTINCT ON (github_check_runs.app_id, github_check_runs.name) *")
                     .order(app_id: :asc, name: :asc, started_at: :desc)
  end

  def partial?
    [body, comments_count, review_comments_count, additions_count, deletions_count, changed_files_count].all?(&:nil?)
  end

  private

  def validate_labels_schema
    return if labels.nil?
    return if labels.all? { |label| label.keys.sort == LABEL_KEYS }

    errors.add(:labels, 'invalid schema')
  end
end