taskjuggler 0.0.4 → 0.0.5

data/lib/UTF8String.rb

@@ -98,4 +98,8 @@ class String
     alias length_utf8 length
   end
 
+  def to_quoted_printable
+    [self].pack('M').gsub(/\n/, "\r\n")
+  end
+
 end

data/lib/UserManual.rb

@@ -52,9 +52,11 @@ class TaskJuggler
         The_TaskJuggler_Syntax
         Rich_Text_Attributes
         Day_To_Day_Juggling
+        TaskJuggler_Internals
         fdl
       ).each do |file|
-        addSnip(srcDir + file)
+        snip = addSnip(srcDir + file)
+        snip.cssClass = 'manual'
       end
       # Generate the table of contense
       tableOfContents
@@ -183,12 +185,11 @@ class TaskJuggler
     # Generate the top-level file for the HTML user manual.
     def generateHTMLindex(directory)
       html = HTMLDocument.new(:frameset)
-      html << (head = XMLElement.new('head'))
-      head << (e = XMLNamedText.new("The #{AppConfig.softwareName} User Manual",
-                                    'title'))
-      head << XMLElement.new('meta', 'http-equiv' => 'Content-Type',
-                             'content' => 'text/html; charset=utf-8')
-
+      head = html.generateHead("The #{AppConfig.softwareName} User Manual",
+                               { 'description' =>
+                                 'A reference and user manual for the ' +
+                                 'TaskJuggler project management software.',
+                                 'keywords' => 'taskjuggler, manual, reference'})
       html << (frameset = XMLElement.new('frameset', 'cols' => '15%, 85%'))
       frameset << (navFrames = XMLElement.new('frameset', 'rows' => '15%, 85%'))
       navFrames << XMLElement.new('frame', 'src' => 'alphabet.html',

data/lib/XMLElement.rb

@@ -18,10 +18,8 @@ class TaskJuggler
   # trees can be constructed with the class constructor and converted into XML.
   class XMLElement
 
-    attr_writer :mayNotBeEmpty
-
     # Construct a new XML element and include it in an existing XMLElement tree.
-    def initialize(name, attributes = {})
+    def initialize(name, attributes = {}, selfClosing = false)
       if (name.nil? && attributes.length > 0) ||
          (!name.nil? && !name.is_a?(String))
         raise "Name must be nil or a String "
@@ -34,8 +32,8 @@ class TaskJuggler
       end
       @attributes = attributes
       @children = []
-      # This can be set to true if <name /> is illegal for this element.
-      @mayNotBeEmpty = false
+      # This can be set to true if <name /> is legal for this element.
+      @selfClosing = selfClosing
     end
 
     # Add a new child or a set of new childs to the element.
@@ -67,13 +65,19 @@ class TaskJuggler
       @attributes[attribute] = value
     end
 
+    # Return the value of attribute _attribute_.
+    def [](attribute)
+      @attributes[attribute]
+    end
+
+
     # Return the element and all sub elements as properly formatted XML.
     def to_s(indent = 0)
       out = '<' + @name
       @attributes.keys.sort.each do |attrName|
-        out << " #{attrName}=\"#{quoteAttr(@attributes[attrName])}\""
+        out << " #{attrName}=\"#{escape(@attributes[attrName], true)}\""
       end
-      if @children.empty? && !@mayNotBeEmpty
+      if @children.empty? && @selfClosing
         out << '/>'
       else
         out << '>'
@@ -92,26 +96,26 @@ class TaskJuggler
 
   protected
 
-    def indentation(indent)
-      ' ' * indent
-    end
-
-  private
-
-    # Make sure that any double quote in _str_ is properly quoted.
-    def quoteAttr(str)
+    # Escape special characters in input String _str_.
+    def escape(str, quotes = false)
       out = ''
       str.each_utf8_char do |c|
-        if c == '"'
+        case c
+        when '&'
+          out << '&amp;'
+        when '"'
           out << '\"'
         else
           out << c
         end
       end
-
       out
     end
 
+    def indentation(indent)
+      ' ' * indent
+    end
+
   end
 
   # This is a specialized XMLElement to represent a simple text.
@@ -164,7 +168,7 @@ class TaskJuggler
     end
 
     def to_s(indent)
-      '<!-- ' + @text + '-->'
+      '<!-- ' + @text + " -->\n#{' ' * indent}"
     end
 
   end
@@ -179,7 +183,11 @@ class TaskJuggler
     end
 
     def to_s(indent)
-      @blob
+      out = ''
+      @blob.each_utf8_char do |c|
+        out += (c == "\n" ? "\n" + ' ' * indent : c)
+      end
+      out
     end
 
   end

data/lib/daemon/Daemon.rb

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = Daemon.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.
+#
+
+require 'LogFile'
+
+class TaskJuggler
+
+  class Daemon
+
+    attr_accessor :daemonize
+
+    def initialize
+      @daemonize = true
+      @log = LogFile.instance
+    end
+
+    def start
+      return unless @daemonize
+
+      # Fork and have the parent exit
+      if (pid = fork) == -1
+        @log.fatal('First fork failed')
+      elsif !pid.nil?
+        # This is the parent. We can exit now.
+        @log.debug("Forked a child process with PID #{pid}")
+        exit 0
+      end
+
+      # Create a new session
+      Process.setsid
+      # Fork again to make sure we lose the controlling terminal
+      if (pid = fork) == -1
+        @log.fatal('Second fork failed')
+      elsif !pid.nil?
+        # This is the parent. We can exit now.
+        @log.debug("Forked a child process with PID #{pid}")
+        exit 0
+      end
+
+      @pid = Process.pid
+
+      # Change current working directory to the file system root
+      Dir.chdir '/'
+      # Make sure we can create files with any permission
+      File.umask 0
+
+      # We no longer have a controlling terminal, so these are useless.
+      $stdin.reopen('/dev/null')
+      $stdout.reopen('/dev/null', 'a')
+      $stderr.reopen($stdout)
+
+      @log.info("The process is running as daemon now with PID #{@pid}")
+    end
+
+    def stop
+    end
+
+  end
+
+end
+

data/lib/daemon/ProcessIntercom.rb

@@ -0,0 +1,117 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = ProcessIntercom.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.
+#
+
+require 'Log'
+
+class TaskJuggler
+
+  module ProcessIntercomIface
+
+    def terminate(authKey)
+      return false unless @server.checkKey(authKey, 'terminate')
+
+      @server.terminate
+    end
+
+    def connect(authKey, stdout, stderr, stdin, silent)
+      return false unless @server.checkKey(authKey, 'connect')
+
+      @server.connect(stdout, stderr, stdin, silent)
+    end
+
+    def disconnect(authKey)
+      return false unless @server.checkKey(authKey, 'disconnect')
+
+      @server.disconnect
+    end
+
+  end
+
+  module ProcessIntercom
+
+    def initIntercom
+      # This is the authentication key that clients will need to provide to
+      # execute DRb methods.
+      @authKey = generateAuthKey
+
+      @log = LogFile.instance
+      # This flag will be set to true by DRb method calls to terminate the
+      # process.
+      @terminate = false
+    end
+
+    def terminate
+      @log.debug('Terminating on external request')
+      @terminate = true
+    end
+
+    def connect(stdout, stderr, stdin, silent)
+      @log.debug('Rerouting ProjectServer standard IO to client')
+      # Make sure that all output to STDOUT and STDERR is sent to the client.
+      # Input is read from the client STDIN.  We save a copy of the old file
+      # handles so we can restore then later again.
+      @stdout = $stdout
+      @stderr = $stderr
+      @stdin = $stdin
+      $stdout = stdout
+      $stderr = stderr
+      $stdin = stdin
+      @log.debug('IO is now routed to the client')
+      Log.silent = silent
+      true
+    end
+
+    def disconnect
+      @log.debug('Restoring IO')
+      Log.silent = true
+      $stdout = @stdout
+      $stderr = @stderr
+      $stdin = @stdin
+      @log.debug('Standard IO has been restored')
+      true
+    end
+
+    def generateAuthKey
+      rand(1000000000).to_s
+    end
+
+    def checkKey(authKey, command)
+      if authKey == @authKey
+        @log.debug("Accepted authentication key for command '#{command}'")
+      else
+        @log.warning("Rejected wrong authentication key #{authKey}" +
+                     "for command '#{command}'")
+        return false
+      end
+      true
+    end
+
+    def startTerminator
+      Thread.new do
+        loop do
+          if @terminate
+            # Give the caller a chance to properly terminate the connection.
+            sleep 1
+            @log.debug('Shutting down DRb server')
+            DRb.stop_service
+            break
+          else
+            sleep 1
+          end
+        end
+      end
+    end
+
+  end
+
+end
+