taskjuggler 0.0.4 → 0.0.5

data/lib/tj3ss_sender.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = tj3ss_sender.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010 by Chris Schlaeger <cs@kde.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+# This script is used to send out the time sheet templates to the employees.
+# It should be run from a cron job once a week.
+
+require 'Tj3SheetAppBase'
+require 'StatusSheetSender'
+
+# Name of the application
+AppConfig.appName = 'tj3ss_sender'
+
+class TaskJuggler
+
+  class Tj3SsSender < Tj3SheetAppBase
+
+    def initialize
+      super
+      @optsSummaryWidth = 25
+      @force = false
+      @intervalDuration = nil
+
+      @hideResource = nil
+      # The default report period end is next Wednesday 0:00.
+      @date = TjTime.now.nextDayOfWeek(3).to_s('%Y-%m-%d')
+      @resourceList = []
+    end
+
+    def processArguments(argv)
+      super do
+        @opts.banner += <<'EOT'
+This program can be used to out status sheets templates via email. It will
+generate status sheet templates for managers of the project. The project data
+will be accesses via tj3client from a running TaskJuggler server process.
+EOT
+        @opts.on('-r', '--resource <ID>', String,
+                 format('Only generate template for given resource')) do |arg|
+          @resourceList << arg
+        end
+        @opts.on('-f', '--force',
+                format('Send out a new template even if one exists ' +
+                       'already')) do |arg|
+          @force = true
+        end
+        @opts.on('--hideresource <EXPR>', String,
+                 format('Filter expression to limit the resource list')) do |arg|
+          @hideResource = arg
+        end
+        optsEndDate
+      end
+    end
+
+    def main
+      super
+      ts = StatusSheetSender.new('tj3ss_sender')
+      @rc.configure(ts, 'global')
+      @rc.configure(ts, 'statussheets')
+      @rc.configure(ts, 'statussheets.sender')
+      ts.workingDir = @workingDir if @workingDir
+      ts.dryRun = @dryRun
+      ts.force = @force
+      ts.intervalDuration = @intervalDuration if @intervalDuration
+      ts.date = @date if @date
+      ts.hideResource = @hideResource if @hideResource
+
+      ts.sendTemplates(@resourceList)
+      0
+    end
+
+  end
+
+end
+
+exit TaskJuggler::Tj3SsSender.new.main()
+

data/lib/tj3ts_receiver.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = tj3ts_receiver.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010 by Chris Schlaeger <cs@kde.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+# This script is used to send out the time sheet templates to the employees.
+# It should be run from a cron job once a week.
+
+require 'Tj3SheetAppBase'
+require 'TimeSheetReceiver'
+
+# Name of the application suite
+AppConfig.appName = 'tj3ts_receiver'
+
+class TaskJuggler
+
+  class Tj3TsReceiver < Tj3SheetAppBase
+
+    def initialize
+      super
+    end
+
+    def processArguments(argv)
+      super do
+        @opts.banner += <<'EOT'
+This program can be used to receive filled-out time sheets via email.  It
+reads the emails from STDIN and extracts the time sheet from the attached
+files. The time sheet is checked for correctness. Good time sheets are filed
+away. The sender will be informed by email that the time sheets was accepted
+or rejected.
+EOT
+      end
+    end
+
+    def main
+      super
+      ts = TimeSheetReceiver.new('tj3ts_receiver')
+      @rc.configure(ts, 'global')
+      @rc.configure(ts, 'timesheets')
+      @rc.configure(ts, 'timesheets.receiver')
+      ts.workingDir = @workingDir if @workingDir
+      ts.dryRun = @dryRun
+
+      ts.processEmail
+    end
+
+  end
+
+end
+
+exit TaskJuggler::Tj3TsReceiver.new.main()
+

data/lib/tj3ts_sender.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = tj3ts_sender.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010 by Chris Schlaeger <cs@kde.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+# This script is used to send out the time sheet templates to the employees.
+# It should be run from a cron job once a week.
+
+require 'Tj3SheetAppBase'
+require 'TimeSheetSender'
+
+# Name of the application suite
+AppConfig.appName = 'tj3ts_sender'
+
+class TaskJuggler
+
+  class Tj3TsSender < Tj3SheetAppBase
+
+    def initialize
+      super
+      @optsSummaryWidth = 22
+      @force = false
+      @intervalDuration = nil
+
+      # The default report period end is next Monday 0:00.
+      @date = TjTime.now.nextDayOfWeek(1).to_s('%Y-%m-%d')
+      @resourceList = []
+    end
+
+    def processArguments(argv)
+      super do
+        @opts.banner += <<'EOT'
+This program can be used to send out time sheets templates via email. It will
+generate time sheet templates for all resources of the project. The project
+data will be accesses via tj3client from a running TaskJuggler server process.
+EOT
+        @opts.on('-r', '--resource <ID>', String,
+                format('Only generate template for given resource')) do |arg|
+          @resourceList << arg
+        end
+        @opts.on('-f', '--force',
+                format('Send out a new template even if one exists ' +
+                       'already')) do |arg|
+          @force = true
+        end
+        optsEndDate
+      end
+    end
+
+    def main
+      super
+      ts = TimeSheetSender.new('tj3ts_sender')
+      @rc.configure(ts, 'global')
+      @rc.configure(ts, 'timesheets')
+      @rc.configure(ts, 'timesheets.sender')
+      ts.workingDir = @workingDir if @workingDir
+      ts.dryRun = @dryRun
+      ts.force = @force
+      ts.intervalDuration = @intervalDuration if @intervalDuration
+      ts.date = @date if @date
+
+      ts.sendTemplates(@resourceList)
+      0
+    end
+
+  end
+
+end
+
+exit TaskJuggler::Tj3TsSender.new.main()
+

data/lib/tj3ts_summary.rb

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = tj3ts_summary.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010 by Chris Schlaeger <cs@kde.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+# This script is used to send out the time sheet templates to the employees.
+# It should be run from a cron job once a week.
+
+require 'Tj3SheetAppBase'
+require 'TimeSheetSummary'
+
+# Name of the application
+AppConfig.appName = 'tj3ts_summary'
+
+class TaskJuggler
+
+  class Tj3TsSummary < Tj3SheetAppBase
+
+    def initialize
+      super
+
+      # The default report period end is next Monday 0:00.
+      @date = TjTime.now.nextDayOfWeek(1).to_s('%Y-%m-%d')
+      @resourceList = []
+      @sheetRecipients = []
+      @digestRecipients = []
+    end
+
+    def processArguments(argv)
+      super do
+        @opts.banner += <<'EOT'
+This program can be used to send out individual copies and a summary of all
+accepted time sheets a list of email addresses. The directory structures for
+templates and submitted time sheets must be present. The project data will be
+accesses via tj3client from a running TaskJuggler server process.
+EOT
+        @opts.on('-r', '--resource <ID>', String,
+                 format('Only generate summary for given resource')) do |arg|
+          @resourceList << arg
+        end
+        @opts.on('-t', '--to <EMAIL>', String,
+                 format('Send all individual reports and a summary report ' +
+                        'to this email address')) do |arg|
+          @sheetRecipients << arg
+          @digestRecipients << arg
+        end
+        @opts.on('--sheet <EMAIL>', String,
+                 format('Send all reports to this email address')) do |arg|
+          @sheetRecipients << arg
+        end
+        @opts.on('--digest <EMAIL>', String,
+                 format('Send a summary report to this email address')) do |arg|
+          @digestRecipients << arg
+        end
+        optsEndDate
+      end
+    end
+
+    def main
+      super
+      ts = TimeSheetSummary.new
+      @rc.configure(ts, 'global')
+      @rc.configure(ts, 'timesheets')
+      @rc.configure(ts, 'timesheets.summary')
+      ts.workingDir = @workingDir if @workingDir
+      ts.dryRun = @dryRun
+      ts.date = @date if @date
+      ts.sheetRecipients += @sheetRecipients
+      ts.digestRecipients += @digestRecipients
+
+      ts.sendSummary(@resourceList)
+      0
+    end
+
+  end
+
+end
+
+exit TaskJuggler::Tj3TsSummary.new.main()
+