backlog 0.7.7 → 0.7.8

data/History.txt

@@ -1,8 +1,17 @@
+== 0.7.8 2007-08-25
+
+* Changed use of RMagick to be optional.  Everything except the graphs should work if rmagick is not installed.  rmagick is still a dependency for the gem, but you can force installation og the backlog gem without rmagick ot gruff with the --ignore-dependencies flag.  You still need the postgres gem.
+* Changed documentation to mention GraphicsMagic as an alternative to ImageMagick
+* Added more documentation of the charts.
+* Added explanation on how to install Backlog without ImageMagick, GraphicsMagick and RMagick.
+* Made change password view a bit prettier.
+* Added link to project home to top of layout.
+
 == 0.7.7 2007-08-24
 
 * Added link to backlog from work record in weekly work sheet
-* Added ImageMagick and PostgreSQL as requireements in the GEM
-* Removed shortcuts from login and signup views.
+* Added ImageMagick and PostgreSQL as requirements in the GEM
+* Removed shortcuts from login and sign up views.
 * Removed link to backlog list of not logged in.
 * Localized some user messages.
 * Focus on login field in login view.
@@ -10,7 +19,7 @@
 
 == 0.7.6 2007-08-22
 
-* Changed Task edit view to use Ajax to update the Period link to make it more sponsive when moving a task between periods.
+* Changed Task edit view to use Ajax to update the Period link to make it more responsive when moving a task between periods.
 * Changed the LARGE chart size from 1440x900 to 1368x768 for display on our large screen TV
 * Fixed bug for displaying burn down chart for groups that have no active period.
 * Made 404 error page a bit bit nicer.
@@ -36,7 +45,7 @@
 == 0.7.3 2007-08-17
 
 * Fixed bug in estimate creation
-* Added cruisecontrol.rb config file
+* Added cruisecontrol.rb configuration file
 * Fixed mailing of password
 * Fixed find_by for class table inheritance subclasses
 * Fixed date limits for new periods
@@ -141,16 +150,16 @@
 
 == 0.5.0 2007-08-06
 
-* Changed first time workflow to add new backlog
-* Changed startup workflow to show most urgent period for the current user
+* Changed first time work flow to add new backlog
+* Changed startup work flow to show most urgent period for the current user
 * Now display version in the header.
 
 == 0.4.0 2007-08-06
 
 * Added tasks to backlog edit view
 * Started simplifying task ordering.  Now ordering simply has period_id as scope.
-* Improved and fixed bugs in workflow
-* Fixed typos in stylesheet
+* Improved and fixed bugs in work flow
+* Fixed typos in style sheet
 * KNOWN BUG: Ordering for tasks in backlog does not work properly
 
 == 0.3.9 2007-08-03
@@ -196,17 +205,17 @@
 
 == 0.3.0 2007-08-02
 
-* Improved workflow
+* Improved work flow
 * Added task list to backlog edit view
 
 == 0.2.1 2007-07-31
 
-* Improved workflow
+* Improved work flow
 * Added more shortcut links
 
 == 0.2.0 2007-07-31
 
-* Improved workflow
+* Improved work flow
 
 == 0.1.2 2007-07-29
 

data/README.txt

@@ -16,7 +16,7 @@ A timekeeping module is also included to track time spent on the different tasks
 * Install ruby
 * Install RubyGems
 * Install PostgreSQL
-* Install ImageMagick
+* Install ImageMagick or GraphicsMagick
 * run <tt>sudo gem install backlog -y</tt>
 * run <tt>sudo backlog setup_unix</tt>
 * run <tt>sudo backlog start</tt>
@@ -39,9 +39,41 @@ port: 3000
 
 === Charts
 
-You can get a large version of the burn down charts by appending "_large" to the URL.
+The charts in Backlog are made using Gruff (http://nubyonrails.com/pages/gruff).
+Gruff uses RMagick (http://rmagick.rubyforge.org/) for image generation.
+RMagick uses ImageMagic (http://www.imagemagick.org/script/download.php)
+or GraphicsMagic (http://www.graphicsmagick.org/www/download.html).
+On some platforms ImageMagick and GraphicsMagick are either not available, or difficult to install.
+In that case, RMagick will fail to install, causing the Backlog gem to fail to install.
+To bypass this, you can install the Backlog gem using the --ignore-dependencies flag.
+Backlog will still work without RMagick, but charts will not be available.
+
+
+==== Links to charts
+
+You can display the charts directly using links like the ones below.
+The charts are normally not protected, so you can display the in slideshows etc. without having to log in.
+
+Examples:
+
+http://backlog.kubosch.no/periods/burn_down_chart/55.png
+http://backlog.kubosch.no/parties/burn_down_chart/14.png
+
+==== Chart thumbnails
+
+You can get small versions of the burn down charts by appending "_thumbnail" to the URL.
+
+Examples:
+
+http://backlog.kubosch.no/periods/burn_down_chart_thumbnail/55.png
+http://backlog.kubosch.no/parties/burn_down_chart_thumbnail/14.png
+
+==== Large charts
+
+You can get large versions (1368x768) of the burn down charts by appending "_large" to the URL.
 
 Examples:
 
 http://backlog.kubosch.no/periods/burn_down_chart_large/55.png
 http://backlog.kubosch.no/parties/burn_down_chart_large/14.png
+

data/Rakefile

@@ -21,20 +21,21 @@ Hoe.new("backlog", APP::VERSION) do |p|
   p.remote_rdoc_dir = '' # Release to root
   p.changes = p.paragraphs_of('History.txt', 0..-1).join("\n\n")
   p.rdoc_pattern = /^(app\/(controllers|helpers|models)|lib|bin)|txt$/
+  p.clean_globs = ['^doc']
   p.spec_extras = {
     :files => Dir['**/*'].reject{|file_name| file_name =~ /^(log|pkg|tmp)/},
     :rdoc_options => ['--inline-source'],
     :executables => ['backlog'],
-    :requirements => ['ImageMagick', 'PostgreSQL']
+    :requirements => ['ImageMagick or GraphicsMagick', 'PostgreSQL']
   }
   p.need_zip = true
   p.url = 'http://rubyforge.org/projects/backlog/'
   p.extra_deps = [['gruff', '>= 0.2.8'], ['rmagick', '>= 1.15.9'], ['postgres', '>= 0.7.1']]
 end
 
-task :release_and_publish do
+task :release_all do
   ENV['VERSION'] = APP::VERSION
   Rake::Task[:release].invoke
-  Rake::Task[:publish_docs].invoke
+#  Rake::Task[:publish_docs].invoke
   Rake::Task[:post_news].invoke
 end

data/app/controllers/parties_controller.rb

@@ -20,7 +20,7 @@ class PartiesController < ApplicationController
     party = Party.find(params[:id])
     if period = party.periods.select{|p| p.active?}.first || party.periods.last 
       g = period.burn_down_graph(size)
-      send_data(g.to_blob,
+      send_data(g,
                 :disposition => 'inline', 
       :type => 'image/png', 
       :filename => "burn_down_chart.png")

data/app/controllers/periods_controller.rb

@@ -103,7 +103,7 @@ class PeriodsController < ApplicationController
     @works = Work.find_by_sql("SELECT w.* FROM works w LEFT OUTER JOIN tasks t ON t.id = w.task_id WHERE t.period_id = #{@period.id} ORDER BY w.completed_at")
     render :template => '/works/list'
   end
-  
+
   def make_link
     if params[:id].to_i > 0
       render :partial => 'link', :layout => false, :locals => {:period => Period.find(params[:id])}
@@ -116,11 +116,8 @@ class PeriodsController < ApplicationController
   
   def send_burn_down_chart(size)
     period = Period.find(params[:id])
-    g = period.burn_down_graph(size)    
-    send_data(g.to_blob,
-              :disposition => 'inline', 
-    :type => 'image/png', 
-    :filename => "burn_down_chart.png")
+    g = period.burn_down_graph(size)
+    send_data(g, :disposition => 'inline', :type => 'image/png', :filename => "burn_down_chart.png")
   end
   
 end

data/app/models/period.rb

@@ -90,7 +90,7 @@ class Period < ActiveRecord::Base
   
   def dates
     all_dates = []
-    (start_on-1).upto(end_on) {|date| all_dates << date}
+     (start_on-1).upto(end_on) {|date| all_dates << date}
     return all_dates
   end
   
@@ -99,9 +99,9 @@ class Period < ActiveRecord::Base
     if start_on > Date.today
       dates << (start_on-1)
     elsif end_on < Date.today
-      (start_on-1).upto(end_on) {|date| dates << date}
+     (start_on-1).upto(end_on) {|date| dates << date}
     else
-      (start_on-1).upto(Date.today) {|date| dates << date}
+     (start_on-1).upto(Date.today) {|date| dates << date}
     end  
     return dates
   end
@@ -161,6 +161,13 @@ class Period < ActiveRecord::Base
   end
   
   def burn_down_graph(size)
+    begin
+      require 'gruff'
+      rescue MissingSourceFile => e
+      return File.read("public/images/rmagick_#{size}.gif") if File.exists? "public/images/rmagick_#{size}.gif"
+      return File.read("public/images/rmagick.gif")
+    end
+    
     g = Gruff::Line.new(size)
     g.theme_37signals
     g.title = l(:burn_down_chart) + " " + name
@@ -204,7 +211,7 @@ class Period < ActiveRecord::Base
     # g.draw_vertical_legend
     
     g.maximum_value = (g.maximum_value.to_s[0..0].to_i + 1) * (10**Math::log10(g.maximum_value.to_i).to_i) if g.maximum_value > 0
-    g
+    g.to_blob
   end
   
   def get_todo_data(dates, actual=false)

data/app/views/layouts/_left_top.rhtml

@@ -1,5 +1,5 @@
     <div id="navbar">
-      <span style="float: left"><%=l :backlog%> <%=APP::VERSION%></span>
+      <span style="float: left"><%=link_to "#{l :backlog} #{APP::VERSION}", 'http://rubyforge.org/projects/backlog'%></span>
       <%= flash[:notice] + ' |' if flash[:notice] %>
       <%= link_to l(:home), '/' %>
       

data/app/views/user/change_password.rhtml

@@ -1,5 +1,7 @@
+<% @page_title = l(:change_password) %>
+
+<div id="spotlight">
 <div title="<%= title_helper %>" class="form">
-  <%= head_helper 'Change Password', :error => true %>
 
   <div class="form-padding">
     Enter your new password in the fields below and click 'Change Password' to have a new password sent to your email inbox.
@@ -12,4 +14,5 @@
       </div>
     </form>
   </div>
+</div>
 </div>

data/config/environment.rb

@@ -56,7 +56,6 @@ require 'environments/localization_environment'
 require 'localization'
 Localization::load_localized_strings
 require 'rubygems'
-require 'gruff'
 
 require 'environments/user_environment'
 require 'array_helper'

data/test/functional/parties_controller_test.rb

@@ -11,7 +11,6 @@ class PartiesControllerTest < Test::Unit::TestCase
     @response   = ActionController::TestResponse.new
   end
 
-  # Replace this with your real tests.
   def test_burn_down_chart
     get :burn_down_chart, :id => 1
   end

data/test/functional/periods_controller_test.rb

@@ -82,4 +82,9 @@ class PeriodsControllerTest < Test::Unit::TestCase
       Period.find(1)
     }
   end
+
+  def test_burn_down_chart
+    get :burn_down_chart, :id => 1
+  end
+
 end

data/test/unit/period_test.rb

@@ -3,8 +3,7 @@ require File.dirname(__FILE__) + '/../test_helper'
 class PeriodTest < Test::Unit::TestCase
   fixtures :periods, :tasks, :estimates, :works
 
-  # Replace this with your real tests.
-  def test_truth
-    assert true
+  def test_burn_down_graph
+    image = periods(:past).burn_down_graph(Chart::THUMBNAIL)
   end
 end

metadata

@@ -3,15 +3,15 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: backlog
 version: !ruby/object:Gem::Version 
-  version: 0.7.7
-date: 2007-08-24 00:00:00 +02:00
+  version: 0.7.8
+date: 2007-08-25 00:00:00 +02:00
 summary: Application to aid collecting, processing, organizing, reviewing and doing tasks.
 require_paths: 
 - lib
 email: uwe@kubosch.no
 homepage: http://rubyforge.org/projects/backlog/
 rubyforge_project: backlog
-description: "== Backlog  Welcome to Backlog!  Backlog is a tool to help you collect and organize all your tasks, wether you are a single persion or a small or large group.  A timekeeping module is also included to track time spent on the different tasks.  === Backlog is not meant to be  * an issue tracker with customer communication.  === Installation  * Install ruby * Install RubyGems * Install PostgreSQL * Install ImageMagick * run <tt>sudo gem install backlog -y</tt> * run <tt>sudo backlog setup_unix</tt> * run <tt>sudo backlog start</tt>  === Updates  * run <tt>sudo gem update -y</tt> * run <tt>sudo backlog setup_unix</tt> * run <tt>sudo backlog restart</tt>  === Configuration  You can set configuration parameters for backlog using the /etc/backlog.conf file. The format is YAML. Currently only port number is settable.  Example:  port: 3000  === Charts  You can get a large version of the burn down charts by appending \"_large\" to the URL.  Examples:  http://backlog.kubosch.no/periods/burn_down_chart_large/55.png http://backlog.kubosch.no/parties/burn_down_chart_large/14.png"
+description: "== Backlog  Welcome to Backlog!  Backlog is a tool to help you collect and organize all your tasks, wether you are a single persion or a small or large group.  A timekeeping module is also included to track time spent on the different tasks.  === Backlog is not meant to be  * an issue tracker with customer communication.  === Installation  * Install ruby * Install RubyGems * Install PostgreSQL * Install ImageMagick or GraphicsMagick * run <tt>sudo gem install backlog -y</tt> * run <tt>sudo backlog setup_unix</tt> * run <tt>sudo backlog start</tt>  === Updates  * run <tt>sudo gem update -y</tt> * run <tt>sudo backlog setup_unix</tt> * run <tt>sudo backlog restart</tt>  === Configuration  You can set configuration parameters for backlog using the /etc/backlog.conf file. The format is YAML. Currently only port number is settable.  Example:  port: 3000  === Charts  The charts in Backlog are made using Gruff (http://nubyonrails.com/pages/gruff). Gruff uses RMagick (http://rmagick.rubyforge.org/) for image generation. RMagick uses ImageMagic (http://www.imagemagick.org/script/download.php) or GraphicsMagic (http://www.graphicsmagick.org/www/download.html). On some platforms ImageMagick and GraphicsMagick are either not available, or difficult to install. In that case, RMagick will fail to install, causing the Backlog gem to fail to install. To bypass this, you can install the Backlog gem using the --ignore-dependencies flag. Backlog will still work without RMagick, but charts will not be available.  ==== Links to charts  You can display the charts directly using links like the ones below. The charts are normally not protected, so you can display the in slideshows etc. without having to log in.  Examples:  http://backlog.kubosch.no/periods/burn_down_chart/55.png http://backlog.kubosch.no/parties/burn_down_chart/14.png  ==== Chart thumbnails  You can get small versions of the burn down charts by appending \"_thumbnail\" to the URL.  Examples:  http://backlog.kubosch.no/periods/burn_down_chart_thumbnail/55.png http://backlog.kubosch.no/parties/burn_down_chart_thumbnail/14.png  ==== Large charts  You can get large versions (1368x768) of the burn down charts by appending \"_large\" to the URL.  Examples:  http://backlog.kubosch.no/periods/burn_down_chart_large/55.png http://backlog.kubosch.no/parties/burn_down_chart_large/14.png"
 autorequire: 
 default_executable: 
 bindir: bin
@@ -45,10 +45,12 @@ files:
 - public/images/arrow_down.png
 - public/images/eraser_org.png
 - public/images/period.png
+- public/images/rmagick.gif
 - public/images/arrow_right.png
 - public/images/construction_hammer_jon__01.svg
 - public/images/arrow_down.svg
 - public/images/checkmark_org.png
+- public/images/rmagick_270.gif
 - public/images/pagebak.jpg
 - public/images/group.png
 - public/images/tabella_architetto_franc_01.svg
@@ -228,7 +230,6 @@ files:
 - config/environments/datek_production.rb
 - LICENSE_LOCALIZATION
 - README.txt
-- doc
 - Manifest.txt
 - cruise_config.rb
 - vendor
@@ -1777,7 +1778,7 @@ executables:
 extensions: []
 
 requirements: 
-- ImageMagick
+- ImageMagick or GraphicsMagick
 - PostgreSQL
 dependencies: 
 - !ruby/object:Gem::Dependency