Chris@0: # Redmine - project management software
Chris@0: # Copyright (C) 2006-2008  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@0: # 
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@0: # 
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: module Redmine
Chris@0:   module Activity
Chris@0:     # Class used to retrieve activity events
Chris@0:     class Fetcher
Chris@0:       attr_reader :user, :project, :scope
Chris@0:       
Chris@0:       # Needs to be unloaded in development mode
Chris@0:       @@constantized_providers = Hash.new {|h,k| h[k] = Redmine::Activity.providers[k].collect {|t| t.constantize } }
Chris@0:       
Chris@0:       def initialize(user, options={})
Chris@0:         options.assert_valid_keys(:project, :with_subprojects, :author)
Chris@0:         @user = user
Chris@0:         @project = options[:project]
Chris@0:         @options = options
Chris@0:         
Chris@0:         @scope = event_types
Chris@0:       end
Chris@0:       
Chris@0:       # Returns an array of available event types
Chris@0:       def event_types
Chris@0:         return @event_types unless @event_types.nil?
Chris@0:         
Chris@0:         @event_types = Redmine::Activity.available_event_types
Chris@0:         @event_types = @event_types.select {|o| @project.self_and_descendants.detect {|p| @user.allowed_to?("view_#{o}".to_sym, p)}} if @project
Chris@0:         @event_types
Chris@0:       end
Chris@0:       
Chris@0:       # Yields to filter the activity scope
Chris@0:       def scope_select(&block)
Chris@0:         @scope = @scope.select {|t| yield t }
Chris@0:       end
Chris@0:       
Chris@0:       # Sets the scope
Chris@0:       # Argument can be :all, :default or an array of event types
Chris@0:       def scope=(s)
Chris@0:         case s
Chris@0:         when :all
Chris@0:           @scope = event_types
Chris@0:         when :default
Chris@0:           default_scope!
Chris@0:         else
Chris@0:           @scope = s & event_types
Chris@0:         end
Chris@0:       end
Chris@0:       
Chris@0:       # Resets the scope to the default scope
Chris@0:       def default_scope!
Chris@0:         @scope = Redmine::Activity.default_event_types
Chris@0:       end
Chris@0:       
Chris@0:       # Returns an array of events for the given date range
Chris@0:       # sorted in reverse chronological order
Chris@0:       def events(from = nil, to = nil, options={})
Chris@0:         e = []
Chris@0:         @options[:limit] = options[:limit]
Chris@0:         
Chris@0:         @scope.each do |event_type|
Chris@0:           constantized_providers(event_type).each do |provider|
Chris@0:             e += provider.find_events(event_type, @user, from, to, @options)
Chris@0:           end
Chris@0:         end
Chris@0:         
Chris@0:         e.sort! {|a,b| b.event_datetime <=> a.event_datetime}
Chris@0:         
Chris@0:         if options[:limit]
Chris@0:           e = e.slice(0, options[:limit])
Chris@0:         end
Chris@0:         e
Chris@0:       end
Chris@0:       
Chris@0:       private
Chris@0:       
Chris@0:       def constantized_providers(event_type)
Chris@0:         @@constantized_providers[event_type]
Chris@0:       end
Chris@0:     end
Chris@0:   end
Chris@0: end