taskjuggler 0.0.10 → 0.0.11

data/lib/{UserManual.rb → taskjuggler/UserManual.rb}

@@ -12,11 +12,11 @@
 #
 
 require 'fileutils'
-require 'Tj3Config'
-require 'RichTextDocument'
-require 'SyntaxReference'
-require 'TjTime'
-require 'RichTextFunctionExample'
+require 'taskjuggler/Tj3Config'
+require 'taskjuggler/RichText/Document'
+require 'taskjuggler/SyntaxReference'
+require 'taskjuggler/TjTime'
+require 'taskjuggler/RichText/FunctionExample'
 
 class TaskJuggler
 
@@ -102,7 +102,7 @@ class TaskJuggler
         "Copyright (c) #{AppConfig.copyright.join(', ')} " +
         "by #{AppConfig.authors.join(', ')}", 'b')
       div << XMLElement.new('br')
-      div << XMLText.new("Generated on #{TjTime.now.strftime('%Y-%m-%d')}")
+      div << XMLText.new("Generated on #{TjTime.new.strftime('%Y-%m-%d')}")
       div << XMLElement.new('br')
       div << XMLNamedText.new("This manual covers #{AppConfig.softwareName} " +
                               "version #{AppConfig.version}.", 'h3')

data/lib/{VimSyntax.rb → taskjuggler/VimSyntax.rb}

@@ -11,7 +11,7 @@
 # published by the Free Software Foundation.
 #
 
-require 'SyntaxReference'
+require 'taskjuggler/SyntaxReference'
 
 class TaskJuggler
 
@@ -210,6 +210,11 @@ hi def link tjpnumber Number
 
 let b:current_syntax = "tjp"
 
+augroup TaskJugglerSource
+  " Remove all trailing white spaces from line ends when saving files
+  " Note: This overwrites the s mark.
+  autocmd BufWritePre *.tj[ip] mark s | %s/\s\+$//e | normal `s
+augroup END
 EOT
     end
 
@@ -221,4 +226,3 @@ EOT
 
 end
 
-TaskJuggler::VimSyntax.new.generate('tjp.vim')

data/lib/{WorkingHours.rb → taskjuggler/WorkingHours.rb}

@@ -11,8 +11,8 @@
 # published by the Free Software Foundation.
 #
 
-require 'Interval'
-require 'Scoreboard'
+require 'taskjuggler/Interval'
+require 'taskjuggler/Scoreboard'
 
 class TaskJuggler
 
@@ -29,7 +29,7 @@ class TaskJuggler
     # existing WorkingHours object in +wh+. When it's present, the new object
     # will be a deep copy of the given object. The Scoreboard object is _not_
     # deep copied. It will be copied on write.
-    def initialize(arg1 = nil, startDate = nil, endDate = nil)
+    def initialize(arg1 = nil, startDate = nil, endDate = nil, timeZone = nil)
       # One entry for every day of the week. Sunday === 0.
       @days = Array.new(7, [])
       @scoreboard = nil
@@ -59,7 +59,7 @@ class TaskJuggler
         @slotDuration = slotDuration
 
         # Create a new object with default working hours.
-        @timezone = nil
+        @timezone = timeZone
         # Set the default working hours. Monday to Friday 9am - 12pm, 1pm - 6pm.
         # Saturday and Sunday are days off.
         1.upto(5) do |day|
@@ -138,8 +138,8 @@ class TaskJuggler
     def timeOff?(interval)
       initScoreboard unless @scoreboard
 
-      startIdx = @scoreboard.dateToIdx(interval.start, true)
-      endIdx = @scoreboard.dateToIdx(interval.end, true)
+      startIdx = @scoreboard.dateToIdx(interval.start)
+      endIdx = @scoreboard.dateToIdx(interval.end)
 
       startIdx.upto(endIdx - 1) do |i|
         return false if @scoreboard[i]
@@ -182,21 +182,17 @@ class TaskJuggler
       @scoreboard = Scoreboard.new(@startDate, @endDate, @slotDuration, false)
 
       oldTimezone = nil
-      # Set environment variable TZ to appropriate time zone
+      # Active the appropriate time zone for the working hours.
       if @timezone
-        oldTimezone = ENV['TZ']
-        ENV['TZ'] = @timezone
+        oldTimezone = TjTime.setTimeZone(@timezone)
       end
 
       date = @startDate
       @scoreboard.collect! do |slot|
-        localDate = date.dup
-        localDate.localtime
-
-        # The date is in UTC. The weekday needs to be calculated according to
-        # the local timezone.
-        weekday = localDate.wday
-        secondsOfDay = localDate.secondsOfDay
+        # The weekday and seconds of the day needs to be calculated according
+        # to the local timezone.
+        weekday = date.wday
+        secondsOfDay = date.secondsOfDay
 
         result = false
         @days[weekday].each do |iv|
@@ -213,13 +209,9 @@ class TaskJuggler
         result
       end
 
-      # Restore environment
+      # Restore old time zone setting.
       if @timezone
-        if oldTimezone
-          ENV['TZ'] = oldTimezone
-        else
-          ENV.delete('TZ')
-        end
+        TjTime.setTimeZone(oldTimezone)
       end
     end
 

data/lib/{XMLDocument.rb → taskjuggler/XMLDocument.rb}

@@ -11,7 +11,7 @@
 # published by the Free Software Foundation.
 #
 
-require 'XMLElement'
+require 'taskjuggler/XMLElement'
 
 class TaskJuggler
 

data/lib/{XMLElement.rb → taskjuggler/XMLElement.rb}

@@ -11,7 +11,7 @@
 # published by the Free Software Foundation.
 #
 
-require 'UTF8String'
+require 'taskjuggler/UTF8String'
 
 class TaskJuggler
 

data/lib/taskjuggler/apps/Tj3.rb

@@ -0,0 +1,134 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = Tj3.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+#               by Chris Schlaeger <chris@linux.com>
+#
+# 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.
+#
+
+require 'taskjuggler/Tj3AppBase'
+require 'taskjuggler/TaskJuggler'
+
+# Name of the application suite
+AppConfig.appName = 'tj3'
+
+class TaskJuggler
+
+  class Tj3 < Tj3AppBase
+
+    def initialize
+      super
+
+      # By default, we're only using 1 CPU core.
+      @maxCpuCores = 1
+      # Don't generate warnings for differences between time sheet data and
+      # the plan.
+      @warnTsDeltas = false
+      # Don't stop after reading all files.
+      @checkSyntax = false
+      # Don't generate reports when previous errors have been found.
+      @forceReports = false
+      # Don't generate any reports.
+      @noReports = false
+      # The directory where generated reports should be put in.
+      @outputDir = ''
+      # The file names of the time sheet files to check.
+      @timeSheets = []
+      # The file names of the status sheet files to check.
+      @statusSheets = []
+
+      # Show some progress information by default
+      TaskJuggler::Log.silent = false
+    end
+
+    def processArguments(argv)
+      super do
+        @opts.banner += <<'EOT'
+This is the main application. It reads in your project files, schedules the
+project and generates the reports.
+EOT
+        @opts.on('--debuglevel N', Integer,
+                 format("Verbosity of debug output")) do |arg|
+          TaskJuggler::Log.level = arg
+        end
+        @opts.on('--debugmodules x,y,z', Array,
+                format('Restrict debug output to a list of modules')) do |arg|
+          TaskJuggler::Log.segments = arg.split(',')
+        end
+        @opts.on('-f', '--force-reports',
+                format('Generate reports despite scheduling errors')) do
+          @forceReports = true
+        end
+        @opts.on('--check-time-sheet <tji-file>', String,
+                format("Check the given time sheet")) do |arg|
+          @timeSheets << arg
+        end
+        @opts.on('--check-status-sheet <tji-file>', String,
+                format("Check the given status sheet")) do |arg|
+          @statusSheets << arg
+        end
+        @opts.on('--warn-ts-deltas',
+                format('Turn on warnings for requested changes in time ' +
+                       'sheets')) do
+         @warnTsDeltas = true
+        end
+        @opts.on('--check-syntax',
+                format('Only parse the input files and check the syntax.')) do
+         @checkSyntax = true
+        end
+        @opts.on('--no-reports',
+                format('Just schedule the project, but don\'t generate any ' +
+                       'reports.')) do
+         @noReports = true
+        end
+        @opts.on('-o', '--output-dir <directory>', String,
+                format('Directory the reports should go into')) do |arg|
+          @outputDir = arg + '/'
+        end
+        @opts.on('-c N', Integer,
+                 format('Maximum number of CPU cores to use')) do |arg|
+          @maxCpuCores = arg
+        end
+      end
+    end
+
+    def main(argv = ARGV)
+      files = super
+
+      tj = TaskJuggler.new(true)
+      tj.maxCpuCores = @maxCpuCores
+      tj.warnTsDeltas = @warnTsDeltas
+      keepParser = !@timeSheets.empty? || !@statusSheets.empty?
+      return 1 unless tj.parse(files, keepParser)
+
+      return 0 if @checkSyntax
+
+      if !tj.schedule
+        return 1 unless @forceReports
+      end
+
+      # The checks of time and status sheets is probably only used for debugging.
+      # Normally, this function is provided by tj3client.
+      @timeSheets.each do |ts|
+        return 1 if !tj.checkTimeSheet(ts, File.read(ts)) || tj.errors > 0
+      end
+      @statusSheets.each do |ss|
+        return 1 if !tj.checkStatusSheet(ss, File.read(ss)) || tj.errors > 0
+      end
+
+      return 0 if @noReports
+
+      return 1 if !tj.generateReports(@outputDir) || tj.errors > 0
+
+      0
+    end
+
+  end
+
+end
+

data/lib/taskjuggler/apps/Tj3Client.rb

@@ -0,0 +1,467 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = Tj3Client.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+#               by Chris Schlaeger <chris@linux.com>
+#
+# 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.
+#
+
+require 'drb'
+require 'drb/acl'
+require 'taskjuggler/Tj3AppBase'
+require 'taskjuggler/LogFile'
+
+# Name of the application
+AppConfig.appName = 'tj3client'
+
+class TaskJuggler
+
+  # The Tj3Client class provides the primary interface to the TaskJuggler
+  # daemon. It exposes a rich commandline interface that supports key
+  # operations like add/removing a project, generating a report or checking a
+  # time or status sheet. All connections are made via DRb and tj3client
+  # requires a properly configured tj3d to work.
+  class Tj3Client < Tj3AppBase
+
+    def initialize
+      super
+
+      # For security reasons, this will probably not change. All DRb
+      # operations are limited to localhost only. The client and the sever
+      # must have access to the identical file system.
+      @host = '127.0.0.1'
+      # The default port. 'T' and 'J' in ASCII decimal
+      @port = 8474
+      # The file with the server URI in case port is 0.
+      @uriFile = File.join(Dir.getwd, '.tj3d.uri')
+      # This must must be changed for the communication to work.
+      @authKey = nil
+      # Determines whether report IDs are fix IDs or regular expressions that
+      # match a set of reports.
+      @regExpMode = false
+      # Prevents usage of protective sandbox if set to true.
+      @unsafeMode = false
+      # List of requested output formats for reports.
+      @formats = nil
+
+      @mandatoryArgs = '<command> [arg1 arg2 ...]'
+
+      # This list describes the supported command line commands and their
+      # parameter.
+      # :label : The command name
+      # :args : A list of parameters. If the first character is a '+' the
+      # parameter must be provided 1 or more times. If the first character is
+      # a '*' the parameter must be provided 0 or more times. Repeatable and
+      # optional paramters must follow the mandatory ones.
+      # :descr : A short description of the command used for the help text.
+      @commands = [
+        { :label => 'status',
+          :args  => [],
+          :descr => 'Display the status of the available projects' },
+        { :label => 'terminate',
+          :args  => [],
+          :descr => 'Terminate the TaskJuggler daemon' },
+        { :label => 'add',
+          :args  => [ 'tjp file', '*tji file'],
+          :descr => 'Add a new project or update and existing one' },
+        { :label => 'update',
+          :args => [],
+          :descr => 'Reload all projects that have modified files and '+
+                    'are not being reloaded already' },
+        { :label => 'remove',
+          :args  => [ '+project ID' ],
+          :descr => 'Remove the project with the specified ID from the ' +
+                    'daemon' },
+        { :label => 'report',
+          :args  => [ 'project ID', '+report ID', '!=', '*tji file'],
+          :descr => 'Generate the report with the provided ID for ' +
+                    'the project with the given ID'},
+        { :label => 'list-reports',
+          :args  => [ 'project ID', '!report ID' ],
+          :descr => 'List all available reports of the project or those ' +
+                    'that match the provided report ID' },
+        { :label => 'check-ts',
+          :args  => [ 'project ID', 'time sheet' ],
+          :descr => 'Check the provided time sheet for correctness ' +
+                    'against the project with the given ID'},
+        { :label => 'check-ss',
+          :args  => [ 'project ID', 'status sheet' ],
+          :descr => 'Check the provided status sheet for correctness ' +
+                    'against the project with the given ID'}
+      ]
+    end
+
+    def processArguments(argv)
+      super do
+        @opts.banner += <<'EOT'
+The TaskJuggler client is used to send commands and data to the TaskJuggler
+daemon. The communication is done via TCP/IP.
+
+The following commands are supported:
+
+EOT
+
+        # Convert the command list into a help text.
+        @commands.each do |cmd|
+          tail = ''
+          args = cmd[:args].dup
+          args.map! do |c|
+            if c[0] == '*'
+              "[<#{c[1..-1]}> ...]"
+            elsif c[0] == '+'
+              "<#{c[1..-1]}> [<#{c[1..-1]}> ...]"
+            elsif c[0] == '!'
+              tail += ']'
+              "[#{c[1..-1]} "
+            else
+              "<#{c}>"
+            end
+          end
+          args = args.join(' ')
+          @opts.banner += "     #{cmd[:label] + ' ' + args + tail}" +
+                          "\n\n#{' ' * 10 + format(cmd[:descr], 10)}\n"
+        end
+        @opts.on('-p', '--port <NUMBER>', Integer,
+                 format('Use the specified TCP/IP port')) do |arg|
+           @port = arg
+        end
+        @opts.on('--urifile <FILE>', String,
+                 format('If the port is 0, use this file to get the URI ' +
+                        'of the server.')) do |arg|
+          @uriFile = arg
+        end
+        @opts.on('-r', '--regexp',
+                 format('The report IDs are not fixed but regular expressions ' +
+                        'that match a set of reports')) do |arg|
+          @regExpMode = true
+        end
+        @opts.on('--unsafe',
+                 format('Run the program without sandbox protection. This ' +
+                        'is not recommended for normal operation! It may ' +
+                        'only be used for debugging or testing ' +
+                        'purposes.')) do |arg|
+          @unsafeMode = true
+        end
+        @opts.on('--format [FORMAT]', [ :csv, :html, :niku, :tjp ],
+                 format('Request the report to be generated in the specified' +
+                        'format. Use multiple options to request multiple ' +
+                        'formats. Supported formats are csv, html, niku and ' +
+                        'tjp. By default, the formats specified in the report ' +
+                        'definition are used.')) do |arg|
+          @formats = [] unless @formats
+          @formats << arg
+        end
+      end
+    end
+
+    def main(argv = ARGV)
+      args = super
+      # Run a first check of the non-optional command line arguments.
+      checkCommand(args)
+      # Read some configuration variables. Except for the authKey, they are
+      # all optional.
+      @rc.configure(self, 'global')
+
+      connectDaemon
+      retVal = executeCommand(args[0], args[1..-1])
+      disconnectDaemon
+
+      retVal
+    end
+
+    private
+
+    def checkCommand(args)
+      if args.empty?
+        errorMessage = 'You must specify a command!'
+      else
+        errorMessage = "Unknown command #{args[0]}"
+        @commands.each do |cmd|
+          # The first value of args is the command name.
+          if cmd[:label] == args[0]
+            # Find out how many arguments we need to have and if that's a
+            # lower limit or a fixed value.
+            minArgs = 0
+            varArgs = false
+            cmd[:args].each do |arg|
+              # Arguments starting with '+' must have 1 or more showings.
+              # Arguments starting with '*' may show up 0 or more times.
+              minArgs += 1 unless '!*'.include?(arg[0])
+              varArgs = true if '!*+'.include?(arg[0])
+            end
+            return true if args.length - 1 >= minArgs
+            errorMessage = "Command #{args[0]} must have " +
+                           "#{varArgs ? 'at least ' : ''}#{minArgs} " +
+                           'arguments'
+          end
+        end
+      end
+
+      error(errorMessage)
+    end
+
+    def connectDaemon
+      unless @authKey
+        $stderr.puts <<'EOT'
+You must set an authentication key in the configuration file. Create a file
+named .taskjugglerrc or taskjuggler.rc that contains at least the following
+lines. Replace 'your_secret_key' with some random character sequence.
+
+_global:
+  authKey: your_secret_key
+EOT
+      end
+
+      uri = "druby://#{@host}:#{@port}"
+      if @port == 0
+        # If the @port is configured to 0, we need to read the URI to connect
+        # to the server from the .tj3d.uri file that has been generated by the
+        # server.
+        begin
+          uri = File.read(@uriFile).chomp
+        rescue
+          error('The server port is configured to be 0, but no ' +
+                ".tj3d.uri file can be found: #{$!}")
+        end
+      end
+
+      # We try to play it safe here. The client also starts a DRb server, so
+      # we need to make sure it's constricted to localhost only. We require
+      # the DRb server for the standard IO redirection to work.
+      $SAFE = 1 unless @unsafeMode
+      DRb.install_acl(ACL.new(%w[ deny all
+                                  allow 127.0.0.1 ]))
+      DRb.start_service('druby://127.0.0.1:0')
+
+      begin
+        # Get the ProjectBroker object from the tj3d.
+        @broker = DRbObject.new(nil, uri)
+        # Client and server should always come from the same Gem. Since we
+        # restict communication to localhost, that's probably not a problem.
+        if (check = @broker.apiVersion(@authKey, 1)) < 0
+          error('This client is too old for the server. Please ' +
+                'upgrade to a more recent version of the software.')
+        elsif check == 0
+          error('Authentication failed. Please check your authentication ' +
+                'key to match the server key.')
+        end
+      rescue
+        error("TaskJuggler server on host '#{@host}' port " +
+              "#{@port} is not responding")
+      end
+    end
+
+    def disconnectDaemon
+      @broker = nil
+
+      DRb.stop_service
+    end
+
+    def executeCommand(command, args)
+      case command
+      when 'status'
+        $stdout.puts callDaemon(:status, [])
+      when 'terminate'
+        callDaemon(:stop, [])
+        info('Daemon terminated')
+      when 'add'
+        res = callDaemon(:addProject, [ Dir.getwd, args,
+                                        $stdout, $stderr, $stdin, @silent ])
+        info("Project(s) #{args.join(', ')} added")
+        return res ? 0 : 1
+      when 'remove'
+        args.each do |arg|
+          unless callDaemon(:removeProject, arg)
+            error("Project '#{arg}' not found in list")
+          end
+        end
+        info('Project removed')
+      when 'update'
+        callDaemon(:update, [])
+        info('Reload requested')
+      when 'report'
+        # The first value of args is the project ID. The following values
+        # could be either report IDs or TJI file # names ('.' or '*.tji').
+        projectId = args.shift
+        # Ask the ProjectServer to launch a new ReportServer process and
+        # provide a DRbObject reference to it.
+        connectToReportServer(projectId)
+
+        reportIds, tjiFiles = splitIdsAndFiles(args)
+        if reportIds.empty?
+          disconnectReportServer
+          error('You must provide at least one report ID')
+        end
+        # Send the provided .tji files to the ReportServer.
+        failed = !addFiles(tjiFiles)
+        # Ask the ReportServer to generate the reports with the provided IDs.
+        unless failed
+          reportIds.each do |reportId|
+            unless @reportServer.generateReport(@rs_authKey, reportId,
+                                                @regExpMode, @formats, nil)
+              failed = true
+              break
+            end
+          end
+        end
+        # Terminate the ReportServer
+        disconnectReportServer
+        return failed ? 1 : 0
+      when 'list-reports'
+        # The first value of args is the project ID. The following values
+        # could be either report IDs or TJI file # names ('.' or '*.tji').
+        projectId = args.shift
+        # Ask the ProjectServer to launch a new ReportServer process and
+        # provide a DRbObject reference to it.
+        connectToReportServer(projectId)
+
+        reportIds, tjiFiles = splitIdsAndFiles(args)
+        if reportIds.empty?
+          # If the user did not provide a report ID we generate a full list.
+          reportIds = [ '.*' ]
+          @regExpMode = true
+        end
+        # Send the provided .tji files to the ReportServer.
+        failed = !addFiles(tjiFiles)
+        # Ask the ReportServer to generate the reports with the provided IDs.
+        unless failed
+          reportIds.each do |reportId|
+            unless @reportServer.listReports(@rs_authKey, reportId, @regExpMode)
+              failed = true
+              break
+            end
+          end
+        end
+        # Terminate the ReportServer
+        disconnectReportServer
+        return failed ? 1 : 0
+      when 'check-ts'
+        connectToReportServer(args[0])
+        begin
+          res = @reportServer.checkTimeSheet(@rs_authKey, args[1])
+        rescue
+          error("Time sheet check failed: #{$!}")
+        end
+        disconnectReportServer
+        return res ? 0 : 1
+      when 'check-ss'
+        connectToReportServer(args[0])
+        begin
+          res = @reportServer.checkStatusSheet(@rs_authKey, args[1])
+        rescue
+          error("Status sheet check failed: #{$!}")
+        end
+        disconnectReportServer
+        return res ? 0 : 1
+      else
+        raise "Unknown command #{command}"
+      end
+      0
+    end
+
+    def connectToReportServer(projectId)
+      @ps_uri, @ps_authKey = callDaemon(:getProject, projectId)
+      if @ps_uri.nil?
+        error("No project with ID #{projectId} loaded")
+      end
+      begin
+        @projectServer = DRbObject.new(nil, @ps_uri)
+        @rs_uri, @rs_authKey = @projectServer.getReportServer(@ps_authKey)
+        @reportServer = DRbObject.new(nil, @rs_uri)
+      rescue
+        error("Cannot get report server")
+      end
+      begin
+        @reportServer.connect(@rs_authKey, $stdout, $stderr, $stdin, @silent)
+      rescue
+        error("Can't connect IO: #{$!}")
+      end
+    end
+
+    def disconnectReportServer
+      begin
+        @reportServer.disconnect(@rs_authKey)
+      rescue
+        error("Can't disconnect IO: #{$!}")
+      end
+      begin
+        @reportServer.terminate(@rs_authKey)
+      rescue
+        error("Report server termination failed: #{$!}")
+      end
+      @reportServer = nil
+      @rs_uri = nil
+      @rs_authKey = nil
+      @projectServer = nil
+      @ps_uri = nil
+      @ps_authKey = nil
+    end
+
+    # Call the TaskJuggler daemon (ProjectBroker) and execute the provided
+    # command with the provided arguments.
+    def callDaemon(command, args)
+      begin
+        return @broker.command(@authKey, command, args)
+      rescue
+        error("Call to TaskJuggler server on host '#{@host}' " +
+              "port #{@port} failed: #{$!}")
+      end
+    end
+
+    # Sort the remaining arguments into a report ID and a TJI file list.
+    # If .tji files are present, they must be separated from the report ID
+    # list by a '='.
+    def splitIdsAndFiles(args)
+      reportIds = []
+      tjiFiles = []
+      addToReports = true
+      args.each do |arg|
+        if arg == '='
+          # Switch to tji file list.
+          addToReports = false
+        elsif addToReports
+          reportIds << arg
+        else
+          tjiFiles << arg
+        end
+      end
+
+      [ reportIds, tjiFiles ]
+    end
+
+    # Transfer the _tjiFiles_ to the _reportServer_.
+    def addFiles(tjiFiles)
+      tjiFiles.each do |file|
+        begin
+          unless @reportServer.addFile(@rs_authKey, file)
+            return false
+          end
+        rescue
+          error("Cannot add file #{file} to ReportServer")
+        end
+      end
+      true
+    end
+
+    def info(message)
+      return if @silent
+      $stdout.puts "#{message}"
+    end
+
+    def error(message)
+      $stderr.puts "ERROR: #{message}"
+      # Don't call exit in unsafe mode. We are probably running as a RSpec
+      # test.
+      exit 1 unless @unsafeMode
+    end
+
+  end
+
+end
+
+