motiro 0.6.3

data/app/models/event.rb

@@ -0,0 +1,18 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+class Event < Page; end

data/app/models/headline.rb

@@ -0,0 +1,109 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+class Headline < ActiveRecord::Base
+  
+  has_many :changes, :dependent => :destroy
+  
+  def initialize(params={})
+    params[:description] ||= ''
+    if !params[:title].nil? then
+      params[:description] = params[:title] + "\n\n" + params[:description]
+      params.delete :title
+    end
+    super(params)
+  end
+  
+  def self.latest(num, reporter)
+    find(:all,
+         :conditions => ["reported_by = ?", reporter],
+         :order => 'happened_at DESC',
+         :limit => num)
+  end
+  
+  def self.latest_filled_headline_rid_for(reporter)
+    hls = find(:all, :conditions => ["reported_by = ?", reporter],
+                     :order => 'happened_at DESC')
+    hls.each do |hl|
+      return hl.rid if hl.filled?
+    end
+    
+    nil
+  end
+  
+  def self.find_with_reporter_and_rid(reporter_name, rid)
+    find(:first,
+         :conditions => ["reported_by = ? and rid = ?",
+    reporter_name, rid])        
+  end
+  
+  def happened_at=(date_components)
+    if date_components.is_a? Time
+      self[:happened_at] = date_components
+    else
+      year, month, day, hour, min, sec = date_components
+      self[:happened_at] = Time.local(year, month, day, hour, min, sec)
+    end
+  end
+  
+  def title(translator=Translator.default)
+    answer = description(translator).
+               split($/).
+               first || ''
+    answer.strip
+  end
+  
+  def description(translator=Translator.default)
+    translator.localize(self[:description])
+  end
+  
+  # Saves the headline locally, if it isn't already cached
+  def cache
+    unless self.cached?
+      self.class.destroy_all similar_to_self
+      self.save
+    end
+  end
+  
+  def cached?
+    cached_lines = Headline.find(:all, :conditions => similar_to_self)
+    
+    return false if cached_lines.empty?
+    
+    cached_lines.each do |hl| 
+      return true if hl.filled?
+    end
+    
+    return false
+  end
+  
+  def filled?
+    self.changes.each do |c|
+      return false if !c.filled?
+    end
+    
+    return true
+  end
+  
+private
+  
+  def similar_to_self
+    ["author = ? and description = ? and happened_at =?",
+     self[:author], self[:description], self[:happened_at]]
+  end
+
+end

data/app/models/page.rb

@@ -0,0 +1,114 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+PLACE_HOLDER_TITLE = 'Insert page title here'
+
+class Page < ActiveRecord::Base
+
+  belongs_to :last_editor, :class_name => 'User',
+                           :foreign_key => 'last_editor_id'
+  belongs_to :original_author, :class_name => 'User',
+                               :foreign_key => 'original_author_id'
+  
+  def after_initialize
+    default('', :editors, :text, :name, :title)
+    default('common', :kind)
+  end
+  
+  def default(value, *attrs)
+    attrs.each do |attr|
+      cur = send(attr)
+      send("#{attr}=".to_sym, value) if cur.nil? || cur.empty?
+    end
+  end
+  
+  def before_save
+    if title == PLACE_HOLDER_TITLE.t
+      write_attribute(:title, title_from_kind)  
+    end
+    
+    write_attribute(:name, self.name)
+  end
+  
+  def name; name_before_type_cast; end
+  def name_before_type_cast
+    result = read_attribute(:name)
+    return name_from_title if result.nil? || result.empty?
+    return result
+  end
+  
+  def title; title_before_type_cast; end
+  def title_before_type_cast
+    result = read_attribute(:title)
+    return title_from_name || PLACE_HOLDER_TITLE.t if result.nil? || result.empty?
+    return result
+  end
+  
+  def use_parser(parser)
+    @parser = parser
+  end
+  
+  def is_open_to_all?
+    0 == editors.strip.size
+  end
+  
+private
+  
+  def name_from_title
+    sequence(drop_non_alpha(clean(title)).downcase.gsub(/ /, '_').camelize, 'name')
+  end
+  
+  def title_from_kind
+    sequence(kind.capitalize + ' page ', 'title')
+  end
+  
+  def title_from_name
+    name = read_attribute(:name)
+    name = nil if name.nil? || name.empty?
+    name && name.underscore.gsub(/_/, ' ').capitalize
+  end
+  
+  def sequence(target, attr)
+    result = target.strip
+    suffix = 2
+    while self.class.find(:first, :conditions => "#{attr} = '#{result}'")
+      result = target + suffix.to_s
+      suffix += 1
+    end
+    return result    
+  end
+  
+  def renderer
+    @renderer ||= WikiRenderer.new
+  end
+  
+  def my_parser
+    @parser ||= WikiParser.new
+  end
+  
+private
+
+  def clean(text)
+    text.tr('ãàáâäÃÀÁÂÄèéêëÈÉÊËĩìíîïĨÌÍÎÏÿýÝŸõòóôöÕÒÓÔÖũùúûüŨÙÚÛÜñńÑŃćçÇĆśŕ埌ŔĹŹ',
+            'aaaaaAAAAAeeeeEEEEiiiiiIIIIIyyYYoooooOOOOOuuuuuUUUUUnnNNccCCsrlzSRLZ')
+  end
+  
+  def drop_non_alpha(text)
+    text.gsub(%r{[^a-zA-Z0-9]}, ' ').gsub(%r{\s+}, ' ')
+  end
+  
+end

data/app/models/page_sweeper.rb

@@ -0,0 +1,26 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+class PageSweeper < ActionController::Caching::Sweeper
+
+  observe Page
+  
+  def after_save(page)
+    expire_fragment(/wiki\/show.*?#{page.name}/)
+  end
+
+end

data/app/models/user.rb

@@ -0,0 +1,85 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'digest/sha1'
+
+# this model expects a certain database layout and its based on the name/login pattern. 
+class User < ActiveRecord::Base
+
+  # Please change the salt to something else, 
+  # Every application should use a different one 
+  @@salt = 'motiro'
+  cattr_accessor :salt
+
+  # Authenticate a user. 
+  #
+  # Example:
+  #   @user = User.authenticate('bob', 'bobpass')
+  #
+  def self.authenticate(login, pass)
+    find(:first, :conditions => ["login = ? AND password = ?", login, sha1(pass)])
+  end  
+  
+  def can_edit?(page)
+    self == page.original_author ||
+    page.is_open_to_all? ||
+    page.editors.split.include?(login)
+  end
+  
+  def can_change_editors?(page)
+    page.original_author.nil? || self == page.original_author
+  end
+  
+protected
+
+  # Apply SHA1 encryption to the supplied password. 
+  # We will additionally surround the password with a salt 
+  # for additional security. 
+  def self.sha1(pass)
+    Digest::SHA1.hexdigest("#{salt}--#{pass}--")
+  end
+    
+  before_create :crypt_password
+  
+  # Before saving the record to database we will crypt the password 
+  # using SHA1. 
+  # We never store the actual password in the DB.
+  def crypt_password
+    write_attribute "password", self.class.sha1(password)
+  end
+  
+  before_update :crypt_unless_empty
+  
+  # If the record is updated we will check if the password is empty.
+  # If its empty we assume that the user didn't want to change his
+  # password and just reset it to the old value.
+  def crypt_unless_empty
+    if password.empty?      
+      user = self.class.find(self.id)
+      self.password = user.password
+    else
+      write_attribute "password", self.class.sha1(password)
+    end        
+  end
+  
+  validates_uniqueness_of :login, :on => :create
+
+  validates_confirmation_of :password, :on => :create
+  validates_length_of :login, :within => 3..40
+  validates_length_of :password, :within => 5..40
+  validates_presence_of :login, :password, :password_confirmation
+end

data/app/ports/chdir_runner.rb

@@ -0,0 +1,36 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'ports/runner'
+
+class ChdirRunner
+
+  def initialize(dir, runner=Runner.new)
+    @dir, @runner = dir, runner
+  end
+  
+  def run(command, input='', env={})
+    prevdir = Dir.pwd
+    begin
+      Dir.chdir(@dir)
+      @runner.run(command, input, env)
+    ensure
+      Dir.chdir(prevdir)
+    end
+  end
+
+end

data/app/ports/reporter_loader.rb

@@ -0,0 +1,9 @@
+# Loads a reporter from the local filesystem
+class ReporterLoader
+
+  def create_reporter(reporter_id)
+    require "reporters/#{reporter_id}_reporter"
+    eval "#{reporter_id.camelize}Reporter.new"
+  end
+
+end

data/app/ports/runner.rb

@@ -0,0 +1,64 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+class Runner
+
+  def initialize(process_creator=IO)
+    @creator = process_creator
+  end
+  
+  def run(command, input='', env={})
+    commons = {}
+    env.each_key do |k|
+      commons[k] = ENV[k] if ENV.has_key?(k)
+    end
+    ENV.update env
+
+    process = @creator.popen(command, 'r+')
+    begin
+      process << input
+      process.flush
+    rescue
+      #ignore i/o errors
+    end
+
+    env.each_key do |k|
+      ENV.delete k
+    end
+    commons.each do |k, v|
+      ENV[k] = v
+    end
+
+    result = process.read
+    process.close
+    
+    return result    
+  end
+
+end
+
+class FixedParameterRunner
+  
+  def initialize(underlying_runner, input, env)
+    @runner, @input, @env = underlying_runner, input, env
+  end
+  
+  def run(command)
+    @runner.run(command, @input, @env)
+  end
+  
+end

data/app/reporters/darcs_connection.rb

@@ -0,0 +1,54 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'stringio'
+
+require 'ports/runner'
+require 'ports/chdir_runner'
+
+require 'reporters/darcs_settings'
+require 'reporters/darcs_temp_repo'
+
+class DarcsConnection
+
+  def initialize(settings=DarcsSettingsProvider.new,
+                 runner=Runner.new,
+                 temp_repo = DarcsTempRepo.new)
+    @settings = settings
+    @runner = ChdirRunner.new(temp_repo.path, runner)
+  end
+  
+  def changes(options=nil)
+    command = 'darcs changes --xml'
+    if options.nil?
+      command += " --last=#{@settings.package_size}"
+    elsif :all != options
+      command += " --from-match=\"hash #{options}\"" +
+                 " --to-match=\"hash #{options}\""
+    end
+    @runner.run(command)
+  end
+  
+  def pull
+    @runner.run("darcs pull -a #{@settings.repo_url}")
+  end
+  
+  def diff(patch_hash)
+    @runner.run("darcs diff -u --match \"hash #{patch_hash}\"")
+  end
+
+end

data/app/reporters/darcs_reporter.rb

@@ -0,0 +1,104 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'rexml/rexml'
+
+require 'models/headline'
+require 'core/reporter'
+require 'reporters/darcs_connection'
+
+class DarcsReporter < MotiroReporter
+
+  def initialize(conn=DarcsConnection.new)
+    @connection = conn
+  end
+  
+  def latest_headlines
+    @connection.pull
+    parse_headlines(@connection.changes)
+  end
+  
+  def headlines
+    parse_headlines(@connection.changes(:all))
+  end
+  
+  def headline(rid)
+    parse_headlines(@connection.changes(rid)).first
+  end
+  
+  def author_from_darcs_id(id)
+    md = id.match(/@/)
+    return md.pre_match if md
+  end
+  
+  def time_from_darcs_date(date)
+    md = date.match(/(\d\d\d\d)(\d\d)(\d\d)(\d\d)(\d\d)(\d\d)/)
+    nums = md[1..6].collect do |s| s.to_i end
+    Time.utc(nums[0], nums[1], nums[2], nums[3], nums[4], nums[5], nums[6])
+  end
+  
+private
+
+  def parse_headlines(xml_input)
+    patches = REXML::Document.new(xml_input).root.elements || []
+    patches.collect do |patch_info|
+      parse_headline(patch_info)
+    end
+  end
+  
+  def parse_headline(info)
+    headline = Headline.new
+    headline.author = author_from_darcs_id(info.attributes['author'])
+
+    name = info.elements['name'].text
+    comments = info.elements['comment']
+    description = if name.strip.empty? then 'Untitled patch'; else name; end
+    description += "\n" + comments.text if comments
+    
+    headline.description = description
+    headline.happened_at = time_from_darcs_date(info.attributes['date'])
+    headline.rid =  info.attributes['hash']
+    headline.reported_by = self.name
+    
+    parse_changes(headline, @connection.diff(headline.rid))
+    
+    return headline
+  end
+  
+  def parse_changes(headline, diffs)
+    remain = diffs
+    
+    while(md = remain.match(/^diff[^\n]*\n--- old-[^\/]*\/([^\t]*)/))
+      remain, diff = extract_diff(md.post_match)
+      headline.changes.push Change.new(:summary => md[1],
+                                       :diff => diff)
+    end
+  end
+  
+  def extract_diff(text)
+    md = text.match(/^\+\+\+ [^\n]*\n/)
+
+    remain, diff = '', md.post_match
+    
+    if (md = diff.match(/^diff/))
+      remain, diff = md[0] + md.post_match, md.pre_match
+    end
+    
+    return remain, diff
+  end
+
+end

data/app/reporters/darcs_settings.rb

@@ -0,0 +1,9 @@
+require 'core/settings'
+
+class DarcsSettingsProvider < SettingsProvider
+    
+  def repo_url
+    load_confs['darcs']['repo']
+  end
+    
+end

data/app/reporters/darcs_temp_repo.rb

@@ -0,0 +1,40 @@
+#  Motiro - A project tracking tool
+#  Copyright (C) 2006-2007  Thiago Arrais
+#  
+#  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
+#  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 St, Fifth Floor, Boston, MA  02110-1301  USA
+
+require 'fileutils'
+require 'ports/chdir_runner'
+
+# This class is part of a workaround for darcs bug #250
+# Darcs somehow needs to have a local repo to retrieve the changelog from a
+# repo behind an HTTP server
+# 
+# For more details see http://bugs.darcs.net/issue250
+class DarcsTempRepo
+
+  @@path = File.expand_path(__FILE__ + '../../../../tmp/tmprepo')
+
+  def initialize(filesystem=File, fileutils=FileUtils,
+                 runner=ChdirRunner.new(@@path))
+    unless filesystem.exists?(path + '/_darcs')
+      fileutils.mkdir_p(path)
+      runner.run("darcs init")
+    end
+  end
+
+  def path; @@path; end
+
+end