Chris@0: # Redmine - project management software
Chris@1494: # Copyright (C) 2006-2014  Jean-Philippe Lang
Chris@0: #
Chris@0: # This program is free software; you can redistribute it and/or
Chris@0: # modify it under the terms of the GNU General Public License
Chris@0: # as published by the Free Software Foundation; either version 2
Chris@0: # of the License, or (at your option) any later version.
Chris@441: #
Chris@0: # This program is distributed in the hope that it will be useful,
Chris@0: # but WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@0: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Chris@0: # GNU General Public License for more details.
Chris@441: #
Chris@0: # You should have received a copy of the GNU General Public License
Chris@0: # along with this program; if not, write to the Free Software
Chris@0: # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
Chris@0: 
Chris@0: class Changeset < ActiveRecord::Base
Chris@0:   belongs_to :repository
Chris@0:   belongs_to :user
Chris@1115:   has_many :filechanges, :class_name => 'Change', :dependent => :delete_all
Chris@0:   has_and_belongs_to_many :issues
Chris@909:   has_and_belongs_to_many :parents,
Chris@909:                           :class_name => "Changeset",
Chris@909:                           :join_table => "#{table_name_prefix}changeset_parents#{table_name_suffix}",
Chris@909:                           :association_foreign_key => 'parent_id', :foreign_key => 'changeset_id'
Chris@909:   has_and_belongs_to_many :children,
Chris@909:                           :class_name => "Changeset",
Chris@909:                           :join_table => "#{table_name_prefix}changeset_parents#{table_name_suffix}",
Chris@909:                           :association_foreign_key => 'changeset_id', :foreign_key => 'parent_id'
Chris@0: 
Chris@1115:   acts_as_event :title => Proc.new {|o| o.title},
Chris@0:                 :description => :long_comments,
Chris@0:                 :datetime => :committed_on,
Chris@1115:                 :url => Proc.new {|o| {:controller => 'repositories', :action => 'revision', :id => o.repository.project, :repository_id => o.repository.identifier_param, :rev => o.identifier}}
Chris@441: 
Chris@0:   acts_as_searchable :columns => 'comments',
Chris@0:                      :include => {:repository => :project},
Chris@0:                      :project_key => "#{Repository.table_name}.project_id",
Chris@0:                      :date_column => 'committed_on'
Chris@441: 
Chris@0:   acts_as_activity_provider :timestamp => "#{table_name}.committed_on",
Chris@0:                             :author_key => :user_id,
Chris@0:                             :find_options => {:include => [:user, {:repository => :project}]}
Chris@441: 
Chris@0:   validates_presence_of :repository_id, :revision, :committed_on, :commit_date
Chris@0:   validates_uniqueness_of :revision, :scope => :repository_id
Chris@0:   validates_uniqueness_of :scmid, :scope => :repository_id, :allow_nil => true
Chris@441: 
Chris@1464:   scope :visible, lambda {|*args|
Chris@1464:     includes(:repository => :project).where(Project.allowed_to_condition(args.shift || User.current, :view_changesets, *args))
Chris@1464:   }
Chris@441: 
Chris@909:   after_create :scan_for_issues
Chris@909:   before_create :before_create_cs
Chris@909: 
Chris@0:   def revision=(r)
Chris@0:     write_attribute :revision, (r.nil? ? nil : r.to_s)
Chris@0:   end
Chris@119: 
Chris@119:   # Returns the identifier of this changeset; depending on repository backends
Chris@119:   def identifier
Chris@119:     if repository.class.respond_to? :changeset_identifier
Chris@119:       repository.class.changeset_identifier self
Chris@119:     else
Chris@119:       revision.to_s
Chris@119:     end
Chris@119:   end
Chris@0: 
Chris@0:   def committed_on=(date)
Chris@0:     self.commit_date = date
Chris@0:     super
Chris@0:   end
Chris@119: 
Chris@119:   # Returns the readable identifier
Chris@119:   def format_identifier
Chris@119:     if repository.class.respond_to? :format_changeset_identifier
Chris@119:       repository.class.format_changeset_identifier self
Chris@119:     else
Chris@119:       identifier
Chris@119:     end
Chris@119:   end
Chris@441: 
Chris@0:   def project
Chris@0:     repository.project
Chris@0:   end
Chris@441: 
Chris@0:   def author
Chris@0:     user || committer.to_s.split('<').first
Chris@0:   end
Chris@441: 
Chris@909:   def before_create_cs
Chris@245:     self.committer = self.class.to_utf8(self.committer, repository.repo_log_encoding)
Chris@441:     self.comments  = self.class.normalize_comments(
Chris@441:                        self.comments, repository.repo_log_encoding)
Chris@245:     self.user = repository.find_committer_user(self.committer)
Chris@0:   end
Chris@245: 
Chris@909:   def scan_for_issues
Chris@0:     scan_comment_for_issue_ids
Chris@0:   end
Chris@441: 
Chris@119:   TIMELOG_RE = /
Chris@119:     (
Chris@245:     ((\d+)(h|hours?))((\d+)(m|min)?)?
Chris@245:     |
Chris@245:     ((\d+)(h|hours?|m|min))
Chris@119:     |
Chris@119:     (\d+):(\d+)
Chris@119:     |
Chris@245:     (\d+([\.,]\d+)?)h?
Chris@119:     )
Chris@119:     /x
Chris@441: 
Chris@0:   def scan_comment_for_issue_ids
Chris@0:     return if comments.blank?
Chris@0:     # keywords used to reference issues
Chris@0:     ref_keywords = Setting.commit_ref_keywords.downcase.split(",").collect(&:strip)
Chris@119:     ref_keywords_any = ref_keywords.delete('*')
Chris@0:     # keywords used to fix issues
Chris@1464:     fix_keywords = Setting.commit_update_keywords_array.map {|r| r['keywords']}.flatten.compact
Chris@441: 
Chris@0:     kw_regexp = (ref_keywords + fix_keywords).collect{|kw| Regexp.escape(kw)}.join("|")
Chris@441: 
Chris@0:     referenced_issues = []
Chris@441: 
Chris@119:     comments.scan(/([\s\(\[,-]|^)((#{kw_regexp})[\s:]+)?(#\d+(\s+@#{TIMELOG_RE})?([\s,;&]+#\d+(\s+@#{TIMELOG_RE})?)*)(?=[[:punct:]]|\s|<|$)/i) do |match|
Chris@1464:       action, refs = match[2].to_s.downcase, match[3]
Chris@119:       next unless action.present? || ref_keywords_any
Chris@441: 
Chris@119:       refs.scan(/#(\d+)(\s+@#{TIMELOG_RE})?/).each do |m|
Chris@119:         issue, hours = find_referenced_issue_by_id(m[0].to_i), m[2]
Chris@119:         if issue
Chris@119:           referenced_issues << issue
Chris@1464:           # Don't update issues or log time when importing old commits
Chris@1464:           unless repository.created_on && committed_on && committed_on < repository.created_on
Chris@1464:             fix_issue(issue, action) if fix_keywords.include?(action)
Chris@1464:             log_time(issue, hours) if hours && Setting.commit_logtime_enabled?
Chris@1464:           end
Chris@0:         end
Chris@0:       end
Chris@0:     end
Chris@441: 
Chris@0:     referenced_issues.uniq!
Chris@0:     self.issues = referenced_issues unless referenced_issues.empty?
Chris@0:   end
Chris@441: 
Chris@0:   def short_comments
Chris@0:     @short_comments || split_comments.first
Chris@0:   end
Chris@441: 
Chris@0:   def long_comments
Chris@0:     @long_comments || split_comments.last
Chris@0:   end
Chris@119: 
Chris@929:   def text_tag(ref_project=nil)
Chris@1494:     repo = ""
Chris@1494:     if repository && repository.identifier.present?
Chris@1494:       repo = "#{repository.identifier}|"
Chris@1494:     end
Chris@929:     tag = if scmid?
Chris@1494:       "commit:#{repo}#{scmid}"
Chris@119:     else
Chris@1494:       "#{repo}r#{revision}"
Chris@1115:     end
Chris@929:     if ref_project && project && ref_project != project
Chris@1115:       tag = "#{project.identifier}:#{tag}"
Chris@929:     end
Chris@929:     tag
Chris@119:   end
Chris@441: 
Chris@1115:   # Returns the title used for the changeset in the activity/search results
Chris@1115:   def title
Chris@1115:     repo = (repository && repository.identifier.present?) ? " (#{repository.identifier})" : ''
Chris@1115:     comm = short_comments.blank? ? '' : (': ' + short_comments)
Chris@1115:     "#{l(:label_revision)} #{format_identifier}#{repo}#{comm}"
Chris@1115:   end
Chris@1115: 
Chris@0:   # Returns the previous changeset
Chris@0:   def previous
Chris@1115:     @previous ||= Changeset.where(["id < ? AND repository_id = ?", id, repository_id]).order('id DESC').first
Chris@0:   end
Chris@0: 
Chris@0:   # Returns the next changeset
Chris@0:   def next
Chris@1115:     @next ||= Changeset.where(["id > ? AND repository_id = ?", id, repository_id]).order('id ASC').first
Chris@0:   end
Chris@441: 
Chris@0:   # Creates a new Change from it's common parameters
Chris@0:   def create_change(change)
Chris@441:     Change.create(:changeset     => self,
Chris@441:                   :action        => change[:action],
Chris@441:                   :path          => change[:path],
Chris@441:                   :from_path     => change[:from_path],
Chris@0:                   :from_revision => change[:from_revision])
Chris@0:   end
Chris@245: 
Chris@119:   # Finds an issue that can be referenced by the commit message
Chris@119:   def find_referenced_issue_by_id(id)
Chris@119:     return nil if id.blank?
Chris@1517:     issue = Issue.includes(:project).where(:id => id.to_i).first
Chris@1115:     if Setting.commit_cross_project_ref?
Chris@1115:       # all issues can be referenced/fixed
Chris@1115:     elsif issue
Chris@1115:       # issue that belong to the repository project, a subproject or a parent project only
Chris@441:       unless issue.project &&
Chris@441:                 (project == issue.project || project.is_ancestor_of?(issue.project) ||
Chris@441:                  project.is_descendant_of?(issue.project))
Chris@119:         issue = nil
Chris@119:       end
Chris@119:     end
Chris@119:     issue
Chris@119:   end
Chris@441: 
Chris@1115:   private
Chris@1115: 
Chris@1464:   # Updates the +issue+ according to +action+
Chris@1464:   def fix_issue(issue, action)
Chris@119:     # the issue may have been updated by the closure of another one (eg. duplicate)
Chris@119:     issue.reload
Chris@119:     # don't change the status is the issue is closed
Chris@119:     return if issue.status && issue.status.is_closed?
Chris@441: 
Chris@1464:     journal = issue.init_journal(user || User.anonymous,
Chris@1464:                                  ll(Setting.default_language,
Chris@1464:                                     :text_status_changed_by_changeset,
Chris@1464:                                     text_tag(issue.project)))
Chris@1464:     rule = Setting.commit_update_keywords_array.detect do |rule|
Chris@1464:       rule['keywords'].include?(action) &&
Chris@1464:         (rule['if_tracker_id'].blank? || rule['if_tracker_id'] == issue.tracker_id.to_s)
Chris@1464:     end
Chris@1464:     if rule
Chris@1464:       issue.assign_attributes rule.slice(*Issue.attribute_names)
Chris@119:     end
Chris@119:     Redmine::Hook.call_hook(:model_changeset_scan_commit_for_issue_ids_pre_issue_update,
Chris@1464:                             { :changeset => self, :issue => issue, :action => action })
Chris@119:     unless issue.save
Chris@119:       logger.warn("Issue ##{issue.id} could not be saved by changeset #{id}: #{issue.errors.full_messages}") if logger
Chris@119:     end
Chris@119:     issue
Chris@119:   end
Chris@441: 
Chris@119:   def log_time(issue, hours)
Chris@119:     time_entry = TimeEntry.new(
Chris@119:       :user => user,
Chris@119:       :hours => hours,
Chris@119:       :issue => issue,
Chris@119:       :spent_on => commit_date,
Chris@929:       :comments => l(:text_time_logged_by_changeset, :value => text_tag(issue.project),
Chris@441:                      :locale => Setting.default_language)
Chris@119:       )
Chris@119:     time_entry.activity = log_time_activity unless log_time_activity.nil?
Chris@441: 
Chris@119:     unless time_entry.save
Chris@119:       logger.warn("TimeEntry could not be created by changeset #{id}: #{time_entry.errors.full_messages}") if logger
Chris@119:     end
Chris@119:     time_entry
Chris@119:   end
Chris@441: 
Chris@119:   def log_time_activity
Chris@119:     if Setting.commit_logtime_activity_id.to_i > 0
Chris@119:       TimeEntryActivity.find_by_id(Setting.commit_logtime_activity_id.to_i)
Chris@119:     end
Chris@0:   end
Chris@441: 
Chris@0:   def split_comments
Chris@0:     comments =~ /\A(.+?)\r?\n(.*)$/m
Chris@0:     @short_comments = $1 || comments
Chris@0:     @long_comments = $2.to_s.strip
Chris@0:     return @short_comments, @long_comments
Chris@0:   end
Chris@0: 
Chris@245:   public
Chris@119: 
Chris@245:   # Strips and reencodes a commit log before insertion into the database
Chris@245:   def self.normalize_comments(str, encoding)
Chris@245:     Changeset.to_utf8(str.to_s.strip, encoding)
Chris@245:   end
Chris@245: 
Chris@245:   def self.to_utf8(str, encoding)
Chris@909:     Redmine::CodesetUtil.to_utf8(str, encoding)
Chris@0:   end
Chris@0: end