rUtilAnts 0.1.1.20091105 → 0.2.0.20101109

data/ReleaseInfo

@@ -2,7 +2,7 @@
 # This file has been generated by RubyPackager during a delivery.
 # More info about RubyPackager: http://rubypackager.sourceforge.net
 {
-  :Version => '0.1.1.20091105',
+  :Version => '0.2.0.20101109',
   :Tags => [],
   :DevStatus => 'Alpha'
 }

data/lib/rUtilAnts/ForeignProcess.rb

@@ -0,0 +1,205 @@
+#--
+# Copyright (c) 2010 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Licensed under the terms specified in LICENSE file. No warranty is provided.
+#++
+
+module RUtilAnts
+
+  # This module defines a method to run a given Ruby's object and parameters in a separate process.
+  # This can be useful when $LD_LIBRARY_PATH has to be changed before continuing.
+  module ForeignProcess
+
+    # Class containing info for serialized method calls
+    class MethodCallInfo
+
+      # Log file
+      #   String
+      attr_accessor :LogFile
+
+      # Lib root dir
+      #   String
+      attr_accessor :LibRootDir
+
+      # Bug tracker URL
+      #   String
+      attr_accessor :BugTrackerURL
+
+      # Load path
+      #   list<String>
+      attr_accessor :LoadPath
+
+      # List of files to require
+      #   list<String>
+      attr_accessor :RequireFiles
+
+      # Serialized MethodDetails
+      # It is stored serialized as to unserialize it we first need to unserialize the RequireFiles
+      #   String
+      attr_accessor :SerializedMethodDetails
+
+      class MethodDetails
+
+        # Object to call the function on
+        #   Object
+        attr_accessor :Object
+
+        # Method to call
+        #   Symbol
+        attr_accessor :Method
+
+        # Parameters
+        #   list<Object>
+        attr_accessor :Parameters
+
+      end
+
+    end
+
+    # Execute a command in another Ruby session, executing some Shell commands before invocation.
+    #
+    # Parameters:
+    # * *iShellCmd* (_String_): Shell command to invoke before Ruby
+    # * *iObject* (_Object_): Object that will have a function to call in the new session
+    # * *iMethod* (_Symbol_): Method to call on the object
+    # * *Parameters* (<em>list<Object></em>): Remaining parameters
+    # Return:
+    # * _Exception_: An error, or nil if success
+    # * _Object_: The result of the function call (valid only if no error returned)
+    def self.execCmdOtherSession(iShellCmd, iObject, iMethod, iParameters)
+      rError = nil
+      rResult = nil
+
+      # Protect it from exceptions, to ensure that a valid error message will be returned
+      begin
+        logDebug "Execute method #{iMethod}(#{iParameters.join(', ')}) in a new process with shell command: #{iShellCmd} ..."
+
+        # Create an object that we will serialize, containing all needed information for the session
+        lInfo = MethodCallInfo.new
+        lInfo.LogFile = getLogFile
+        lInfo.LibRootDir = getLibRootDir
+        lInfo.BugTrackerURL = getBugTrackerURL
+        lInfo.RequireFiles = []
+        # Do not store ForeignProcess require
+        $".each do |iRequireName|
+          if (iRequireName.match(/ForeignProcess/) == nil)
+            lInfo.RequireFiles << iRequireName
+          end
+        end
+        lInfo.LoadPath = $LOAD_PATH.clone
+        lMethodDetails = MethodCallInfo::MethodDetails.new
+        lMethodDetails.Parameters = iParameters
+        lMethodDetails.Method = iMethod
+        lMethodDetails.Object = iObject
+        logDebug "Method to be marshalled: #{lMethodDetails.inspect}"
+        lInfo.SerializedMethodDetails = Marshal.dump(lMethodDetails)
+        lCurrentThread = Thread.current
+        # Dump this object in a temporary file
+        require 'tmpdir'
+        lInfoFileName = "#{Dir.tmpdir}/RubyExec_#{lCurrentThread.object_id}_Info"
+        File.open(lInfoFileName, 'w') do |oFile|
+          oFile.write(Marshal.dump(lInfo))
+        end
+        # For security reasons, ensure that only us can read this file. It can contain passwords.
+        require 'fileutils'
+        FileUtils.chmod(0700, lInfoFileName)
+        # Generate the Ruby file that will run everything
+        lExecFileName = "#{Dir.tmpdir}/RubyExec_#{lCurrentThread.object_id}_Exec.rb"
+        File.open(lExecFileName, 'w') do |oFile|
+          oFile << "
+\# This is a generated file that should not stay persistent. You can delete it.
+\# It has been generated by rUtilAnts::ForeignProcess module. Check http://rutilants.sourceforge.net for further details.
+require '#{File.expand_path(__FILE__)}'
+RUtilAnts::ForeignProcess::executeEmbeddedFunction(ARGV[0], ARGV[1])
+"
+        end
+        # For security reasons, ensure that only us can read and execute this file.
+        FileUtils.chmod(0700, lExecFileName)
+        # Name the file that will receive the result of the function call
+        lResultFileName = "#{Dir.tmpdir}/RubyExec_#{lCurrentThread.object_id}_Result"
+
+        # Call this Ruby file by first executing the Shell command
+        lCmd = "#{iShellCmd}; ruby -w #{lExecFileName} #{lInfoFileName} #{lResultFileName} 2>&1"
+        lOutput = `#{lCmd}`
+        lErrorCode = $?
+        if (lErrorCode == 0)
+          # Read the result file
+          File.open(lResultFileName, 'r') do |iFile|
+            rResult = Marshal.load(iFile.read)
+          end
+        else
+          rError = RuntimeError.new("Error while running command \"#{lCmd}\". Here is the output:\n#{lOutput}.")
+        end
+
+        # Remove files
+        File.unlink(lInfoFileName)
+        File.unlink(lExecFileName)
+        if (File.exists?(lResultFileName))
+          File.unlink(lResultFileName)
+        end
+      rescue Exception
+        rError = $!
+      end
+
+      logDebug "Method executed with error #{rError} and result #{rResult}."
+
+      return rError, rResult
+    end
+
+    # Execute a function along with its parameters stored in a file.
+    # This method is used by the file generated by execCmdOtherSession.
+    # It should not be called directly.
+    #
+    # Parameters:
+    # * *iInfoFileName* (_String_): The file containing info
+    # * *iResultFileName* (_String_): The file used to store the result serialized
+    def self.executeEmbeddedFunction(iInfoFileName, iResultFileName)
+      begin
+        # Read the file
+        lInfo = nil
+        File.open(iInfoFileName, 'r') do |iFile|
+          lInfo = Marshal.load(iFile.read)
+        end
+        # Set the load path
+        lInfo.LoadPath.each do |iDir|
+          if (!$LOAD_PATH.include?(iDir))
+            $LOAD_PATH << iDir
+          end
+        end
+        # Require all given files
+        lInfo.RequireFiles.each do |iRequireName|
+          require iRequireName
+        end
+        # Initialize logging
+        RUtilAnts::Logging::initializeLogging(lInfo.LibRootDir, lInfo.BugTrackerURL)
+        setLogFile(lInfo.LogFile)
+        logDebug "New process spawned with requires: #{lInfo.RequireFiles.join(', ')}."
+        # Unserialize the method details
+        lMethodDetails = Marshal.load(lInfo.SerializedMethodDetails)
+        # Call the method on the object with all its parameters
+        logDebug "Calling method #{lMethodDetails.Method}(#{lMethodDetails.Parameters.join(', ')}) ..."
+        lResult = lMethodDetails.Object.send(lMethodDetails.Method, *lMethodDetails.Parameters)
+        logDebug "Method returned #{lResult}."
+      rescue Exception
+        lResult = RuntimeError.new("Error occurred while executing foreign call: #{$!}. Backtrace: #{$!.backtrace.join("\n")}")
+      end
+      begin
+        # Store the result in the file for return
+        File.open(iResultFileName, 'w') do |oFile|
+          oFile.write(Marshal.dump(lResult))
+        end
+        # For security reasons, ensure that only us can read this file. It can contain passwords.
+        require 'fileutils'
+        FileUtils.chmod(0700, iResultFileName)
+      rescue Exception
+        logErr "Error while writing result in to #{iResultFileName}: #{$!}."
+      end
+    end
+
+    # Initialize the ForeignProcess methods in the Object namespace
+    def self.initializeForeignProcess
+      Object.module_eval('include RUtilAnts::ForeignProcess')
+    end
+
+  end
+
+end

data/lib/rUtilAnts/GUI.rb

@@ -377,7 +377,7 @@ module RUtilAnts
 
     end
 
-    # Initialize the GUI methods in the Kernel namespace
+    # Initialize the GUI methods in the Object namespace
     def self.initializeGUI
       Object.module_eval('include RUtilAnts::GUI')
     end

data/lib/rUtilAnts/Logging.rb

@@ -65,6 +65,22 @@ module RUtilAnts
         end
       end
 
+      # Mute or unmute standard output
+      #
+      # Parameters:
+      # * *iMute* (_Boolean_): Do we mute standard output ? [optional = true]
+      def muteStdOut(iMute = true)
+        @ScreenOutput = (!iMute)
+      end
+
+      # Mute or unmute error output
+      #
+      # Parameters:
+      # * *iMute* (_Boolean_): Do we mute error output ? [optional = true]
+      def muteStdErr(iMute = true)
+        @ScreenOutputErr = (!iMute)
+      end
+
       # Set the log file to use (can be nil to stop logging into a file)
       #
       # Parameters:
@@ -73,6 +89,30 @@ module RUtilAnts
         @LogFile = iFileName
       end
 
+      # Get the log file used (can be nil)
+      #
+      # Return:
+      # * _String_: Log file name (can be nil)
+      def getLogFile
+        return @LogFile
+      end
+
+      # Get the library root dir
+      #
+      # Return:
+      # * _String_: The library root dir, as defined when initialized
+      def getLibRootDir
+        return @LibRootDir
+      end
+
+      # Get the bug tracker URL
+      #
+      # Return:
+      # * _String_: The bug tracker URL, as defined when initialized
+      def getBugTrackerURL
+        return @BugTrackerURL
+      end
+
       # Indicate which GUI to be used to display dialogs.
       #
       # Parameters:
@@ -86,14 +126,24 @@ module RUtilAnts
       # Parameters:
       # * *iDebugMode* (_Boolean_): Are we in debug mode ?
       def activateLogDebug(iDebugMode)
-        @DebugMode = iDebugMode
-        if (iDebugMode)
-          logInfo 'Activated log debug'
-        else
-          logInfo 'Deactivated log debug'
+        if (@DebugMode != iDebugMode)
+          @DebugMode = iDebugMode
+          if (iDebugMode)
+            logInfo 'Activated log debug'
+          else
+            logInfo 'Deactivated log debug'
+          end
         end
       end
 
+      # Is debug mode activated ?
+      #
+      # Return:
+      # * _Boolean_: Are we in debug mode ?
+      def debugActivated?
+        return @DebugMode
+      end
+
       # Set the stack of the errors to fill.
       # If set to nil, errors will be displayed as they appear.
       # If set to a stack, errors will silently be added to the list.
@@ -147,7 +197,7 @@ Stack:
         # Display Bug dialog
         if (showModalWxAvailable?)
           # We require the file here, as we hope it will not be required often
-          require 'RUtilAnts/GUI/BugReportDialog'
+          require 'rUtilAnts/GUI/BugReportDialog'
           showModal(GUI::BugReportDialog, nil, lCompleteMsg, @BugTrackerURL) do |iModalResult, iDialog|
             # Nothing to do
           end
@@ -175,12 +225,13 @@ Details:
       # Parameters:
       # * *iMsg* (_String_): Message to log
       def logErr(iMsg)
+        lMsg = "!!! ERR !!! #{iMsg}"
         # Log into stderr
         if (@ScreenOutputErr)
-          $stderr << "!!! ERR !!! #{iMsg}\n"
+          $stderr << "#{lMsg}\n"
         end
         if (@LogFile != nil)
-          logFile(iMsg)
+          logFile(lMsg)
         end
         # Display dialog only if we are not redirecting messages to a stack
         if (@ErrorsStack == nil)
@@ -249,6 +300,22 @@ Details:
         end
       end
 
+      # Log a warning.
+      # Warnings are not errors but still should be highlighted.
+      #
+      # Parameters:
+      # * *iMsg* (_String_): Message to log
+      def logWarn(iMsg)
+        # Log into stdout
+        lMsg = "!!! WARNING !!! - #{iMsg}"
+        if (@ScreenOutput)
+          $stdout << "#{lMsg}\n"
+        end
+        if (@LogFile != nil)
+          logFile(lMsg)
+        end
+      end
+
       # Log a debugging info.
       # This is used when debug is activated
       #
@@ -292,36 +359,38 @@ Details:
       # Remove @LibRootDir paths from it.
       #
       # Parameters:
-      # * *iCaller* (<em>list<String></em>): The caller
+      # * *iCaller* (<em>list<String></em>): The caller, or nil if no caller
       # * *iReferenceCaller* (<em>list<String></em>): The reference caller: we will not display lines from iCaller that also belong to iReferenceCaller [optional = nil]
       # Return:
       # * <em>list<String></em>): The simple stack
       def getSimpleCaller(iCaller, iReferenceCaller = nil)
         rSimpleCaller = []
 
-        lCaller = nil
-        # If there is a reference caller, remove the lines from lCaller that are also in iReferenceCaller
-        if (iReferenceCaller == nil)
-          lCaller = iCaller
-        else
-          lIdxCaller = iCaller.size - 1
-          lIdxRef = iReferenceCaller.size - 1
-          while ((lIdxCaller >= 0) and
-                 (lIdxRef >= 0) and
-                 (iCaller[lIdxCaller] == iReferenceCaller[lIdxRef]))
-            lIdxCaller -= 1
-            lIdxRef -= 1
-          end
-          # Here we have either one of the indexes that is -1, or the indexes point to different lines between the caller and its reference.
-          lCaller = iCaller[0..lIdxCaller+1]
-        end
-        lCaller.each do |iCallerLine|
-          lMatch = iCallerLine.match(/^(.*):([[:digit:]]*):in (.*)$/)
-          if (lMatch == nil)
-            # Did not get which format. Just add it blindly.
-            rSimpleCaller << iCallerLine
+        if (iCaller != nil)
+          lCaller = nil
+          # If there is a reference caller, remove the lines from lCaller that are also in iReferenceCaller
+          if (iReferenceCaller == nil)
+            lCaller = iCaller
           else
-            rSimpleCaller << "#{File.expand_path(lMatch[1]).gsub(@LibRootDir, '')}:#{lMatch[2]}:in #{lMatch[3]}"
+            lIdxCaller = iCaller.size - 1
+            lIdxRef = iReferenceCaller.size - 1
+            while ((lIdxCaller >= 0) and
+                   (lIdxRef >= 0) and
+                   (iCaller[lIdxCaller] == iReferenceCaller[lIdxRef]))
+              lIdxCaller -= 1
+              lIdxRef -= 1
+            end
+            # Here we have either one of the indexes that is -1, or the indexes point to different lines between the caller and its reference.
+            lCaller = iCaller[0..lIdxCaller+1]
+          end
+          lCaller.each do |iCallerLine|
+            lMatch = iCallerLine.match(/^(.*):([[:digit:]]*):in (.*)$/)
+            if (lMatch == nil)
+              # Did not get which format. Just add it blindly.
+              rSimpleCaller << iCallerLine
+            else
+              rSimpleCaller << "#{File.expand_path(lMatch[1]).gsub(@LibRootDir, '')}:#{lMatch[2]}:in #{lMatch[3]}"
+            end
           end
         end
 
@@ -340,10 +409,26 @@ Details:
     # * *iSilentOutputs* (_Boolean_): Do we silent outputs (nothing sent to $stdout or $stderr) ? [optional = false]
     def self.initializeLogging(iLibRootDir, iBugTrackerURL, iSilentOutputs = false)
       $rUtilAnts_Logging_Logger = RUtilAnts::Logging::Logger.new(iLibRootDir, iBugTrackerURL, iSilentOutputs)
-      # Add the module accessible from the Kernel
+      # Add the module accessible from the Object namespace
       Object.module_eval('include RUtilAnts::Logging')
     end
 
+    # Mute or unmute standard output
+    #
+    # Parameters:
+    # * *iMute* (_Boolean_): Do we mute standard output ? [optional = true]
+    def muteStdOut(iMute = true)
+      $rUtilAnts_Logging_Logger.muteStdOut(iMute)
+    end
+
+    # Mute or unmute error output
+    #
+    # Parameters:
+    # * *iMute* (_Boolean_): Do we mute error output ? [optional = true]
+    def muteStdErr(iMute = true)
+      $rUtilAnts_Logging_Logger.muteStdErr(iMute)
+    end
+
     # Set the log file to use (can be nil to stop logging into a file)
     #
     # Parameters:
@@ -352,6 +437,30 @@ Details:
       $rUtilAnts_Logging_Logger.setLogFile(iFileName)
     end
 
+    # Get the log file used (can be nil)
+    #
+    # Return:
+    # * _String_: Log file name (can be nil)
+    def getLogFile
+      return $rUtilAnts_Logging_Logger.getLogFile
+    end
+
+    # Get the library root dir
+    #
+    # Return:
+    # * _String_: The library root dir, as defined when initialized
+    def getLibRootDir
+      return $rUtilAnts_Logging_Logger.getLibRootDir
+    end
+
+    # Get the bug tracker URL
+    #
+    # Return:
+    # * _String_: The bug tracker URL, as defined when initialized
+    def getBugTrackerURL
+      return $rUtilAnts_Logging_Logger.getBugTrackerURL
+    end
+
     # Indicate which GUI to be used to display dialogs.
     #
     # Parameters:
@@ -368,6 +477,14 @@ Details:
       $rUtilAnts_Logging_Logger.activateLogDebug(iDebugMode)
     end
 
+    # Is debug mode activated ?
+    #
+    # Return:
+    # * _Boolean_: Are we in debug mode ?
+    def debugActivated?
+      return $rUtilAnts_Logging_Logger.debugActivated?
+    end
+
     # Set the stack of the errors to fill.
     # If set to nil, errors will be displayed as they appear.
     # If set to a stack, errors will silently be added to the list.
@@ -434,6 +551,15 @@ Details:
       $rUtilAnts_Logging_Logger.logInfo(iMsg)
     end
 
+    # Log a warning.
+    # Warnings are not errors but still should be highlighted.
+    #
+    # Parameters:
+    # * *iMsg* (_String_): Message to log
+    def logWarn(iMsg)
+      $rUtilAnts_Logging_Logger.logWarn(iMsg)
+    end
+
     # Log a debugging info.
     # This is used when debug is activated
     #

data/lib/rUtilAnts/Misc.rb

@@ -7,7 +7,7 @@ module RUtilAnts
 
   module Misc
 
-    # Set these methods into the Kernel namespace
+    # Set these methods into the Object namespace
     def self.initializeMisc
       Object.module_eval('include RUtilAnts::Misc')
     end
@@ -127,6 +127,24 @@ module RUtilAnts
       return rError
     end
 
+    # Execute a code block after having changed current directory.
+    # Ensure the directory will be changed back at the end of the block, even if exceptions are thrown.
+    #
+    # Parameters:
+    # * *iDir* (_String_): The directory to change into
+    # * *CodeBlock*: Code called once the current directory has been changed
+    def changeDir(iDir)
+      lOldDir = Dir.getwd
+      Dir.chdir(iDir)
+      begin
+        yield
+      rescue Exception
+        Dir.chdir(lOldDir)
+        raise
+      end
+      Dir.chdir(lOldDir)
+    end
+
   end
 
 end

data/lib/rUtilAnts/Platform.rb

@@ -15,10 +15,14 @@ module RUtilAnts
     def self.initializePlatform
       # Require the platform info
       begin
-        require "RUtilAnts/Platforms/#{RUBY_PLATFORM}/PlatformInfo"
+        require "rUtilAnts/Platforms/#{RUBY_PLATFORM}/PlatformInfo"
       rescue Exception
-        logBug "Current platform #{RUBY_PLATFORM} is not supported."
-        raise RuntimeError, "Current platform #{RUBY_PLATFORM} is not supported."
+        if (!defined?(logBug))
+          require 'rUtilAnts/Logging'
+          RUtilAnts::Logging::initializeLogging(File.expand_path(File.dirname(__FILE__)), '')
+        end
+        logBug "Current platform #{RUBY_PLATFORM} is not supported (#{$!})."
+        raise RuntimeError, "Current platform #{RUBY_PLATFORM} is not supported (#{$!})."
       end
       # Create the corresponding object
       $rUtilAnts_Platform_Info = PlatformInfo.new

data/lib/rUtilAnts/Platforms/i386-mswin32/PlatformInfo.rb

@@ -40,7 +40,13 @@ module RUtilAnts
       # Return:
       # * <em>list<String></em>: List of extensions (including .)
       def getDiscreteExeExtensions
-        return [ '.exe', '.com', '.bat' ]
+        rExtList = []
+
+        ENV['PATHEXT'].split(';').each do |iExt|
+          rExtList << iExt.downcase
+        end
+
+        return rExtList
       end
 
       # Return the list of directories where we look for libraries
@@ -64,11 +70,12 @@ module RUtilAnts
       # Parameters:
       # * *iMsg* (_String_): The message to display
       def sendMsg(iMsg)
-        # !!! iMsg must not be longer than 256 characters
-        if (iMsg.size > 256)
-          system("msg \"#{ENV['USERNAME']}\" /W #{iMsg[0..255]}")
+        # iMsg must not be longer than 255 characters
+        # \n must be escaped.
+        if (iMsg.size > 255)
+          system("msg \"#{ENV['USERNAME']}\" /W \"#{iMsg[0..254]}\"")
         else
-          system("msg \"#{ENV['USERNAME']}\" /W #{iMsg}")
+          system("msg \"#{ENV['USERNAME']}\" /W \"#{iMsg}\"")
         end
       end
 

data/lib/rUtilAnts/Platforms/x86_64-linux/PlatformInfo.rb

@@ -0,0 +1,149 @@
+#--
+# Copyright (c) 2009 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Licensed under the terms specified in LICENSE file. No warranty is provided.
+#++
+
+module RUtilAnts
+
+  module Platform
+
+    class PlatformInfo
+
+      # Return the ID of the OS
+      # Applications may adapt their behavior based on it.
+      #
+      # Return:
+      # * _Integer_: OS ID
+      def os
+        return OS_LINUX
+      end
+
+      # Return the list of directories where we look for executables
+      #
+      # Return:
+      # * <em>list<String></em>: List of directories
+      def getSystemExePath
+        return ENV['PATH'].split(':')
+      end
+
+      # Set the list of directories where we look for executables
+      #
+      # Parameters:
+      # * *iNewDirsList* (<em>list<String></em>): List of directories
+      def setSystemExePath(iNewDirsList)
+        ENV['PATH'] = iNewDirsList.join(':')
+      end
+
+      # Return the list of file extensions that might be discretely happened to executable files.
+      # This is the optional extensions that can be happened when invoked from a terminal.
+      #
+      # Return:
+      # * <em>list<String></em>: List of extensions (including .)
+      def getDiscreteExeExtensions
+        return []
+      end
+
+      # Return the list of directories where we look for libraries
+      #
+      # Return:
+      # * <em>list<String></em>: List of directories
+      def getSystemLibsPath
+        rList = ENV['PATH'].split(':')
+
+        if (ENV['LD_LIBRARY_PATH'] != nil)
+          rList += ENV['LD_LIBRARY_PATH'].split(':')
+        end
+
+        return rList
+      end
+
+      # Set the list of directories where we look for libraries
+      #
+      # Parameters:
+      # * *iNewDirsList* (<em>list<String></em>): List of directories
+      def setSystemLibsPath(iNewDirsList)
+        ENV['LD_LIBRARY_PATH'] = iNewDirsList.join(':')
+      end
+
+      # This method sends a message (platform dependent) to the user, without the use of wxruby
+      #
+      # Parameters:
+      # * *iMsg* (_String_): The message to display
+      def sendMsg(iMsg)
+        # TODO: Handle case of xmessage not installed
+        # Create a temporary file with the content to display
+        require 'tmpdir'
+        lTmpFileName = "#{Dir.tmpdir}/RUA_MSG"
+        File.open(lTmpFileName, 'w') do |oFile|
+          oFile.write(iMsg)
+        end
+        system("xmessage -file #{lTmpFileName}")
+        File.unlink(lTmpFileName)
+      end
+
+      # Execute a Shell command.
+      # Do not wait for its termination.
+      #
+      # Parameters:
+      # * *iCmd* (_String_): The command to execute
+      # * *iInTerminal* (_Boolean_): Do we execute this command in a separate terminal ?
+      # Return:
+      # * _Exception_: Error, or nil if success
+      def execShellCmdNoWait(iCmd, iInTerminal)
+        rException = nil
+
+        if (iInTerminal)
+          # TODO: Handle case of xterm not installed
+          if (!system("xterm -e \"#{iCmd}\""))
+            rException = RuntimeError.new
+          end
+        else
+          begin
+            IO.popen(iCmd)
+          rescue Exception
+            rException = $!
+          end
+        end
+
+        return rException
+      end
+
+      # Execute a given URL to be launched in a browser
+      #
+      # Parameters:
+      # * *iURL* (_String_): The URL to launch
+      # Return:
+      # * _String_: Error message, or nil if success
+      def launchURL(iURL)
+        rError = nil
+
+        begin
+          IO.popen("xdg-open '#{iURL}'")
+        rescue Exception
+          rError = $!.to_s
+        end
+
+        return rError
+      end
+
+      # Get file extensions specifics to executable files
+      #
+      # Return:
+      # * <em>list<String></em>: List of extensions (including . character). It can be empty.
+      def getExecutableExtensions
+        return []
+      end
+
+      # Get prohibited characters from file names
+      #
+      # Return:
+      # * _String_: String of prohibited characters in file names
+      def getProhibitedFileNamesCharacters
+        return '/'
+      end
+
+    end
+
+  end
+
+end

data/lib/rUtilAnts/URLAccess.rb

@@ -27,10 +27,10 @@ module RUtilAnts
         # map< String, [ list<Regexp>, String ] >
         # map< PluginName, [ List of matching regexps, Plugin class name ] >
         @Plugins = {}
-        Dir.glob("#{File.dirname(__FILE__)}/URLHandlers/*.rb").each do |iFileName|
+        Dir.glob(File.expand_path("#{File.dirname(__FILE__)}/URLHandlers/*.rb")).each do |iFileName|
           begin
             lPluginName = File.basename(iFileName)[0..-4]
-            require "RUtilAnts/URLHandlers/#{lPluginName}"
+            require "rUtilAnts/URLHandlers/#{lPluginName}"
             @Plugins[lPluginName] = [
               eval("RUtilAnts::URLCache::URLHandlers::#{lPluginName}::getMatchingRegexps"),
               "RUtilAnts::URLCache::URLHandlers::#{lPluginName}"
@@ -55,8 +55,10 @@ module RUtilAnts
       # * _CodeBlock_: The code returning the object corresponding to the content:
       # ** *iContent* (_String_): File content, or file name if :LocalFileAccess was true
       # ** *iFileBaseName* (_String_): The base name the file could have. Useful to get file name extensions.
-      # ** Returns:
+      # ** Return:
       # ** _Exception_: The error encountered, or nil in case of success
+      # Return:
+      # * _Exception_: The error encountered, or nil in case of success
       def accessFile(iURL, iParameters = {})
         rError = nil
 
@@ -200,13 +202,15 @@ module RUtilAnts
     # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
     # ** *:FollowRedirections* (_Boolean_): Do we follow redirections ? [optional = true]
     # ** *:NbrRedirectionsAllowed* (_Integer_): Number of redirections allowed [optional = 10]
-    # ** *:LocalFileAccess* (_Boolean_): Do we need a local file to read the content from ? If not, the content itslef will be given the code block. [optional = false]
+    # ** *:LocalFileAccess* (_Boolean_): Do we need a local file to read the content from ? If not, the content itself will be given the code block. [optional = false]
     # ** *:URLHandler* (_Object_): The URL handler, if it has already been instantiated, or nil otherwise [optional = nil]
     # * _CodeBlock_: The code returning the object corresponding to the content:
     # ** *iContent* (_String_): File content, or file name if :LocalFileAccess was true
     # ** *iFileBaseName* (_String_): The base name the file could have. Useful to get file name extensions.
-    # ** Returns:
+    # ** Return:
     # ** _Exception_: The error encountered, or nil in case of success
+    # Return:
+    # * _Exception_: The error encountered, or nil in case of success
     def accessFile(iURL, iParameters = {})
       return $rUtilAnts_URLAccess_Manager.accessFile(iURL, iParameters) do |iContent, iBaseName|
         yield(iContent, iBaseName)

data/lib/rUtilAnts/URLHandlers/HTTP.rb

@@ -85,7 +85,8 @@ module RUtilAnts
           begin
             require 'net/http'
             Net::HTTP.start(@URLServer) do |iHTTPConnection|
-              lResponse = iHTTPConnection.get("/#{@URLPath}")
+              # Some websites filter out the default user agent (commons.mediawiki.org for example). Set another one.
+              lResponse = iHTTPConnection.request_get("/#{@URLPath}", {'User-Agent' => 'RUtilAnts'})
               if ((iFollowRedirections) and
                   (lResponse.is_a?(Net::HTTPRedirection)))
                 # We access the file through a new URL

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rUtilAnts
 version: !ruby/object:Gem::Version 
-  version: 0.1.1.20091105
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  - 20101109
+  version: 0.2.0.20101109
 platform: ruby
 authors: 
 - Muriel Salvan
@@ -9,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-05 00:00:00 +01:00
+date: 2010-11-09 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
@@ -22,20 +28,6 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- ReleaseInfo
-- README
-- LICENSE
-- AUTHORS
-- Credits
-- TODO
-- ChangeLog
-- lib/rUtilAnts/Plugins.rb
-- lib/rUtilAnts/GUI.rb
-- lib/rUtilAnts/Platform.rb
-- lib/rUtilAnts/URLAccess.rb
-- lib/rUtilAnts/Logging.rb
-- lib/rUtilAnts/URLCache.rb
-- lib/rUtilAnts/Misc.rb
 - lib/rUtilAnts/URLHandlers/HTTP.rb
 - lib/rUtilAnts/URLHandlers/FTP.rb
 - lib/rUtilAnts/URLHandlers/LocalFile.rb
@@ -44,6 +36,22 @@ files:
 - lib/rUtilAnts/GUI/BugReportDialog.rb
 - lib/rUtilAnts/Platforms/i386-linux/PlatformInfo.rb
 - lib/rUtilAnts/Platforms/i386-mswin32/PlatformInfo.rb
+- lib/rUtilAnts/Platforms/x86_64-linux/PlatformInfo.rb
+- lib/rUtilAnts/Plugins.rb
+- lib/rUtilAnts/GUI.rb
+- lib/rUtilAnts/Platform.rb
+- lib/rUtilAnts/URLAccess.rb
+- lib/rUtilAnts/Logging.rb
+- lib/rUtilAnts/URLCache.rb
+- lib/rUtilAnts/Misc.rb
+- lib/rUtilAnts/ForeignProcess.rb
+- ReleaseInfo
+- README
+- LICENSE
+- AUTHORS
+- Credits
+- TODO
+- ChangeLog
 has_rdoc: true
 homepage: http://rutilants.sourceforge.net/
 licenses: []
@@ -57,18 +65,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: rutilants
-rubygems_version: 1.3.2
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: A collection of various utility libraries.