inochi.rb in dfect-2.1.0

- old
+ new
@@ -1,48 +1,102 @@
 module Dfect
 
-  INSTDIR = File.expand_path('../../..', __FILE__)
+  ##
+  # Official name of this project.
+  #
+  PROJECT = "Dfect"
 
-  # load inochi configuration
-  inochi_file = __FILE__.sub(/rb$/, 'yaml')
-  begin
+  ##
+  # Short single-line description of this project.
+  #
+  TAGLINE = "Assertion testing library for Ruby"
 
-    configs = File.open(inochi_file) do |f|
-      require 'yaml'
-      YAML.load_stream(f).documents
-    end
+  ##
+  # Address of this project's official home page.
+  #
+  WEBSITE = "http://snk.tuxfamily.org/lib/dfect/"
 
-    INOCHI = configs.shift.to_hash
-    INOCHI[:runtime] ||= {}
-    INOCHI[:devtime] ||= {}
+  ##
+  # Number of this release of this project.
+  #
+  VERSION = "2.1.0"
 
-    INOCHI2 = (configs.shift || {}).to_hash
+  ##
+  # Date of this release of this project.
+  #
+  RELDATE = "2010-03-31"
 
-  rescue => error
-    error.message.insert 0,
-      "Could not load Inochi configuration file: #{inochi_file.inspect}\n"
-    raise error
+  ##
+  # Description of this release of this project.
+  #
+  def self.inspect
+    "#{PROJECT} #{VERSION} (#{RELDATE})"
   end
 
-  # make values available as constants
-  INOCHI.each do |param, value|
-    const_set param.to_s.upcase, value
-  end
+  ##
+  # Location of this release of this project.
+  #
+  INSTDIR = File.expand_path('../../..', __FILE__)
 
-  def self.inspect
-    "#{PROJECT} #{VERSION} (#{RELEASE})"
-  end
+  ##
+  # RubyGems required by this project during runtime.
+  #
+  # @example
+  #
+  #   RUNTIME = {
+  #     # this project needs exactly version 1.2.3 of the "an_example" gem
+  #     "an_example" => [ "1.2.3" ],
+  #
+  #     # this project needs at least version 1.2 (but not
+  #     # version 1.2.4 or newer) of the "another_example" gem
+  #     "another_example" => [ ">= 1.2" , "< 1.2.4" ],
+  #
+  #     # this project needs any version of the "yet_another_example" gem
+  #     "yet_another_example" => [],
+  #   }
+  #
+  RUNTIME = {}
 
-  # establish gem version dependencies
-  if respond_to? :gem
-    [:runtime, :devtime].each do |key|
-      INOCHI[key].each do |gem_name, gem_version|
+  ##
+  # RubyGems required by this project during development.
+  #
+  # @example
+  #
+  #   DEVTIME = {
+  #     # this project needs exactly version 1.2.3 of the "an_example" gem
+  #     "an_example" => [ "1.2.3" ],
+  #
+  #     # this project needs at least version 1.2 (but not
+  #     # version 1.2.4 or newer) of the "another_example" gem
+  #     "another_example" => [ ">= 1.2" , "< 1.2.4" ],
+  #
+  #     # this project needs any version of the "yet_another_example" gem
+  #     "yet_another_example" => [],
+  #   }
+  #
+  DEVTIME = {
+    "inochi" => [ "~> 2" ], # for managing this project
+  }
+
+  ##
+  # Loads the correct version (as defined by the {RUNTIME} or {DEVTIME}
+  # constant in this module) of the given gem or the gem that contains
+  # the given library.
+  #
+  def self.require gem_name_or_library
+    # prepare the correct version of the gem for loading
+    if respond_to? :gem
+      gem_name = gem_name_or_library.to_s.sub(%r{/.*$}, '')
+      if gem_version = RUNTIME[gem_name] || DEVTIME[gem_name]
         begin
-          gem gem_name, *Array(gem_version)
+          gem gem_name, *gem_version
         rescue LoadError => error
-          warn "#{inspect} #{key}: #{error}"
+          warn "#{self.inspect}: #{error}"
         end
       end
     end
+
+    # do the loading
+    super
   end
 
 end