derailed-ziya 2.0.4

data/lib/ziya/utils/logger.rb

@@ -0,0 +1,125 @@
+# -----------------------------------------------------------------------------
+# Ziya default logger if none is given
+#
+# -----------------------------------------------------------------------------
+require 'logging'
+require 'forwardable'
+
+module Ziya
+  class Logger
+    class ConfigurationError < StandardError ; end  #:nodoc:
+
+    attr_reader :log # here for testing, don't really use it.
+
+    extend Forwardable
+    def_delegators :@log, :debug, :warn, :info, :error, :fatal 
+    def_delegators :@log, :level=, :level
+    def_delegators :@log, :debug?, :warn?, :info?, :error?, :fatal?  
+    def_delegators :@log, :add, :clear_appenders
+
+    # there are more options here than are typically utilized for the
+    # logger, they are made available if someone wants to utilize
+    # them directly.  
+    #
+    def self.default_options #:nodoc:
+      @default_options ||= {
+
+        # log event layout pattern
+        #    YYYY-MM-DDTHH:MM:SS 12345 LEVEL LoggerName : The Log message
+        #
+        :layout_pattern       => '%d %5p %5l %c : %m\n'.freeze  ,
+        :logger_name          => 'ZiYa'                         ,
+        :additive             => true                           ,
+
+        # log file configuration options
+        #   age        -> how often to rotate the logs if a file is used
+        #   keep_count -> how many of the log files to keep
+        :log_level            => :info          ,
+        :log_file             => $stdout        ,
+        :log_file_age         => 'daily'.freeze ,
+        :log_file_keep_count  => 7              ,
+
+        # email logging options
+        #   buffsize -> number of log events used as a threshold to send an
+        #               email.  If that is not reached before the program
+        #               exists then the at_exit handler for logging will flush
+        #               the log to smtp.
+        :email_alerts_to      => nil    ,
+        :email_alert_level    => :error ,
+        :email_alert_server   => nil    ,
+        :email_alert_buffsize => 200    ,
+      }
+    end
+
+    # create a new logger
+    #
+    def initialize( opts = {} )
+      @options = ::Ziya::Logger.default_options.merge(opts)
+      @log     = ::Logging::Logger[@options[:logger_name]]
+      @layout  = ::Logging::Layouts::Pattern.new( { :pattern => @options[:layout_pattern] } )
+     
+      # add appenders explicitly, since this logger may already be defined and
+      # already have loggers
+      @appenders = []
+      @appenders << log_file_appender if @options[:log_file]
+      @appenders << email_appender if @options[:email_alerts_to]
+
+      @log.appenders = @appenders
+      @log.level = @options[:log_level]
+      @log.additive = @options[:additive]
+    end
+
+    # File appender, this is either an IO appender or a RollingFile appender
+    # depending on if an IO object or a String is passed in.
+    #
+    # a configuration error is raised in any other circumstance
+    def log_file_appender  #:nodoc:
+      appender_name = "#{@log.name}-log_file_appender"
+      if String === @options[:log_file] then 
+        ::Logging::Appenders::RollingFile.new( appender_name, 
+                                             { :layout    => @layout,
+                                               :filename  => @options[:log_file],
+                                               :age       => @options[:log_file_age],
+                                               :keep      => @options[:log_file_keep_count],
+                                               :safe      => true  # make sure log files are rolled using lockfile
+        })
+      elsif @options[:log_file].respond_to?(:print) then
+        ::Logging::Appenders::IO.new( appender_name, @options[:log_file],  :layout => @layout  )
+      else
+        raise ConfigurationError, "Invalid :log_file option [#{@options[:log_file].inspect}]"
+      end
+    end
+
+    # an email appender that uses :email_alerts_to option to send emails to.
+    # :email_alerts_to can either be a singe email address as a string or an
+    # Array of email addresses.  Any other option for :email_alerts_to is
+    # invalid and raises an error.
+    #
+    def email_appender #:nodoc:
+      email_alerts_to = [ @options[:email_alerts_to] ].flatten.reject { |x| x == nil }
+      raise ConfigurationError, "Invalid :email_alerts_to option [#{@options[:email_alerts_to].inspect}]" unless email_alerts_to.size > 0
+      ::Logging::Appenders::Email.new("#{@log.name}-email_appender",
+                                      {
+                                        :level    => @options[:email_alert_level],
+                                        :layout   => @layout,
+                                        :from     => "#{@log.name}",
+                                        :to       => "#{email_alerts_to.join(', ')}",
+                                        :subject  => "Logging Alert from #{@log.name} on #{ENV['HOSTNAME']}",
+                                        :server   => @options[:email_alert_server],
+                                        :buffsize => @options[:email_alert_buffsize], # lines 
+      })
+    end
+
+    # create a new logger thi logger has no options when it is created although 
+    # more can be added with the logger instance that is returned.  The
+    # appenders of the current instance of Logger will be set on the new
+    # logger and the options of the current logger will be applied
+    def for( arg ) #:nodoc:
+      new_logger           = ::Logging::Logger[arg]
+      new_logger.level     = @options[:level]
+      new_logger.additive  = @options[:additive]
+      new_logger.appenders = @appenders
+      return new_logger
+    end     
+  end
+end

data/lib/ziya/utils/text.rb

@@ -0,0 +1,39 @@
+# -----------------------------------------------------------------------------
+# == Ziya::Utils::Text
+#
+# TODO !! Just make this a core extension to String already...
+#
+# Various text utils. Yes indeed lifted from Inflecto to remove Inflector 
+# dependencies...
+#
+# Author:: Fernand Galiana
+# Date::   Dec 15th, 2006
+# -----------------------------------------------------------------------------
+module Ziya::Utils
+  module Text
+    # Pulled from the Rails Inflector class and modified slightly to fit our needs.
+    def camelize(string)
+      string.to_s.gsub(/\/(.?)/) { "::" + $1.upcase }.gsub(/(^|_)(.)/) { $2.upcase }
+    end
+
+    # Same as Rails Inflector but eliminating inflector dependency
+    def underscore(camel_cased_word)
+      camel_cased_word.to_s.gsub(/::/, '/').
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr("-", "_").
+      downcase
+    end
+
+    # Pulled from the Rails Inflector class and modified slightly to fit our needs.
+    def classify(string)
+      camelize(string.to_s.sub(/.*\./, ''))
+    end
+    
+    # strip out module name and return bare class name
+    def demodulize( clazz )
+      clazz.gsub( /^.*::/, '' )
+    end
+    
+  end  
+end

data/lib/ziya/version.rb

@@ -0,0 +1,15 @@
+module Ziya
+  module Version
+    MAJOR = 2
+    MINOR = 0
+    TINY  = 4
+    
+    # Returns the version string for the library.
+    #
+    def self.version
+      [ MAJOR, MINOR, TINY].join( "." )
+    end
+  end
+end
+
+

data/lib/ziya/ziya_helper.rb

@@ -0,0 +1,374 @@
+# -----------------------------------------------------------------------------
+# Generates necessary html flash tag to support ZiYa
+#
+# TODO !! Rewrite to use content tag block instead...
+#
+# Author: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'cgi'
+require 'erb'
+
+module Ziya
+  module Helper    
+    
+    # -------------------------------------------------------------------------
+    # generates a javascript tag to include the js script to create object and
+    # embed tags
+    def ziya_javascript_include_tag
+      js = <<-JS
+        <script language="javascript" type="text/javascript">
+          AC_FL_RunContent = 0;
+          DetectFlashVer = 0;
+        </script>
+        <script src="/charts/AC_RunActiveContent.js" language="javascript"></script>
+        <script language="javascript" type="text/javascript">
+          var requiredMajorVersion = 9;
+          var requiredMinorVersion = 0;
+          var requiredRevision = 45;
+        </script>
+       JS
+    end
+       
+    # generates necessary object and embed tags to display a flash movie on various 
+    # browsers using javascript
+    def ziya_chart_js( url, chart_options={} )
+      options = { :width          => "400",
+                  :height         => "300",
+                  :bgcolor        => "000000",
+                  :wmode          => "opaque",
+                  :menu           => true,
+                  :full_screen    => true,
+                  :align          => "l",
+                  :salign         => "tl",
+                  :scale          => "noscale",
+                  :use_cache      => false,
+                  :timeout        => nil,
+                  :retry          => 2,
+                  :use_stage      => false,                  
+                  :id             => "ziya_chart",
+                  :swf_path       => chart_path,
+      }.merge!(chart_options)
+
+      # Setup options for opaque mode
+      setup_wmode( options )      
+      
+      # setup width and height
+      setup_movie_size( options )
+      
+      xml_swf_path = charts_swf % [options[:swf_path], escape_url(url)]
+      xml_swf_path << "&timestamp=#{Time.now.to_i}" if options[:cache] == false
+      xml_swf_path << "&timeout=#{options[:timeout]}&retry=#{options[:retry]}" if options[:timeout]
+      xml_swf_path << "&stage_width=#{options[:width]}&stage_height=#{options[:height]}" if options[:use_stage] == true 
+      
+      js = <<-JS
+        <script language="javascript" type="text/javascript">
+        if (AC_FL_RunContent == 0 || DetectFlashVer == 0) {
+          alert( "This page requires AC_RunActiveContent.js." );
+        } 
+        else {
+          var hasRightVersion = DetectFlashVer(requiredMajorVersion, requiredMinorVersion, requiredRevision);
+          if( hasRightVersion ) { 
+            AC_FL_RunContent(
+              'codebase'         , 'http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,45,0',
+              'width'            , '#{options[:width]}',
+              'height'           , '#{options[:height]}',
+              'scale'            , '#{options[:scale]}',
+              'salign'           , '#{options[:salign]}',
+              'bgcolor'          , '#{options[:bgcolor]}',
+              'wmode'            , '#{options[:wmode]}',
+              'movie'            , '#{options[:swf_path]}/charts',
+              'src'              , '#{options[:swf_path]}/charts',
+              'FlashVars'        , '#{xml_swf_path}', 
+              'id'               , '#{options[:id]}',
+              'name'             , '#{options[:id]}',
+              'menu'             , '#{options[:menu]}',
+              'allowFullScreen'  , '#{options[:full_screen]}',
+              'allowScriptAccess','sameDomain',
+              'quality'          , 'high',
+              'align'            , '#{options[:align]}',
+              'pluginspage'      , 'http://www.macromedia.com/go/getflashplayer',
+              'play'             , 'true',
+              'devicefont'       , 'false'
+            ); 
+          } 
+          else { 
+            var alternateContent = 'This content requires the Adobe Flash Player. '
+            + '<u><a href=http://www.macromedia.com/go/getflash/>Get Flash</a></u>.';
+            document.write(alternateContent); 
+          }
+        }
+        </script>
+      JS
+    end
+    
+    # -------------------------------------------------------------------------
+    # generates necessary html tags to display a gauge.  
+    def ziya_gauge( url, gauge_options={} )
+      options = { :width          => "200",
+                  :height         => "200",
+                  :align          => "middle",
+                  :scale          => "noscale",
+                  :salign         => "",
+                  :class          => "",        
+                  :id             => "ziya_gauge",
+                  :swf_path       => gauge_path,
+                  :use_cache      => false,
+                  :timeout        => false,
+                  :retry          => 2,
+                  :use_stage      => false
+                }.merge!(gauge_options)
+                      
+      generate_old_style_flash_tag( url, gauges_swf, options )
+    end
+        
+    # -------------------------------------------------------------------------------------
+    # generates neccessary html tags to display a chart.
+    def ziya_chart( url, chart_options = {} )
+      options = { :width          => "400",
+                  :height         => "300",
+                  :tag_type       => "embed",
+                  :align          => "l",
+                  :salign         => "tl",
+                  :scale          => "noscale",
+                  :class          => "",   
+                  :id             => "ziya_chart",
+                  :swf_path       => chart_path,
+                  :use_cache      => false,
+                  :timeout        => nil,
+                  :use_stage      => false
+                }.merge!(chart_options)
+    
+      generate_flash_tag( url, charts_swf, "charts.swf", options )
+    end   
+        
+    # flash chart library path
+    def gen_composite_path( swf_chart_dir, url )
+      composite_url % [swf_chart_dir, swf_chart_dir, escape_url( url )] 
+    end
+    
+    # =========================================================================
+    # private                               
+
+      # Const accessors...
+      def mime()          "application/x-shockwave-flash"; end
+      def composite_url() "%s/charts.swf?library_path=%s/charts_library&xml_source=%s" end
+      def charts_swf()    "library_path=%s/charts_library&xml_source=%s"; end      
+      def plugin_url()    "http://www.macromedia.com/go/getflashplayer"; end
+      def gauges_swf()    "%s/gauge.swf?xml_source=%s"; end              
+      def gauge_path()    "/gauges"; end
+      def chart_path()    "/charts"; end       
+      def class_id()      "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" end
+      def codebase()      "http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,45,0"; end
+
+      # generates swf path
+      def gen_swf_path( path_directive, swf_dir, url )
+        path_directive % [swf_dir, escape_url( url )]
+      end
+
+      def generate_old_style_flash_tag( url, swf_path, options )
+        # Setup options for opaque mode
+        setup_wmode( options )      
+        
+        # setup width and height
+        setup_movie_size( options )
+        
+        color_param  = tag( 'param', {:name => 'bgcolor', :value => options[:bgcolor]}, true )
+        color_param += tag( 'param', {:name  => "wmode", :value => options[:wmode]}, true )
+      
+        xml_swf_path = swf_path % [options[:swf_path], url]
+        xml_swf_path << "&timestamp=#{Time.now.to_i}" if options[:use_cache] == true
+        xml_swf_path << "&timeout=#{options[:timeout]}&retry=#{options[:retry]}" if options[:timeout] == true
+        xml_swf_path << "&stage_width=#{options[:width]}&stage_height=#{options[:height]}" if options[:use_stage] == true
+        tags = <<-TAGS
+          <object codebase="#{codebase}" classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" id="#{options[:id]}" height="#{options[:height]}" width="#{options[:width]}">
+            <param name="scale" value="noscale">
+            <param name="align" value="#{options[:align]}">            
+            <param name="bgcolor" value="#{options[:bgcolor]}">
+            <param name="wmode" value="#{options[:wmode]}">                                  
+            <param name="movie" value="#{xml_swf_path}">
+            <param name="menu" value="true">
+            <param name="allowFullScreen" value="true">
+            <param name="allowScriptAccess" value="sameDomain">            
+            <param name="quality" value="high">
+            <param name="play" value="true">                        
+            <param name="devicefont" value="false">
+            <embed scale="noscale"
+              allowfullscreen="true" 
+              allowscriptaccess="sameDomain" 
+              bgcolor="#{options[:bgcolor]}" 
+              devicefont="false" 
+              src="#{xml_swf_path}" 
+              menu="true" 
+              name="#{options[:id]}" 
+              play="true" 
+              pluginspage="http://www.macromedia.com/go/getflashplayer" 
+              quality="high" 
+              salign="#{options[:salign]}" 
+              src="#{xml_swf_path}" 
+              type="application/x-shockwave-flash" 
+              wmode="#{options[:wmode]}" 
+              salign="#{options[:salign]}" 
+              height="#{options[:height]}" 
+              width="#{options[:width]}">
+         </object>        
+        TAGS
+      end
+      
+      # generated the object and embed tag necessary for the flash movie
+      def generate_flash_tag( url, swf_path, swf_file, options )
+        # Setup options for opaque mode
+        setup_wmode( options )      
+        
+        # setup width and height
+        setup_movie_size( options )
+        
+        color_param  = tag( 'param', {:name => 'bgcolor', :value => options[:bgcolor]}, true )
+        color_param += tag( 'param', {:name  => "wmode", :value => options[:wmode]}, true )
+
+        xml_swf_path = gen_swf_path( swf_path, options[:swf_path], url )
+        xml_swf_path << "&timestamp=#{Time.now.to_i}" if options[:cache] == false
+        xml_swf_path << "&timeout=#{options[:timeout]}" if options[:timeout]
+        xml_swf_path << "&stage_width=#{options[:width]}&stage_height=#{options[:height]}" if options[:use_stage] == true 
+        
+        # if options[:tag_type] == "object"
+          tags = <<-TAGS
+          <object codebase="#{codebase}" classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" id="#{options[:id]}" height="#{options[:height]}" width="#{options[:width]}">
+            <param name="scale"             value="noscale">
+            <param name="salign"            value="#{options[:salign]}">            
+            <param name="bgcolor"           value="#{options[:bgcolor]}">
+            <param name="wmode"             value="#{options[:wmode]}">                                  
+            <param name="movie"             value="#{options[:swf_path]}/#{swf_file}">            
+            <param name="FlashVars"         value="#{xml_swf_path}&chart_id=#{options[:id]}">
+            <param name="menu"              value="true">
+            <param name="allowFullScreen"   value="true">
+            <param name="allowScriptAccess" value="sameDomain">            
+            <param name="quality"           value="high">
+            <param name="play"              value="true">                        
+            <param name="devicefont"        value="false">
+              <embed scale="noscale" 
+                allowfullscreen="true" 
+                allowscriptaccess="sameDomain" 
+                bgcolor="#{options[:bgcolor]}" 
+                devicefont="false" 
+                flashvars="#{xml_swf_path}" 
+                menu="true" 
+                name="#{options[:id]}" 
+                play="true" 
+                pluginspage="http://www.macromedia.com/go/getflashplayer" 
+                quality="high" 
+                salign="#{options[:salign]}" 
+                src="#{options[:swf_path]}/#{swf_file}" 
+                type="application/x-shockwave-flash" 
+                wmode="#{options[:wmode]}" 
+                align="#{options[:align]}" 
+                height="#{options[:height]}" 
+                width="#{options[:width]}"/>            
+         </object>        
+        TAGS
+      # else
+       #    tags = <<-TAGS
+       #      <embed scale="noscale" 
+       #        allowfullscreen="true" 
+       #        allowscriptaccess="sameDomain" 
+       #        bgcolor="#{options[:bgcolor]}" 
+       #        devicefont="false" 
+       #        flashvars="#{xml_swf_path}" 
+       #        menu="true" 
+       #        name="#{options[:id]}" 
+       #        play="true" 
+       #        pluginspage="http://www.macromedia.com/go/getflashplayer" 
+       #        quality="high" 
+       #        salign="#{options[:salign]}" 
+       #        src="#{options[:swf_path]}/#{swf_file}" 
+       #        type="application/x-shockwave-flash" 
+       #        wmode="#{options[:wmode]}" 
+       #        align="#{options[:align]}" 
+       #        height="#{options[:height]}" 
+       #        width="#{options[:width]}"/>
+       #    TAGS
+       # end 
+       tags
+      end
+              
+      # escape url    
+      def escape_url( url )
+        CGI.escape( url.gsub( /&amp;/, '&' ) )
+      end
+    
+      # setup up wmode
+      # Set the wmode to opaque if a bgcolor is specified. If not set to
+      # transparent mode unless user overrides it    
+      def setup_wmode( options )
+        if options[:bgcolor]
+          options[:wmode] = "opaque" unless options[:wmode]
+        else
+          options[:wmode]   = "transparent" unless options[:wmode]
+          options[:bgcolor] = "#FFFFFF"
+        end
+      end
+
+      # Check args for size option in the format wXy (Submitted by Sam Livingston-Gray)                                  
+      def setup_movie_size( options )
+        if options[:size] =~ /(\d+)x(\d+)/
+          options[:width]  = $1
+          options[:height] = $2
+          options.delete :size
+        end
+      end
+    
+      # All this stolen form rails to make Ziya work with other fmks....    
+      def tag(name, options = nil, open = false, escape = true)
+       "<#{name}#{tag_options(options, escape) if options}" + (open ? ">" : " />")
+      end    
+      
+      def escape_once(html)
+        html.to_s.gsub(/[\"><]|&(?!([a-zA-Z]+|(#\d+));)/) { |special| escape_chars[special] }
+      end
+      
+      def tag_options(options, escape = true)
+        unless !options or options.empty?
+          attrs = []
+          if escape
+            options.each do |key, value|
+              next unless value
+              key = key.to_s
+              value = escape_once(value)
+              attrs << %(#{key}="#{value}")
+            end
+          else
+            attrs = options.map { |key, value| %(#{key}="#{value}") }
+          end
+          " #{attrs.sort * ' '}" unless attrs.empty?
+        end
+      end
+      
+      def content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block)
+        if block_given?
+          options = content_or_options_with_block if content_or_options_with_block.is_a?(Hash)
+          content = capture_block(&block)
+          content_tag = content_tag_string(name, content, options, escape)
+          block_is_within_action_view?(block) ? concat(content_tag, block.binding) : content_tag
+        else
+          content = content_or_options_with_block
+          content_tag_string(name, content, options, escape)
+        end
+      end
+      
+      def capture_block( *args, &block )
+          block.call(*args)
+      end
+      
+      def content_tag_string(name, content, options, escape = true)
+        tag_options = tag_options(options, escape) if options
+        "<#{name}#{tag_options}>#{content}</#{name}>"
+      end
+
+      def block_is_within_action_view?(block)
+        eval("defined? _erbout", block.binding)
+      end  
+      
+      def escape_chars 
+        { '&' => '&amp;', '"' => '&quot;', '>' => '&gt;', '<' => '&lt;' }
+      end          
+  end
+end

data/lib/ziya.rb

@@ -0,0 +1,112 @@
+# $Id$
+
+# BOZO !! Document !!
+
+# Equivalent to a header guard in C/C++
+# Used to prevent the class/module from being loaded more than once
+unless defined? Ziya
+  module Ziya          
+    # :stopdoc:
+    LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+    PATH    = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+               
+    def self.default_configuration
+      { :themes_dir => File.join( File.dirname(__FILE__), %w[.. charts themes] ),
+        :log_file   => $stdout,
+        :log_level  => :info }
+    end
+                            
+    def self.initialize( opts={} )
+      puts ">>> No logger specified. Using ZiYa default logger" unless opts[:logger]
+      puts ">>> No themes_dir specified. Using ZiYa default themes" unless opts[:themes_dir]      
+      @config = default_configuration.merge( opts )
+      @logger = opts[:logger] if opts[:logger]
+
+      # Verify existance of themes, designs and helper dirs if any
+      if themes_dir
+        raise "Unable to find themes directory `#{themes_dir}" unless File.exists?( themes_dir )
+      end
+
+      if designs_dir
+        raise "Unable to find designs directory `#{designs_dir}" unless File.exists?( designs_dir )
+      end
+      
+      if helpers_dir
+        raise "Unable to find helper directory `#{helpers_dir}" unless File.exists?( helpers_dir )
+      end
+      
+      # Add the ziya/lib to the ruby path...
+      $: << libpath
+      Ziya.require_all_libs_relative_to __FILE__
+      
+      dump if config[:log_level] == :debug
+    end
+
+    # ZiYa configuration
+    def self.config
+      @config
+    end
+          
+    # directory location for ziya stylesheet custom helpers
+    def self.helpers_dir
+      config[:helpers_dir]
+    end
+    
+    # the themes root directory location
+    def self.themes_dir
+      config[:themes_dir]
+    end
+
+    # the gauges designs root directory location
+    def self.designs_dir
+      config[:designs_dir]
+    end
+    
+    # Debug                        
+    def self.dump #:nodoc:
+      puts "" 
+      puts "ZiYa Configuration Landscape"    
+      config.keys.sort{ |a,b| a.to_s <=> b.to_s }.each do |k| 
+        key   = k.to_s.rjust(20)
+        value = config[k].to_s.rjust(97,".")
+        puts "#{key} : #{value}"
+      end
+    end
+    
+    # fetch the framework logger        
+    def self.logger
+      # get a hold of a logger.
+      @logger ||= ::Ziya::Logger.new( { :log_file          => config[:log_file], 
+                                        :logger_name       => "ZiYa",
+                                        :log_level         => config[:log_level],
+                                        :additive          => false } )
+    end
+           
+    # Returns the library path for the module. If any arguments are given,
+    # they will be joined to the end of the libray path using
+    # <tt>File.join</tt>.
+    #
+    def self.libpath( *args ) #:nodoc:
+      args.empty? ? LIBPATH : ::File.join(LIBPATH, *args)
+    end
+
+    # Returns the lpath for the module. If any arguments are given,
+    # they will be joined to the end of the path using
+    # <tt>File.join</tt>.
+    #
+    def self.path( *args ) #:nodoc:
+      args.empty? ? PATH : ::File.join(PATH, *args)
+    end
+
+    # Utility method used to require all files ending in .rb that lie in the
+    # directory below this file that has the same name as the filename passed
+    # in. Optionally, a specific _directory_ name can be passed in such that
+    # the _filename_ does not have to be equivalent to the directory.
+    #
+    def self.require_all_libs_relative_to( fname, dir = nil ) #:nodoc:
+      dir       ||= ::File.basename(fname, '.*')
+      search_me   = ::File.expand_path( ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+      Dir.glob(search_me).sort.each {|rb| require rb}
+    end 
+  end
+end