rUtilAnts 0.3.0.20110825 → 1.0.0.20120223

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

@@ -1,5 +1,5 @@
 #--
-# Copyright (c) 2009 - 2011 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Copyright (c) 2009 - 2012 Muriel Salvan (muriel@x-aeon.com)
 # Licensed under the terms specified in LICENSE file. No warranty is provided.
 #++
 
@@ -7,12 +7,12 @@ module RUtilAnts
 
   module Platform
 
-    class PlatformInfo
+    module PlatformInfo
 
       # Return the ID of the OS
       # Applications may adapt their behavior based on it.
       #
-      # Return:
+      # Return::
       # * _Integer_: OS ID
       def os
         return OS_WINDOWS
@@ -20,7 +20,7 @@ module RUtilAnts
 
       # Return the list of directories where we look for executables
       #
-      # Return:
+      # Return::
       # * <em>list<String></em>: List of directories
       def getSystemExePath
         return ENV['PATH'].split(';')
@@ -28,7 +28,7 @@ module RUtilAnts
 
       # Set the list of directories where we look for executables
       #
-      # Parameters:
+      # Parameters::
       # * *iNewDirsList* (<em>list<String></em>): List of directories
       def setSystemExePath(iNewDirsList)
         ENV['PATH'] = iNewDirsList.join(';')
@@ -37,7 +37,7 @@ module RUtilAnts
       # 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:
+      # Return::
       # * <em>list<String></em>: List of extensions (including .)
       def getDiscreteExeExtensions
         rExtList = []
@@ -51,7 +51,7 @@ module RUtilAnts
 
       # Return the list of directories where we look for libraries
       #
-      # Return:
+      # Return::
       # * <em>list<String></em>: List of directories
       def getSystemLibsPath
         return ENV['PATH'].split(';')
@@ -59,7 +59,7 @@ module RUtilAnts
 
       # Set the list of directories where we look for libraries
       #
-      # Parameters:
+      # Parameters::
       # * *iNewDirsList* (<em>list<String></em>): List of directories
       def setSystemLibsPath(iNewDirsList)
         ENV['PATH'] = iNewDirsList.join(';')
@@ -67,7 +67,7 @@ module RUtilAnts
 
       # This method sends a message (platform dependent) to the user, without the use of wxruby
       #
-      # Parameters:
+      # Parameters::
       # * *iMsg* (_String_): The message to display
       def sendMsg(iMsg)
         # iMsg must not be longer than 255 characters
@@ -82,10 +82,10 @@ module RUtilAnts
       # Execute a Shell command.
       # Do not wait for its termination.
       #
-      # Parameters:
+      # Parameters::
       # * *iCmd* (_String_): The command to execute
       # * *iInTerminal* (_Boolean_): Do we execute this command in a separate terminal ?
-      # Return:
+      # Return::
       # * _Exception_: Error, or nil if success
       def execShellCmdNoWait(iCmd, iInTerminal)
         rException = nil
@@ -107,9 +107,9 @@ module RUtilAnts
 
       # Execute a given URL to be launched in a browser
       #
-      # Parameters:
+      # Parameters::
       # * *iURL* (_String_): The URL to launch
-      # Return:
+      # Return::
       # * _String_: Error message, or nil if success
       def launchURL(iURL)
         rError = nil
@@ -127,21 +127,62 @@ module RUtilAnts
 
       # Get file extensions specifics to executable files
       #
-      # Return:
+      # Return::
       # * <em>list<String></em>: List of extensions (including . character). It can be empty.
       def getExecutableExtensions
-        # TODO: Use PATHEXT environment variable if possible
-        return [ '.exe', '.com', '.bat' ]
+        rLstExt = [ '.exe', '.com', '.bat' ]
+
+        # Use PATHEXT environment variable if possible
+        if (ENV['PATHEXT'] != nil)
+          rLstExt.concat(ENV['PATHEXT'].split(';').map { |iExt| iExt.downcase })
+          rLstExt.uniq!
+        end
+
+        return rLstExt
       end
 
       # Get prohibited characters from file names
       #
-      # Return:
+      # Return::
       # * _String_: String of prohibited characters in file names
       def getProhibitedFileNamesCharacters
         return '\\/:*?"<>|'
       end
 
+      # Create a shortcut (ln -s on Cygwin/Unix systems, a .lnk file on Windows systems)
+      #
+      # Parameters::
+      # * *iSrc* (_String_): The source file
+      # * *iDst* (_String_): The destination file
+      def createShortcut(iSrc, iDst)
+        require 'win32/shortcut'
+        Win32::Shortcut.new(getShortcutFileName(iDst)) do |oShortcut|
+          oShortcut.path = File.expand_path(iSrc)
+        end
+      end
+
+      # Get the name of a real file name, pointed by a shortcut.
+      # On Windows systems, it will be the target of the lnk file.
+      #
+      # Parameters::
+      # * *iShortcutName* (_String_): Name of the shortcut (same name used by createShortcut). Don't use OS specific extensions in this name (no .lnk).
+      # Return::
+      # * _String_: The real file name pointed by this shortcut
+      def followShortcut(iShortcutName)
+        require 'win32/shortcut'
+        return Win32::Shortcut.open(getShortcutFileName(iShortcutName)).path
+      end
+
+      # Get the real file name of a shortcut
+      #
+      # Parameters::
+      # * *iDst* (_String_): The destination file that will host the shortcut
+      # Return::
+      # * _String_: The real shortcut file name
+      def getShortcutFileName(iDst)
+        return "#{iDst}.lnk"
+      end
+
     end
 
   end

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

@@ -1,5 +1,5 @@
 #--
-# Copyright (c) 2009 - 2011 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Copyright (c) 2009 - 2012 Muriel Salvan (muriel@x-aeon.com)
 # Licensed under the terms specified in LICENSE file. No warranty is provided.
 #++
 
@@ -7,12 +7,12 @@ module RUtilAnts
 
   module Platform
 
-    class PlatformInfo
+    module PlatformInfo
 
       # Return the ID of the OS
       # Applications may adapt their behavior based on it.
       #
-      # Return:
+      # Return::
       # * _Integer_: OS ID
       def os
         return OS_LINUX
@@ -20,7 +20,7 @@ module RUtilAnts
 
       # Return the list of directories where we look for executables
       #
-      # Return:
+      # Return::
       # * <em>list<String></em>: List of directories
       def getSystemExePath
         return ENV['PATH'].split(':')
@@ -28,7 +28,7 @@ module RUtilAnts
 
       # Set the list of directories where we look for executables
       #
-      # Parameters:
+      # Parameters::
       # * *iNewDirsList* (<em>list<String></em>): List of directories
       def setSystemExePath(iNewDirsList)
         ENV['PATH'] = iNewDirsList.join(':')
@@ -37,7 +37,7 @@ module RUtilAnts
       # 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:
+      # Return::
       # * <em>list<String></em>: List of extensions (including .)
       def getDiscreteExeExtensions
         return []
@@ -45,7 +45,7 @@ module RUtilAnts
 
       # Return the list of directories where we look for libraries
       #
-      # Return:
+      # Return::
       # * <em>list<String></em>: List of directories
       def getSystemLibsPath
         rList = ENV['PATH'].split(':')
@@ -59,7 +59,7 @@ module RUtilAnts
 
       # Set the list of directories where we look for libraries
       #
-      # Parameters:
+      # Parameters::
       # * *iNewDirsList* (<em>list<String></em>): List of directories
       def setSystemLibsPath(iNewDirsList)
         ENV['LD_LIBRARY_PATH'] = iNewDirsList.join(':')
@@ -67,7 +67,7 @@ module RUtilAnts
 
       # This method sends a message (platform dependent) to the user, without the use of wxruby
       #
-      # Parameters:
+      # Parameters::
       # * *iMsg* (_String_): The message to display
       def sendMsg(iMsg)
         # TODO: Handle case of xmessage not installed
@@ -84,10 +84,10 @@ module RUtilAnts
       # Execute a Shell command.
       # Do not wait for its termination.
       #
-      # Parameters:
+      # Parameters::
       # * *iCmd* (_String_): The command to execute
       # * *iInTerminal* (_Boolean_): Do we execute this command in a separate terminal ?
-      # Return:
+      # Return::
       # * _Exception_: Error, or nil if success
       def execShellCmdNoWait(iCmd, iInTerminal)
         rException = nil
@@ -110,9 +110,9 @@ module RUtilAnts
 
       # Execute a given URL to be launched in a browser
       #
-      # Parameters:
+      # Parameters::
       # * *iURL* (_String_): The URL to launch
-      # Return:
+      # Return::
       # * _String_: Error message, or nil if success
       def launchURL(iURL)
         rError = nil
@@ -128,7 +128,7 @@ module RUtilAnts
 
       # Get file extensions specifics to executable files
       #
-      # Return:
+      # Return::
       # * <em>list<String></em>: List of extensions (including . character). It can be empty.
       def getExecutableExtensions
         return []
@@ -136,12 +136,43 @@ module RUtilAnts
 
       # Get prohibited characters from file names
       #
-      # Return:
+      # Return::
       # * _String_: String of prohibited characters in file names
       def getProhibitedFileNamesCharacters
         return '/'
       end
 
+      # Create a shortcut (ln -s on Cygwin/Unix systems, a .lnk file on Windows systems)
+      #
+      # Parameters::
+      # * *iSrc* (_String_): The source file
+      # * *iDst* (_String_): The destination file
+      def createShortcut(iSrc, iDst)
+        require 'fileutils'
+        FileUtils::ln_s(iSrc, iDst)
+      end
+
+      # Get the name of a real file name, pointed by a shortcut.
+      # On Windows systems, it will be the target of the lnk file.
+      #
+      # Parameters::
+      # * *iShortcutName* (_String_): Name of the shortcut (same name used by createShortcut). Don't use OS specific extensions in this name (no .lnk).
+      # Return::
+      # * _String_: The real file name pointed by this shortcut
+      def followShortcut(iShortcutName)
+        return File.readlink(iShortcutName)
+      end
+
+      # Get the real file name of a shortcut
+      #
+      # Parameters::
+      # * *iDst* (_String_): The destination file that will host the shortcut
+      # Return::
+      # * _String_: The real shortcut file name
+      def getShortcutFileName(iDst)
+        return iDst
+      end
+
     end
 
   end

data/lib/rUtilAnts/Plugins.rb

@@ -1,5 +1,5 @@
 #--
-# Copyright (c) 2009 - 2011 Muriel Salvan (murielsalvan@users.sourceforge.net)
+# Copyright (c) 2009 - 2012 Muriel Salvan (muriel@x-aeon.com)
 # Licensed under the terms specified in LICENSE file. No warranty is provided.
 #++
 
@@ -53,11 +53,10 @@ module RUtilAnts
     class PluginDependenciesUnresolvedError < RuntimeError
     end
 
-    # Main class storing info about plugins
-    class PluginsManager
+    module PluginsInterface
 
       # Constructor
-      def initialize
+      def init_plugins
         # Map of plugins, per category
         # map< String, map< String, map< Symbol, Object > > >
         @Plugins = {}
@@ -65,14 +64,14 @@ module RUtilAnts
 
       # Register a new plugin
       #
-      # Parameters:
+      # Parameters::
       # * *iCategoryName* (_String_): Category this plugin belongs to
       # * *iPluginName* (_String_): Plugin name
       # * *iFileName* (_String_): File name containing the plugin (can be nil)
       # * *iDesc* (<em>map<Symbol,Object></em>): Plugin's description (can be nil)
       # * *iClassName* (_String_): Name of the plugin class
       # * *iInitCodeBlock* (_Proc_): Code block to call when initializing the real instance (can be nil)
-      def registerNewPlugin(iCategoryName, iPluginName, iFileName, iDesc, iClassName, iInitCodeBlock)
+      def register_new_plugin(iCategoryName, iPluginName, iFileName, iDesc, iClassName, iInitCodeBlock)
         # Complete the description with some metadata
         if (@Plugins[iCategoryName] == nil)
           @Plugins[iCategoryName] = {}
@@ -95,13 +94,13 @@ module RUtilAnts
 
       # Parse plugins from a given directory
       #
-      # Parameters:
+      # Parameters::
       # * *iCategory* (_Object_): Category those plugins will belong to
       # * *iDir* (_String_): Directory to parse for plugins
       # * *iBaseClassNames* (_String_): The base class name of plugins to be instantiated
       # * *iInitCodeBlock* (_CodeBlock_): Code to be executed first time the plugin will be instantiated (can be ommitted):
-      # ** *ioPlugin* (_Object_): Plugin instance
-      def parsePluginsFromDir(iCategory, iDir, iBaseClassNames, &iInitCodeBlock)
+      #   * *ioPlugin* (_Object_): Plugin instance
+      def parse_plugins_from_dir(iCategory, iDir, iBaseClassNames, &iInitCodeBlock)
         # Gather descriptions
         # map< String, map >
         lDescriptions = {}
@@ -115,11 +114,11 @@ module RUtilAnts
               if (lDesc.is_a?(Hash))
                 lDescriptions[lPluginName] = lDesc
               else
-                logBug "Plugin description #{iFileName} is incorrect. The file should just describe a simple hash map."
+                log_bug "Plugin description #{iFileName} is incorrect. The file should just describe a simple hash map."
               end
             end
           rescue Exception
-            logExc $!, "Error while loading file #{iFileName}. Ignoring this description."
+            log_exc $!, "Error while loading file #{iFileName}. Ignoring this description."
           end
         end
         # Now, parse the plugins themselves
@@ -132,7 +131,7 @@ module RUtilAnts
           if (@Plugins[iCategory][lPluginName] == nil)
             # Check if we have a description
             lDesc = lDescriptions[lPluginName]
-            registerNewPlugin(
+            register_new_plugin(
               iCategory,
               lPluginName,
               iFileName,
@@ -141,7 +140,7 @@ module RUtilAnts
               iInitCodeBlock
             )
           else
-            logErr "Plugin named #{lPluginName} in category #{iCategory} already exists. Please name it differently. Ignoring it from #{iFileName}."
+            log_warn "Plugin named #{lPluginName} in category #{iCategory} already exists. Please name it differently. Ignoring it from #{iFileName}."
           end
         end
       end
@@ -149,17 +148,17 @@ module RUtilAnts
       # Get the named plugin instance.
       # Uses RDI if given in parameters or if Main RDI Installer defined to resolve Plugins' dependencies.
       #
-      # Parameters:
+      # Parameters::
       # * *iCategory* (_Object_): Category those plugins will belong to
       # * *iPluginName* (_String_): Plugin name
       # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-      # ** *OnlyIfExtDepsResolved* (_Boolean_): Do we return the plugin only if there is no need to install external dependencies ? [optional = false]
-      # ** *RDIInstaller* (<em>RDI::Installer</em>): The RDI installer if available, or nil otherwise [optional = nil]
-      # ** *RDIContextModifiers* (<em>map<String,list<[String,Object]>></em>): The map of context modifiers to be filled by the RDI installer if specified, or nil if ignored [optional = nil]
-      # Return:
+      #   * *OnlyIfExtDepsResolved* (_Boolean_): Do we return the plugin only if there is no need to install external dependencies ? [optional = false]
+      #   * *RDIInstaller* (<em>RDI::Installer</em>): The RDI installer if available, or nil otherwise [optional = nil]
+      #   * *RDIContextModifiers* (<em>map<String,list< [String,Object] >></em>): The map of context modifiers to be filled by the RDI installer if specified, or nil if ignored [optional = nil]
+      # Return::
       # * _Object_: The corresponding plugin, or nil in case of failure
       # * _Exception_: The error, or nil in case of success
-      def getPluginInstance(iCategory, iPluginName, iParameters = {})
+      def get_plugin_instance(iCategory, iPluginName, iParameters = {})
         rPlugin = nil
         rError = nil
 
@@ -185,14 +184,14 @@ module RUtilAnts
                 # If it is not given as parameter, try getting the singleton
                 if ((lRDIInstaller == nil) and
                     (defined?(RDI::Installer) != nil))
-                  lRDIInstaller = RDI::Installer.getMainInstance
+                  lRDIInstaller = RDI::Installer.get_main_instance
                 end
                 if (lRDIInstaller != nil)
                   if (lOnlyIfExtDepsResolved)
                     # Test that each dependency is accessible
                     lSuccess = true
                     lDesc[:Dependencies].each do |iDepDesc|
-                      lSuccess = lRDIInstaller.testDependency(iDepDesc)
+                      lSuccess = lRDIInstaller.test_dependency(iDepDesc)
                       if (!lSuccess)
                         # It is useless to continue
                         break
@@ -200,7 +199,7 @@ module RUtilAnts
                     end
                   else
                     # Load other dependencies
-                    lError, lContextModifiers, lIgnored, lUnresolved = lRDIInstaller.ensureDependencies(lDesc[:Dependencies])
+                    lError, lContextModifiers, lIgnored, lUnresolved = lRDIInstaller.ensure_dependencies(lDesc[:Dependencies])
                     if (lRDIContextModifiers != nil)
                       lRDIContextModifiers.merge!(lContextModifiers)
                     end
@@ -224,7 +223,7 @@ module RUtilAnts
                   # Load other plugins
                   lDesc[:PluginsDependencies].each do |iPluginInfo|
                     iPluginCategory, iPluginName = iPluginInfo
-                    lPlugin, lError = getPluginInstance(iPluginCategory, iPluginName, iParameters)
+                    lPlugin, lError = get_plugin_instance(iPluginCategory, iPluginName, iParameters)
                     lSuccess = (lError == nil)
                     if (!lSuccess)
                       # Don't try further
@@ -267,20 +266,20 @@ module RUtilAnts
 
       # Get the named plugin description
       #
-      # Parameters:
+      # Parameters::
       # * *iCategory* (_Object_): Category those plugins will belong to
       # * *iPluginName* (_String_): Plugin name
-      # Return:
-      # * <em>map<Symbol,Object></em>: The corresponding description, or nil in case of failure
-      def getPluginDescription(iCategory, iPluginName)
+      # Return::
+      # * <em>map<Symbol,Object></em>: The corresponding description
+      def get_plugin_description(iCategory, iPluginName)
         rDesc = nil
 
         if (@Plugins[iCategory] == nil)
-          logErr "Unknown plugins category #{iCategory}."
+          raise UnknownCategoryError.new("Unknown plugins category #{iCategory}.")
         else
           rDesc = @Plugins[iCategory][iPluginName]
           if (rDesc == nil)
-            logErr "Unknown plugin #{iPluginName} in category #{iCategory}."
+            raise UnknownPluginError.new("Unknown plugin #{iPluginName} in category #{iCategory}.")
           end
         end
 
@@ -290,17 +289,17 @@ module RUtilAnts
       # Give access to a plugin.
       # An exception is thrown if the plugin does not exist.
       #
-      # Parameters:
+      # Parameters::
       # * *iCategoryName* (_String_): Category of the plugin to access
       # * *iPluginName* (_String_): Name of the plugin to access
       # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-      # ** *OnlyIfExtDepsResolved* (_Boolean_): Do we return the plugin only if there is no need to install external dependencies ? [optional = false]
-      # ** *RDIInstaller* (<em>RDI::Installer</em>): The RDI installer if available, or nil otherwise [optional = nil]
-      # ** *RDIContextModifiers* (<em>map<String,list<[String,Object]>></em>): The map of context modifiers to be filled by the RDI installer if specified, or nil if ignored [optional = nil]
+      #   * *OnlyIfExtDepsResolved* (_Boolean_): Do we return the plugin only if there is no need to install external dependencies ? [optional = false]
+      #   * *RDIInstaller* (<em>RDI::Installer</em>): The RDI installer if available, or nil otherwise [optional = nil]
+      #   * *RDIContextModifiers* (<em>map<String,list< [String,Object] >></em>): The map of context modifiers to be filled by the RDI installer if specified, or nil if ignored [optional = nil]
       # * *CodeBlock*: The code called when the plugin is found:
-      # ** *ioPlugin* (_Object_): The corresponding plugin
-      def accessPlugin(iCategoryName, iPluginName, iParameters = {})
-        lPlugin, lError = getPluginInstance(iCategoryName, iPluginName, iParameters)
+      #   * *ioPlugin* (_Object_): The corresponding plugin
+      def access_plugin(iCategoryName, iPluginName, iParameters = {})
+        lPlugin, lError = get_plugin_instance(iCategoryName, iPluginName, iParameters)
         if (lPlugin == nil)
           raise lError
         else
@@ -315,13 +314,13 @@ module RUtilAnts
 
       # Get the list of plugin names of a given category
       #
-      # Parameters:
+      # Parameters::
       # * *iCategoryName* (_String_): The category for which we want the plugin names list
       # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-      # ** *IncludeDisabled* (_Boolean_): Do we include disabled plugins ? [optional = false]
-      # Return:
+      #   * *IncludeDisabled* (_Boolean_): Do we include disabled plugins ? [optional = false]
+      # Return::
       # * <em>list<String></em>: The list of plugin names in this category
-      def getPluginNames(iCategoryName, iParameters = {})
+      def get_plugins_names(iCategoryName, iParameters = {})
         rPlugins = []
 
         lIncludeDisabled = iParameters[:IncludeDisabled]
@@ -342,13 +341,13 @@ module RUtilAnts
 
       # Get the map of plugins descriptions, indexed with plugin names
       #
-      # Parameters:
+      # Parameters::
       # * *iCategoryName* (_String_): The category for which we want the plugin names list
       # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-      # ** *IncludeDisabled* (_Boolean_): Do we include disabled plugins ? [optional = false]
-      # Return:
+      #   * *IncludeDisabled* (_Boolean_): Do we include disabled plugins ? [optional = false]
+      # Return::
       # * <em>map<String,map<Symbol,Object>></em>: The map of plugin descriptions per plugin name
-      def getPluginsDescriptions(iCategoryName, iParameters = {})
+      def get_plugins_descriptions(iCategoryName, iParameters = {})
         rPlugins = {}
 
         lIncludeDisabled = iParameters[:IncludeDisabled]
@@ -372,107 +371,23 @@ module RUtilAnts
 
     end
 
-    # Initialize a plugins singleton
-    def self.initializePlugins
-      $rUtilAnts_Plugins_Manager = PluginsManager.new
-      Object.module_eval('include RUtilAnts::Plugins')
-    end
-
-    # Register a new plugin
-    #
-    # Parameters:
-    # * *iCategoryName* (_String_): Category this plugin belongs to
-    # * *iPluginName* (_String_): Plugin name
-    # * *iFileName* (_String_): File name containing the plugin (can be nil)
-    # * *iDesc* (<em>map<Symbol,Object></em>): Plugin's description (can be nil)
-    # * *iClassName* (_String_): Name of the plugin class
-    # * *iInitCodeBlock* (_Proc_): Code block to call when initializing the real instance (can be nil)
-    def registerNewPlugin(iCategoryName, iPluginName, iFileName, iDesc, iClassName, iInitCodeBlock)
-      $rUtilAnts_Plugins_Manager.registerNewPlugin(iCategoryName, iPluginName, iFileName, iDesc, iClassName, iInitCodeBlock)
-    end
-
-    # Parse plugins from a given directory
-    #
-    # Parameters:
-    # * *iCategory* (_Object_): Category those plugins will belong to
-    # * *iDir* (_String_): Directory to parse for plugins
-    # * *iBaseClassNames* (_String_): The base class name of plugins to be instantiated
-    def parsePluginsFromDir(iCategory, iDir, iBaseClassNames)
-      $rUtilAnts_Plugins_Manager.parsePluginsFromDir(iCategory, iDir, iBaseClassNames)
-    end
-
-    # Get the named plugin instance
-    #
-    # Parameters:
-    # * *iCategory* (_Object_): Category those plugins will belong to
-    # * *iPluginName* (_String_): Plugin name
-    # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-    # ** *OnlyIfExtDepsResolved* (_Boolean_): Do we return the plugin only if there is no need to install external dependencies ? [optional = false]
-    # ** *RDIInstaller* (<em>RDI::Installer</em>): The RDI installer if available, or nil otherwise [optional = nil]
-    # ** *RDIContextModifiers* (<em>map<String,list<[String,Object]>></em>): The map of context modifiers to be filled by the RDI installer if specified, or nil if ignored [optional = nil]
-    # Return:
-    # * _Object_: The corresponding plugin, or nil in case of failure
-    # * _Exception_: The error, or nil in case of success
-    def getPluginInstance(iCategory, iPluginName, iParameters = {})
-      return $rUtilAnts_Plugins_Manager.getPluginInstance(iCategory, iPluginName, iParameters)
-    end
+    # Main class storing info about plugins
+    class PluginsManager
 
-    # Get the named plugin description
-    #
-    # Parameters:
-    # * *iCategory* (_Object_): Category those plugins will belong to
-    # * *iPluginName* (_String_): Plugin name
-    # Return:
-    # * <em>map<Symbol,Object></em>: The corresponding description, or nil in case of failure
-    def getPluginDescription(iCategory, iPluginName)
-      return $rUtilAnts_Plugins_Manager.getPluginDescription(iCategory, iPluginName)
-    end
+      include PluginsInterface
 
-    # Give access to a plugin.
-    # An exception is thrown if the plugin does not exist.
-    #
-    # Parameters:
-    # * *iCategoryName* (_String_): Category of the plugin to access
-    # * *iPluginName* (_String_): Name of the plugin to access
-    # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-    # ** *OnlyIfExtDepsResolved* (_Boolean_): Do we return the plugin only if there is no need to install external dependencies ? [optional = false]
-    # ** *RDIInstaller* (<em>RDI::Installer</em>): The RDI installer if available, or nil otherwise [optional = nil]
-    # ** *RDIContextModifiers* (<em>map<String,list<[String,Object]>></em>): The map of context modifiers to be filled by the RDI installer if specified, or nil if ignored [optional = nil]
-    # * *CodeBlock*: The code called when the plugin is found:
-    # ** *ioPlugin* (_Object_): The corresponding plugin
-    def accessPlugin(iCategoryName, iPluginName, iParameters = {})
-      $rUtilAnts_Plugins_Manager.accessPlugin(iCategoryName, iPluginName, iParameters) do |ioPlugin|
-        yield(ioPlugin)
+      # Constructor
+      def initialize
+        init_plugins
       end
-    end
 
-    # Clear the registered plugins
-    def clearPlugins
-      $rUtilAnts_Plugins_Manager.clearPlugins
     end
 
-    # Get the list of plugin names of a given category
-    #
-    # Parameters:
-    # * *iCategoryName* (_String_): The category for which we want the plugin names list
-    # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-    # ** *IncludeDisabled* (_Boolean_): Do we include disabled plugins ? [optional = false]
-    # Return:
-    # * <em>list<String></em>: The list of plugin names in this category
-    def getPluginNames(iCategoryName, iParameters = {})
-      return $rUtilAnts_Plugins_Manager.getPluginNames(iCategoryName, iParameters)
-    end
-
-    # Get the map of plugins descriptions, indexed with plugin names
-    #
-    # Parameters:
-    # * *iCategoryName* (_String_): The category for which we want the plugin names list
-    # * *iParameters* (<em>map<Symbol,Object></em>): Additional parameters:
-    # ** *IncludeDisabled* (_Boolean_): Do we include disabled plugins ? [optional = false]
-    # Return:
-    # * <em>map<String,map<Symbol,Object>></em>: The map of plugin descriptions per plugin name
-    def getPluginsDescriptions(iCategoryName, iParameters = {})
-      return $rUtilAnts_Plugins_Manager.getPluginsDescriptions(iCategoryName, iParameters)
+    # Initialize a plugins singleton
+    def self.install_plugins_on_object
+      require 'rUtilAnts/SingletonProxy'
+      RUtilAnts::make_singleton_proxy(RUtilAnts::Plugins::PluginsInterface, Object)
+      init_plugins
     end
 
   end