setup 4.2.0 → 5.0.0

data/README

@@ -1,106 +0,0 @@
-= Setup
-
-  http://setup.rubyforge.org
-
-
-== Introduction
-
-Every Rubyist is aware of Minero Aoki's ever useful
-setup.rb script. It's how most of us used to install
-our ruby programs before RubyGems came along.And it's
-still mighty useful in certain scenarios, not the least
-of which is the job of the distribution package managers.
-Setup converts setup.rb into a stand-alone application.
-No longer will you need distribute setup.rb with you
-Ruby packages. Just instruct your users to use Setup.
-
-
-== Important
-
-There a couple very important difference between the old
-3.4.1 verison of the setup.rb script and version 4.0.0 
-of the independent application.
-
-* The directory convention 'conf' has been change to 'etc'.
-* The Metacofig API is not currently supported.
-* Multi-package project layouts are no longer supported.
-
-
-== Install
-
-The easy way to install is via RubyGems.
-
-  $ gem install setup
-
-To install Setup manually you need to "boot-strap" it.
-This is done for you, by running the following:
-
-  $ task/install
-
-
-== Usage
-
-To use setup.rb, a project must conform to the setup.rb
-standard layout.
-
-Please see the documentation in doc/book. Note that
-the documentation is slightly out of sync with the
-latest release.
-
-Usage is as simple as:
-
-  $ setup.rb config
-  $ setup.rb setup
-  $ setup.rb install
-
-or
-
-  $ setup.rb all
-
-If you later decide you want to remove the program.
-
-  $ setup.rb uninstall
-
-Note that uninstall is made possible by the 'installedfiles'
-file that is generated by the install process. If that file
-is deleted than you will not be able to uninstall. (You can
-get around this be reinstalling first though).
-
-You can clean up any setup products with:
-
-  $ setup.rb clean
-
-And restore the package to it's pristine state with:
-
-  $ setup.rb distclean
-
-Not that this last command will remove the .installedfiles
-file!
-
-
-== To Do
-
-* Maybe protect 'installedfiles' from removal, even on distclean.
-* Separate compiling code into separate class.
-
-
-== License
-
-Copyright (c) 2002,2005 Minero Aoki
-Copyright (c) 2008 TigerOps & Thomas Sawyer
-
-GNU LGPL, Lesser General Public License version 2.1.
-For details of LGPL, see the file "COPYING".
-
-
-
-
-                                     7trans
-                        transfire@gmail.com
-                        http://tigerops.org
-
-
-                                Minero Aoki
-                        aamine@loveruby.net
-                      http://i.loveruby.net
-

data/RELEASE

@@ -1,41 +0,0 @@
-= Release Notes
-
-Ruby Setup is a fork or Minero Aokoi's setup.rb script.
-Whereas setup.rb had to be copied into every project
-that used it, Ruby Setup is a stand alone application.
-
-The API is largely the same, with a only few distinctions.
-Most importantly, multi-package support has been removed.
-Also the underlying system has been made more object-oriented,
-for instance, what was ToplevelInstaller is now Setup::Installer.
-Finally configuration files are saved to .cache/setup and
-metaconfig should be placed in .config/setup, rather then
-directly into the root project directory.
-
-I still consider this and "early" release of Ruby Setup, that
-is until enough people put it through it's paces.
-However, since it is predominantly setup.rb 3.4.1 code,
-and since it works well enough to install itself ;)
-it certainly is a usable product.
-
-Please report any problems so I can fix them ASAP.
-
-
-### 4.1.0 / 2008-11-16
-
-* 5 Major Enhancements
-
-    * testing only runs if a test script if provided
-    * cache files are now stored in .cache/setup/
-    * Renamed binary from rubysetup to setup.rb.
-      * Hoping that the use of a dot in the name is not a problem on Windows.
-      * By using setup.rb for the binary, it matches exactly the name of the old script.
-      * Other developers could do likewise, eg. setup.py; akin to mkfs.ext3 and friends. 
-    * Added script/install as a bootstrap installer.
-    * restored metaconfig
-
-* 2 Minor Enhancements
-
-    * added test from original (needs work)
-    * removed test/suite.rb option from testing
-

data/lib/setup/build.rb

@@ -1,2 +0,0 @@
-# TODO: Extract the compiler portion of setup and put it here.
-

data/lib/setup/config.rb

@@ -1,452 +0,0 @@
-require 'rbconfig'
-require 'fileutils'
-require 'setup/rubyver'
-require 'setup/error'
-
-module Setup
-
-  # Config stores platform information.
-
-  class ConfigTable  # TODO: Rename to Config (?)
-
-    RBCONFIG  = ::Config::CONFIG
-
-    CONFIGFILE = '.cache/setup/config'
-
-    DESCRIPTIONS = [
-      [:prefix          , :path, 'path prefix of target environment'],
-      [:bindir          , :path, 'directory for commands'],
-      [:libdir          , :path, 'directory for libraries'],
-      [:datadir         , :path, 'directory for shared data'],
-      [:mandir          , :path, 'directory for man pages'],
-      [:docdir          , :path, 'Directory for documentation'],
-      [:sysconfdir      , :path, 'directory for system configuration files'],
-      [:localstatedir   , :path, 'directory for local state data'],
-      [:libruby         , :path, 'directory for ruby libraries'],
-      [:librubyver      , :path, 'directory for standard ruby libraries'],
-      [:librubyverarch  , :path, 'directory for standard ruby extensions'],
-      [:siteruby        , :path, 'directory for version-independent aux ruby libraries'],
-      [:siterubyver     , :path, 'directory for aux ruby libraries'],
-      [:siterubyverarch , :path, 'directory for aux ruby binaries'],
-      [:rbdir           , :path, 'directory for ruby scripts'],
-      [:sodir           , :path, 'directory for ruby extentions'],
-      [:rubypath        , :prog, 'path to set to #! line'],
-      [:rubyprog        , :prog, 'ruby program used for installation'],
-      [:makeprog        , :prog, 'make program to compile ruby extentions'],
-      [:extconfopt      , :name, 'options to pass-thru to extconf.rb'],
-      [:withoutext      , :bool, 'do not compile/install ruby extentions'],
-      [:withoutdoc      , :bool, 'do not generate documentation'],
-      [:shebang         , :pick, 'shebang line (#!) editing mode (all,ruby,never)'],
-      [:doctemplate     , :pick, 'document template to use (html|xml)'],
-      [:testrunner      , :pick, 'Runner to use for testing (auto|console|tk|gtk|gtk2)'],
-      [:installdirs     , :pick, 'install location mode (std,site,home :: libruby,site_ruby,$HOME)']
-    ]
-
-    # List of configurable options.
-    OPTIONS = DESCRIPTIONS.collect{ |(k,t,v)| k.to_s }
-
-    # Pathname attribute. Pathnames are automatically expanded
-    # unless they start with '$', a path variable.
-    def self.attr_pathname(name)
-      class_eval %{
-        def #{name}
-          @#{name}.gsub(%r<\\$([^/]+)>){ self[$1] }
-        end
-        def #{name}=(path)
-          raise Error, "bad config: #{name.to_s.upcase} requires argument" unless path
-          @#{name} = (path[0,1] == '$' ? path : File.expand_path(path))
-        end
-      }
-    end
-
-    # List of pathnames. These are not expanded though.
-    def self.attr_pathlist(name)
-      class_eval %{
-        def #{name}
-          @#{name}
-        end
-        def #{name}=(pathlist)
-          case pathlist
-          when Array
-            @#{name} = pathlist
-          else
-            @#{name} = pathlist.to_s.split(/[:;,]/)
-          end
-        end
-      }
-    end
-
-    # Adds boolean support.
-    def self.attr_accessor(*names)
-      bools, attrs = names.partition{ |name| name.to_s =~ /\?$/ }
-      attr_boolean *bools
-      super *attrs
-    end
-
-    # Boolean attribute. Can be assigned true, false, nil, or
-    # a string matching yes|true|y|t or no|false|n|f.
-    def self.attr_boolean(*names)
-      names.each do |name|
-        name = name.to_s.chomp('?')
-        attr_reader name  # MAYBE: Deprecate
-        code = %{
-          def #{name}?; @#{name}; end
-          def #{name}=(val)
-            case val
-            when true, false, nil
-              @#{name} = val
-            else
-              case val.to_s.downcase
-              when 'y', 'yes', 't', 'true'
-                 @#{name} = true
-              when 'n', 'no', 'f', 'false'
-                 @#{name} = false
-              else
-                raise Error, "bad config: use #{name.upcase}=(yes|no) [\#{val}]"
-              end
-            end
-          end
-        }
-        class_eval code
-      end
-    end
-
-    #DESCRIPTIONS.each do |k,t,d|
-    #  case t
-    #  when :path
-    #    attr_pathname k
-    #  when :bool
-    #    attr_boolean k
-    #  else
-    #    attr_accessor k
-    #  end
-    #end
-
-    # # provide verbosity (default is true)
-    # attr_accessor :verbose?
-
-    # # don't actually write files to system
-    # attr_accessor :no_harm?
-
-    # shebang has only three options.
-    def shebang=(val)
-      if %w(all ruby never).include?(val)
-        @shebang = val
-      else
-        raise Error, "bad config: use SHEBANG=(all|ruby|never) [#{val}]"
-      end
-    end
-
-    # installdirs has only three options; and it has side-effects.
-    def installdirs=(val)
-      @installdirs = val
-      case val.to_s
-      when 'std'
-        self.rbdir = '$librubyver'
-        self.sodir = '$librubyverarch'
-      when 'site'
-        self.rbdir = '$siterubyver'
-        self.sodir = '$siterubyverarch'
-      when 'home'
-        raise Error, 'HOME is not set.' unless ENV['HOME']
-        self.prefix = ENV['HOME']
-        self.rbdir = '$libdir/ruby'
-        self.sodir = '$libdir/ruby'
-      else
-        raise Error, "bad config: use INSTALLDIRS=(std|site|home|local) [#{val}]"
-      end
-    end
-
-    # New ConfigTable
-    def initialize(values=nil)
-      initialize_attributes
-      initialize_defaults
-      if values
-        values.each{ |k,v| __send__("#{k}=", v) }
-      end
-      yeild(self) if block_given?
-      load_config if File.file?(CONFIGFILE)
-    end
-
-    #
-    def initialize_attributes
-      load_meta_config
-      desc = descriptions
-      (class << self; self; end).class_eval do
-        desc.each do |k,t,d|
-          case t
-          when :path
-              attr_pathname k
-          when :bool
-            attr_boolean k
-          else
-            attr_accessor k
-          end
-        end
-      end
-    end
-
-    #
-    def descriptions
-      @descriptions ||= DESCRIPTIONS
-    end
-
-    # Assign CONFIG defaults
-    #
-    # TODO: Does this handle 'nmake' on windows?
-    #
-    def initialize_defaults
-      prefix = RBCONFIG['prefix']
-
-      rubypath = File.join(RBCONFIG['bindir'], RBCONFIG['ruby_install_name'] + RBCONFIG['EXEEXT'])
-
-      major = RBCONFIG['MAJOR'].to_i
-      minor = RBCONFIG['MINOR'].to_i
-      teeny = RBCONFIG['TEENY'].to_i
-      version = "#{major}.#{minor}"
-
-      # ruby ver. >= 1.4.4?
-      newpath_p = ((major >= 2) or
-                   ((major == 1) and
-                    ((minor >= 5) or
-                     ((minor == 4) and (teeny >= 4)))))
-
-      if RBCONFIG['rubylibdir']
-        # V > 1.6.3
-        libruby         = "#{prefix}/lib/ruby"
-        librubyver      = RBCONFIG['rubylibdir']
-        librubyverarch  = RBCONFIG['archdir']
-        siteruby        = RBCONFIG['sitedir']
-        siterubyver     = RBCONFIG['sitelibdir']
-        siterubyverarch = RBCONFIG['sitearchdir']
-      elsif newpath_p
-        # 1.4.4 <= V <= 1.6.3
-        libruby         = "#{prefix}/lib/ruby"
-        librubyver      = "#{prefix}/lib/ruby/#{version}"
-        librubyverarch  = "#{prefix}/lib/ruby/#{version}/#{c['arch']}"
-        siteruby        = RBCONFIG['sitedir']
-        siterubyver     = "$siteruby/#{version}"
-        siterubyverarch = "$siterubyver/#{RBCONFIG['arch']}"
-      else
-        # V < 1.4.4
-        libruby         = "#{prefix}/lib/ruby"
-        librubyver      = "#{prefix}/lib/ruby/#{version}"
-        librubyverarch  = "#{prefix}/lib/ruby/#{version}/#{c['arch']}"
-        siteruby        = "#{prefix}/lib/ruby/#{version}/site_ruby"
-        siterubyver     = siteruby
-        siterubyverarch = "$siterubyver/#{RBCONFIG['arch']}"
-      end
-
-      if arg = RBCONFIG['configure_args'].split.detect {|arg| /--with-make-prog=/ =~ arg }
-        makeprog = arg.sub(/'/, '').split(/=/, 2)[1]
-      else
-        makeprog = 'make'
-      end
-
-      parameterize = lambda do |path|
-        val = RBCONFIG[path]
-        raise "Unknown path -- #{path}" if val.nil?
-        val.sub(/\A#{Regexp.quote(prefix)}/, '$prefix')
-      end
-
-      self.prefix          = prefix
-      self.bindir          = parameterize['bindir']
-      self.libdir          = parameterize['libdir']
-      self.datadir         = parameterize['datadir']
-      self.mandir          = parameterize['mandir']
-      self.docdir          = File.dirname(parameterize['docdir'])  # b/c of trailing $(PACKAGE)
-      self.sysconfdir      = parameterize['sysconfdir']
-      self.localstatedir   = parameterize['localstatedir']
-      self.libruby         = libruby
-      self.librubyver      = librubyver
-      self.librubyverarch  = librubyverarch
-      self.siteruby        = siteruby
-      self.siterubyver     = siterubyver
-      self.siterubyverarch = siterubyverarch
-      self.rbdir           = '$siterubyver'
-      self.sodir           = '$siterubyverarch'
-      self.rubypath        = rubypath
-      self.rubyprog        = rubypath
-      self.makeprog        = makeprog
-      self.extconfopt      = ''
-      self.shebang         = 'ruby'
-      self.withoutext      = 'no'
-      self.withoutdoc      = 'no'
-      self.doctemplate     = nil
-      self.testrunner      = 'auto' # needed?
-      self.installdirs     = 'site'
-    end
-
-    # Get configuration from environment.
-    def env_config
-      OPTIONS.each do |name|
-        if value = ENV[name]
-          __send__("#{name}=",value)
-        end
-      end
-    end
-
-    # Load configuration.
-    def load_config
-      #if File.file?(CONFIGFILE)
-        begin
-          File.foreach(CONFIGFILE) do |line|
-            k, v = *line.split(/=/, 2)
-            k.gsub!('-','_')
-            __send__("#{k}=",v.strip) #self[k] = v.strip
-          end
-        rescue Errno::ENOENT
-          raise Error, $!.message + "\n#{File.basename($0)} config first"
-        end
-      #end
-    end
-
-    # Save configuration.
-    def save_config
-      FileUtils.mkdir_p(File.dirname(CONFIGFILE))
-      File.open(CONFIGFILE, 'w') do |f|
-        OPTIONS.each do |name|
-          val = self[name]
-          f << "#{name}=#{val}\n"
-        end
-      end
-    end
-
-    def show
-      fmt = "%-20s %s\n"
-      OPTIONS.each do |name|
-        value = self[name]
-        reslv = __send__(name)
-        case reslv
-        when String
-          reslv = "(none)" if reslv.empty?
-        when false, nil
-          reslv = "no"
-        when true
-          reslv = "yes"
-        end
-        printf fmt, name, reslv
-      end
-    end
-
-    #
-    def extconfs
-      @extconfs ||= Dir['ext/**/extconf.rb']
-    end
-
-    def extensions
-      @extensions ||= extconfs.collect{ |f| File.dirname(f) }
-    end
-
-    def compiles?
-      !extensions.empty?
-    end
-
-    private
-
-    # Get unresloved attribute.
-    def [](name)
-      instance_variable_get("@#{name}")
-    end
-
-    # Set attribute.
-    def []=(name, value)
-      instance_variable_set("@#{name}", value)
-    end
-
-    # Resolved attribute. (for paths)
-    #def resolve(name)
-    #  self[name].gsub(%r<\\$([^/]+)>){ self[$1] }
-    #end
-
-    # Metaconfig file is '.config/setup/metaconfig{,.rb}'.
-    def load_meta_config
-      path = Dir.glob('.config/setup/metaconfig{,.rb}').first
-      if path && File.file?(path)
-        MetaConfigEnvironment.new(self).instance_eval(File.read(path), path)
-      end
-    end
-
-    #= Meta Configuration
-    # This works a bit differently from 3.4.1.
-    # Defaults are currently not supported but remain in the method interfaces.
-    class MetaConfigEnvironment
-      def initialize(config) #, installer)
-        @config    = config
-        #@installer = installer
-      end
-
-      #
-      def config_names
-        @config.descriptions.collect{ |n, t, d| n.to_s }
-      end
-
-      #
-      def config?(name)
-        @config.descriptions.find do |sym, type, desc|
-          sym.to_s == name.to_s
-        end
-      end
-
-      #
-      def bool_config?(name)
-        @config.descriptions.find do |sym, type, desc|
-          sym.to_s == name.to_s && type == :bool
-        end
-        #@config.lookup(name).config_type == 'bool'
-      end
-
-      #
-      def path_config?(name)
-        @config.descriptions.find do |sym, type, desc|
-          sym.to_s == name.to_s && type == :path
-        end
-        #@config.lookup(name).config_type == 'path'
-      end
-
-      #
-      def value_config?(name)
-        @config.descriptions.find do |sym, type, desc|
-          sym.to_s == name.to_s && type != :prog
-        end
-        #@config.lookup(name).config_type != 'exec'
-      end
-
-      #
-      def add_config(name, default, desc)
-        @config.descriptions << [name.to_sym, nil, desc]
-        #@config.add item
-      end
-
-      #
-      def add_bool_config(name, default, desc)
-        @config.descriptions << [name.to_sym, :bool, desc]
-        #@config.add BoolItem.new(name, 'yes/no', default ? 'yes' : 'no', desc)
-      end
-
-      #
-      def add_path_config(name, default, desc)
-        @config.descriptions << [name.to_sym, :path, desc]
-        #@config.add PathItem.new(name, 'path', default, desc)
-      end
-
-      #
-      def set_config_default(name, default)
-        @config[name] = default
-      end
-
-      #
-      def remove_config(name)
-        item = @config.descriptions.find do |sym, type, desc|
-          sym.to_s == name.to_s
-        end
-        index = @config.descriptions.index(item)
-        @config.descriptions.delete(index)
-        #@config.remove(name)
-      end
-    end
-
-  end #class ConfigTable
-
-end #module Setup
-