britt-geminstaller 0.5.2 → 0.5.2.1
Sign up to get free protection for your applications and to get access to all the features.
- data/.loadpath +5 -0
- data/COPYING +1 -0
- data/History.txt +69 -0
- data/LICENSE +21 -0
- data/Manifest.txt +78 -0
- data/README.txt +64 -0
- data/Rakefile +184 -0
- data/TODO.txt +138 -0
- data/bin/geminstaller +30 -0
- data/cruise_config.rb +14 -0
- data/focused_spec.sh +2 -0
- data/focused_spec_debug.sh +2 -0
- data/geminstaller.yml +42 -0
- data/lib/geminstaller.rb +103 -0
- data/lib/geminstaller/application.rb +105 -0
- data/lib/geminstaller/arg_parser.rb +166 -0
- data/lib/geminstaller/autogem.rb +46 -0
- data/lib/geminstaller/backward_compatibility.rb +10 -0
- data/lib/geminstaller/config.rb +68 -0
- data/lib/geminstaller/config_builder.rb +65 -0
- data/lib/geminstaller/enhanced_stream_ui.rb +71 -0
- data/lib/geminstaller/exact_match_list_command.rb +16 -0
- data/lib/geminstaller/file_reader.rb +31 -0
- data/lib/geminstaller/gem_arg_processor.rb +44 -0
- data/lib/geminstaller/gem_command_manager.rb +74 -0
- data/lib/geminstaller/gem_interaction_handler.rb +41 -0
- data/lib/geminstaller/gem_list_checker.rb +55 -0
- data/lib/geminstaller/gem_runner_proxy.rb +62 -0
- data/lib/geminstaller/gem_source_index_proxy.rb +21 -0
- data/lib/geminstaller/gem_spec_manager.rb +53 -0
- data/lib/geminstaller/geminstaller_access_error.rb +4 -0
- data/lib/geminstaller/geminstaller_error.rb +13 -0
- data/lib/geminstaller/hoe_extensions.rb +9 -0
- data/lib/geminstaller/install_processor.rb +71 -0
- data/lib/geminstaller/missing_dependency_finder.rb +46 -0
- data/lib/geminstaller/missing_file_error.rb +4 -0
- data/lib/geminstaller/noninteractive_chooser.rb +114 -0
- data/lib/geminstaller/output_filter.rb +49 -0
- data/lib/geminstaller/output_listener.rb +33 -0
- data/lib/geminstaller/output_observer.rb +36 -0
- data/lib/geminstaller/output_proxy.rb +36 -0
- data/lib/geminstaller/registry.rb +127 -0
- data/lib/geminstaller/requires.rb +81 -0
- data/lib/geminstaller/rogue_gem_finder.rb +195 -0
- data/lib/geminstaller/ruby_gem.rb +58 -0
- data/lib/geminstaller/rubygems_exit.rb +5 -0
- data/lib/geminstaller/rubygems_extensions.rb +9 -0
- data/lib/geminstaller/rubygems_version_checker.rb +15 -0
- data/lib/geminstaller/rubygems_version_warnings.rb +38 -0
- data/lib/geminstaller/source_index_search_adapter.rb +41 -0
- data/lib/geminstaller/unauthorized_dependency_prompt_error.rb +4 -0
- data/lib/geminstaller/unexpected_prompt_error.rb +4 -0
- data/lib/geminstaller/valid_platform_selector.rb +49 -0
- data/lib/geminstaller/version_specifier.rb +24 -0
- data/lib/geminstaller/yaml_loader.rb +22 -0
- data/lib/geminstaller_rails_preinitializer.rb +46 -0
- data/start_local_gem_server.sh +1 -0
- data/test/test_all.rb +36 -0
- data/test/test_all_smoketests.rb +21 -0
- data/website/config.yaml +11 -0
- data/website/src/analytics.page +6 -0
- data/website/src/code/ci.virtual +5 -0
- data/website/src/code/coverage/index.virtual +5 -0
- data/website/src/code/index.page +88 -0
- data/website/src/code/rdoc/index.virtual +6 -0
- data/website/src/community/index.page +14 -0
- data/website/src/community/links.page +11 -0
- data/website/src/community/rubyforge.virtual +4 -0
- data/website/src/default.css +175 -0
- data/website/src/default.template +42 -0
- data/website/src/documentation/documentation.page +476 -0
- data/website/src/documentation/index.page +53 -0
- data/website/src/documentation/tutorials.page +337 -0
- data/website/src/download.page +12 -0
- data/website/src/faq.page +36 -0
- data/website/src/index.page +92 -0
- data/website/src/metainfo +54 -0
- data/website/src/webgen.css +112 -0
- metadata +80 -3
@@ -0,0 +1,58 @@
|
|
1
|
+
module GemInstaller
|
2
|
+
class RubyGem
|
3
|
+
include Comparable
|
4
|
+
attr_accessor :name, :version, :platform, :install_options, :check_for_upgrade, :fix_dependencies, :no_autogem, :prefer_binary_platform, :uninstall_options
|
5
|
+
|
6
|
+
def initialize(name, opts={})
|
7
|
+
@name = name
|
8
|
+
#TODO: the following logic could probably be more concise, but I'm not sure right now
|
9
|
+
@version = GemInstaller::RubyGem.default_version
|
10
|
+
if opts[:version] != "" && opts[:version] != nil
|
11
|
+
@version = opts[:version]
|
12
|
+
end
|
13
|
+
if GemInstaller::RubyGemsVersionChecker.matches?('<=0.9.5')
|
14
|
+
@platform = 'ruby'
|
15
|
+
end
|
16
|
+
if opts[:platform] != "" && opts[:platform] != nil
|
17
|
+
@platform = opts[:platform]
|
18
|
+
end
|
19
|
+
@install_options = opts[:install_options] ||= []
|
20
|
+
@uninstall_options = opts[:uninstall_options] ||= []
|
21
|
+
@check_for_upgrade = opts[:check_for_upgrade] == true ? true : false
|
22
|
+
@fix_dependencies = opts[:fix_dependencies] == true ? true : false
|
23
|
+
@no_autogem = opts[:no_autogem] == true ? true : false
|
24
|
+
if GemInstaller::RubyGemsVersionChecker.matches?('>=0.9.5')
|
25
|
+
warn("The 'prefer_binary_platform' option is deprecated on RubyGems >= 0.9.5, and has no effect") unless opts[:prefer_binary_platorm].nil?
|
26
|
+
else
|
27
|
+
@prefer_binary_platform = opts[:prefer_binary_platorm] == false ? false : true
|
28
|
+
end
|
29
|
+
end
|
30
|
+
|
31
|
+
def self.default_version
|
32
|
+
'> 0.0.0'
|
33
|
+
end
|
34
|
+
|
35
|
+
def self.default_platform
|
36
|
+
if GemInstaller::RubyGemsVersionChecker.matches?('>0.9.5')
|
37
|
+
Gem::Platform::CURRENT
|
38
|
+
else
|
39
|
+
# Not sure if this is actually required for RubyGems <=0.9.5, but it
|
40
|
+
# was the original value in GemInstaller <=0.3.0, and makes the tests pass
|
41
|
+
'ruby'
|
42
|
+
end
|
43
|
+
end
|
44
|
+
|
45
|
+
def <=>(other)
|
46
|
+
compare = @name <=> other.name
|
47
|
+
return compare if compare != 0
|
48
|
+
compare = @version <=> other.version # TODO: this should use rubygems version comparison, not string comparison
|
49
|
+
return compare if compare != 0
|
50
|
+
return 0 if (@platform == nil && other.platform == nil)
|
51
|
+
return @platform <=> other.platform
|
52
|
+
end
|
53
|
+
|
54
|
+
def regexp_escaped_name
|
55
|
+
Regexp.escape(@name)
|
56
|
+
end
|
57
|
+
end
|
58
|
+
end
|
@@ -0,0 +1,15 @@
|
|
1
|
+
require 'rubygems/rubygems_version'
|
2
|
+
|
3
|
+
module GemInstaller
|
4
|
+
class RubyGemsVersionChecker
|
5
|
+
def self.matches?(version_spec, options = {})
|
6
|
+
version_spec = [version_spec] unless version_spec.kind_of?(Array)
|
7
|
+
# TODO: if rubygems has already been initialized before GemInstaller overrides the rubygems version,
|
8
|
+
# (for example, by running rspec), then Gem::RubyGemsVersion could be initialized to the incorrect
|
9
|
+
# system-rubygems version instead of the geminstaller-overridden version. Need to figure out how
|
10
|
+
# to re-parse 'rubygems/rubygems_version' and let it redefine 'Gem::RubyGemsVersion'
|
11
|
+
rubygems_version = options[:rubygems_version] ||= Gem::RubyGemsVersion
|
12
|
+
Gem::Version::Requirement.new(version_spec).satisfied_by?(Gem::Version.new(rubygems_version))
|
13
|
+
end
|
14
|
+
end
|
15
|
+
end
|
@@ -0,0 +1,38 @@
|
|
1
|
+
module GemInstaller
|
2
|
+
class RubyGemsVersionWarnings
|
3
|
+
def self.outdated_warning(options = {})
|
4
|
+
return nil if allow_unsupported?
|
5
|
+
return nil if GemInstaller::RubyGemsVersionChecker.matches?('>=0.9.5', options)
|
6
|
+
return "\n\n----------------------------------------------------------------\n" +
|
7
|
+
"WARNING: You are using RubyGems version #{Gem::RubyGemsVersion}.\n" +
|
8
|
+
"You should update to RubyGems version 1.0.1 or above,\n" +
|
9
|
+
"because gems created for newer RubyGems versions\n" +
|
10
|
+
"might be incompatible.\n" +
|
11
|
+
"To update rubygems (recommended), use 'gem update --system'.\n" +
|
12
|
+
"----------------------------------------------------------------\n\n"
|
13
|
+
end
|
14
|
+
|
15
|
+
def self.incompatible_warning(options = {})
|
16
|
+
return nil if allow_unsupported?
|
17
|
+
return nil unless (
|
18
|
+
GemInstaller::RubyGemsVersionChecker.matches?('=0.9.5', options) or
|
19
|
+
GemInstaller::RubyGemsVersionChecker.matches?('=1.1.0', options)
|
20
|
+
)
|
21
|
+
return "\n\n----------------------------------------------------------------\n" +
|
22
|
+
"WARNING: You are using RubyGems version #{Gem::RubyGemsVersion}.\n" +
|
23
|
+
"This version is known to have bugs and/or compatibility issues\n" +
|
24
|
+
"with GemInstaller. Update RubyGems, or continue at your risk.\n" +
|
25
|
+
"To update rubygems (recommended), use 'gem update --system'.\n" +
|
26
|
+
"----------------------------------------------------------------\n\n"
|
27
|
+
end
|
28
|
+
|
29
|
+
def self.allow_unsupported?
|
30
|
+
defined? ALLOW_UNSUPPORTED_RUBYGEMS_VERSION
|
31
|
+
end
|
32
|
+
|
33
|
+
def self.print_warnings(options = {})
|
34
|
+
warnings = [self.outdated_warning, self.incompatible_warning].compact!
|
35
|
+
warnings.each {|warning| print warning}
|
36
|
+
end
|
37
|
+
end
|
38
|
+
end
|
@@ -0,0 +1,41 @@
|
|
1
|
+
module GemInstaller
|
2
|
+
class SourceIndexSearchAdapter
|
3
|
+
attr_writer :gem_source_index_proxy
|
4
|
+
|
5
|
+
def all_local_specs
|
6
|
+
if GemInstaller::RubyGemsVersionChecker.matches?('<=0.9.4')
|
7
|
+
search_less_than_or_equal_0_9_4('',GemInstaller::RubyGem.default_version)
|
8
|
+
else
|
9
|
+
dependency = Gem::Dependency.new('', GemInstaller::RubyGem.default_version)
|
10
|
+
@gem_source_index_proxy.refresh!
|
11
|
+
@gem_source_index_proxy.search(dependency, false)
|
12
|
+
end
|
13
|
+
end
|
14
|
+
|
15
|
+
def search(gem, version_requirement, platform_only = false)
|
16
|
+
if GemInstaller::RubyGemsVersionChecker.matches?('<=0.9.4')
|
17
|
+
gem_pattern = /^#{gem.regexp_escaped_name}$/
|
18
|
+
search_less_than_or_equal_0_9_4(gem_pattern, version_requirement)
|
19
|
+
else
|
20
|
+
search_greater_than_0_9_4(gem, version_requirement, platform_only)
|
21
|
+
end
|
22
|
+
end
|
23
|
+
|
24
|
+
def search_less_than_or_equal_0_9_4(gem_pattern, version_requirement)
|
25
|
+
@gem_source_index_proxy.refresh!
|
26
|
+
@gem_source_index_proxy.search(gem_pattern, version_requirement)
|
27
|
+
end
|
28
|
+
|
29
|
+
def search_greater_than_0_9_4(gem, version_requirement, platform_only = false)
|
30
|
+
dependency = Gem::Dependency.new(gem.name, version_requirement)
|
31
|
+
@gem_source_index_proxy.refresh!
|
32
|
+
@gem_source_index_proxy.search(dependency, platform_only)
|
33
|
+
end
|
34
|
+
|
35
|
+
end
|
36
|
+
end
|
37
|
+
|
38
|
+
|
39
|
+
|
40
|
+
|
41
|
+
|
@@ -0,0 +1,49 @@
|
|
1
|
+
module GemInstaller
|
2
|
+
class ValidPlatformSelector
|
3
|
+
attr_writer :options, :ruby_platform, :output_filter
|
4
|
+
|
5
|
+
def select(gem_platform = nil, exact_platform_match = false)
|
6
|
+
if GemInstaller::RubyGemsVersionChecker.matches?('>=0.9.5')
|
7
|
+
# valid_platform_selector is not used for RubyGems >= 0.9.5
|
8
|
+
raise RuntimeError.new("Internal GemInstaller Error: ValidPlatformSelector should not be used for RubyGems >= 0.9.5")
|
9
|
+
end
|
10
|
+
|
11
|
+
@ruby_platform ||= RUBY_PLATFORM
|
12
|
+
return [@ruby_platform] if gem_platform == Gem::Platform::CURRENT
|
13
|
+
return [gem_platform] if exact_platform_match
|
14
|
+
valid_platforms = []
|
15
|
+
valid_platforms += binary_platform_substring if binary_platform_substring
|
16
|
+
if @options[:prefer_binary_platform] == false
|
17
|
+
# put ruby first if prefer_binary_platform is false
|
18
|
+
valid_platforms.unshift('ruby')
|
19
|
+
else
|
20
|
+
# leave binary platform first if prefer_binary_platform is false or nil
|
21
|
+
valid_platforms << 'ruby'
|
22
|
+
end
|
23
|
+
if gem_platform and
|
24
|
+
!valid_platforms.include?(gem_platform)
|
25
|
+
# only prepend the gem_platform as the first choice if
|
26
|
+
# 1. it is not nil
|
27
|
+
# 2. it is not already in the list
|
28
|
+
# 3. it is not 'ruby'
|
29
|
+
valid_platforms.unshift(gem_platform)
|
30
|
+
end
|
31
|
+
message = "Selecting valid platform(s): @ruby_platform='#{@ruby_platform}', gem_platform='#{gem_platform}', valid_platforms='#{valid_platforms.inspect}'"
|
32
|
+
@output_filter.geminstaller_output(:debug,"#{message}\n")
|
33
|
+
valid_platforms
|
34
|
+
end
|
35
|
+
|
36
|
+
def binary_platform_substring
|
37
|
+
return ['686-darwin'] if @ruby_platform =~ /686-darwin/
|
38
|
+
return ['cygwin'] if @ruby_platform =~ /cygwin/
|
39
|
+
return ['powerpc'] if @ruby_platform =~ /powerpc/
|
40
|
+
return ['i386-mswin32','mswin32'] if @ruby_platform =~ /mswin/
|
41
|
+
return ['386-linux'] if @ruby_platform =~ /386-linux/
|
42
|
+
return ['486-linux'] if @ruby_platform =~ /486-linux/
|
43
|
+
return ['586-linux'] if @ruby_platform =~ /586-linux/
|
44
|
+
return ['686-linux'] if @ruby_platform =~ /686-linux/
|
45
|
+
return ['solaris'] if @ruby_platform =~ /solaris/
|
46
|
+
return nil
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
module GemInstaller
|
2
|
+
class VersionSpecifier
|
3
|
+
# NOTE: available_versions should be sorted in descending order (highest versions first)
|
4
|
+
# This method will return the first matching version
|
5
|
+
def specify(version_requirement, available_versions, gem_name = nil)
|
6
|
+
rubygems_version_requirement = Gem::Version::Requirement.new [version_requirement]
|
7
|
+
if available_versions.respond_to? :to_str
|
8
|
+
available_versions = available_versions.split(', ')
|
9
|
+
end
|
10
|
+
available_versions.each do |available_version_string|
|
11
|
+
available_version = Gem::Version.new(available_version_string)
|
12
|
+
if rubygems_version_requirement.satisfied_by?(available_version)
|
13
|
+
return available_version.to_s
|
14
|
+
end
|
15
|
+
end
|
16
|
+
gem_name_msg = ''
|
17
|
+
if gem_name
|
18
|
+
gem_name_msg = "for gem '#{gem_name}' "
|
19
|
+
end
|
20
|
+
error_msg = "The specified version requirement '#{version_requirement}' #{gem_name_msg}is not met by any of the available versions: #{available_versions.join(', ')}."
|
21
|
+
raise GemInstaller::GemInstallerError.new(error_msg)
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
@@ -0,0 +1,22 @@
|
|
1
|
+
module GemInstaller
|
2
|
+
class YamlLoader
|
3
|
+
def load(yaml_text)
|
4
|
+
yaml = nil
|
5
|
+
begin
|
6
|
+
yaml = YAML.load(yaml_text)
|
7
|
+
rescue Exception => e
|
8
|
+
message = e.message
|
9
|
+
error = <<-STRING_END
|
10
|
+
Error: Received error while attempting to parse YAML from yaml text:
|
11
|
+
#{message}
|
12
|
+
Please ensure this is valid YAML:
|
13
|
+
|
14
|
+
#{yaml_text}\n\n"
|
15
|
+
STRING_END
|
16
|
+
|
17
|
+
raise GemInstaller::GemInstallerError.new(error)
|
18
|
+
end
|
19
|
+
return yaml
|
20
|
+
end
|
21
|
+
end
|
22
|
+
end
|
@@ -0,0 +1,46 @@
|
|
1
|
+
############# GemInstaller Rails Preinitializer - see http://geminstaller.rubyforge.org
|
2
|
+
|
3
|
+
# This file should be required in your Rails config/preinitializer.rb for Rails >= 2.0,
|
4
|
+
# or required in config/boot.rb before initialization for Rails < 2.0. For example:
|
5
|
+
# require 'geminstaller_rails_preinitializer'
|
6
|
+
#
|
7
|
+
# If you require different geminstaller command options, copy this file into your Rails app,
|
8
|
+
# modify it, and require your customized version. For example:
|
9
|
+
# require "#{File.expand_path(RAILS_ROOT)}/config/custom_geminstaller_rails_preinitializer.rb"
|
10
|
+
|
11
|
+
require "rubygems"
|
12
|
+
require "geminstaller"
|
13
|
+
|
14
|
+
module GemInstallerRailsPreinitializer
|
15
|
+
class << self
|
16
|
+
def preinitialize
|
17
|
+
args = ''
|
18
|
+
|
19
|
+
# Specify --geminstaller-output=all and --rubygems-output=all for maximum debug logging
|
20
|
+
# args += ' --geminstaller-output=all --rubygems-output=all'
|
21
|
+
|
22
|
+
# The 'exceptions' flag determines whether errors encountered while running GemInstaller
|
23
|
+
# should raise exceptions (and abort Rails), or just return a nonzero return code
|
24
|
+
args += " --exceptions"
|
25
|
+
|
26
|
+
# This will use sudo by default on all non-windows platforms, but requires an entry in your
|
27
|
+
# sudoers file to avoid having to type a password. It can be omitted if you don't want to use sudo.
|
28
|
+
# See http://geminstaller.rubyforge.org/documentation/documentation.html#dealing_with_sudo
|
29
|
+
# Note that environment variables will NOT be passed via sudo!
|
30
|
+
#args += " --sudo" unless RUBY_PLATFORM =~ /mswin/
|
31
|
+
|
32
|
+
# The 'install' method will auto-install gems as specified by the args and config
|
33
|
+
# IMPORTANT NOTE: Under recent RubyGems versions, this will install to ~/.gem
|
34
|
+
GemInstaller.install(args)
|
35
|
+
|
36
|
+
# The 'autogem' method will automatically add all gems in the GemInstaller config to your load path,
|
37
|
+
# using the rubygems 'gem' method. Note that only the *first* version of any given gem will be loaded.
|
38
|
+
GemInstaller.autogem(args)
|
39
|
+
end
|
40
|
+
end
|
41
|
+
end
|
42
|
+
|
43
|
+
# Attempt to prevent GemInstaller from running twice, but won't work if it is executed
|
44
|
+
# in a separate interpreter (like rake tests)
|
45
|
+
GemInstallerRailsPreinitializer.preinitialize unless $geminstaller_initialized
|
46
|
+
$geminstaller_initialized = true
|
@@ -0,0 +1 @@
|
|
1
|
+
gem server --dir=./spec/fixture/gems --port=9909
|
data/test/test_all.rb
ADDED
@@ -0,0 +1,36 @@
|
|
1
|
+
print "\nRunning all GemInstaller Tests, ENV['RUBYGEMS_VERSION'] == '#{ENV['RUBYGEMS_VERSION']}'\n\n"
|
2
|
+
|
3
|
+
dir = File.dirname(__FILE__)
|
4
|
+
specdir = File.expand_path("#{dir}/../spec")
|
5
|
+
require File.expand_path("#{specdir}/helper/spec_helper")
|
6
|
+
|
7
|
+
spec_files = Dir.glob("#{specdir}/**/*_spec.rb")
|
8
|
+
|
9
|
+
# put test_gem_home_spec first so we only have to perform the install once
|
10
|
+
test_gem_home_path = Dir.glob("#{specdir}/functional/test_gem_home_spec.rb")[0]
|
11
|
+
spec_files.delete(test_gem_home_path)
|
12
|
+
spec_files.unshift(test_gem_home_path)
|
13
|
+
spec_files.uniq
|
14
|
+
|
15
|
+
args = spec_files
|
16
|
+
args << "--color"
|
17
|
+
args << "--format"
|
18
|
+
args << "specdoc"
|
19
|
+
args << "--diff"
|
20
|
+
args << "unified"
|
21
|
+
|
22
|
+
# append generated args to ARGV. THis may break if incompatible args are specified,
|
23
|
+
# but I don't know a better way to invoke Rspec 1.1.1 programatically and check the return value
|
24
|
+
ARGV.concat(args)
|
25
|
+
|
26
|
+
success = false
|
27
|
+
begin
|
28
|
+
require 'spec'
|
29
|
+
success = ::Spec::Runner::CommandLine.run
|
30
|
+
ensure
|
31
|
+
GemInstaller::TestGemHome.reset
|
32
|
+
end
|
33
|
+
# not sure what Spec::Runner::CommandLine.run can return, but fail if it's not boolean as expected
|
34
|
+
raise "unexpected non-boolean return value from Spec::Runner::CommandLine.run(rspec_options)" unless success == true || success == false
|
35
|
+
|
36
|
+
raise "Specs failed" unless success
|
@@ -0,0 +1,21 @@
|
|
1
|
+
print "\nRunning all GemInstaller SmokeTests, ENV['RUBYGEMS_VERSION'] == '#{ENV['RUBYGEMS_VERSION']}'\n\n"
|
2
|
+
|
3
|
+
dir = File.dirname(__FILE__)
|
4
|
+
smoketest_dir = File.expand_path("#{dir}/../spec/smoketest")
|
5
|
+
|
6
|
+
test_files = Dir.glob("#{smoketest_dir}/**/*_smoketest.rb")
|
7
|
+
|
8
|
+
test_files.each do |test_file|
|
9
|
+
raise "#{test_file} failed" unless system("ruby #{test_file}")
|
10
|
+
end
|
11
|
+
#
|
12
|
+
# class SmokeTestSuite
|
13
|
+
# def self.suite
|
14
|
+
# suite = Test::Unit::TestSuite.new
|
15
|
+
# suite << GemInstaller::AutoGemSmokeTest.suite
|
16
|
+
# # suite << GemInstaller::InstallSmokeTest.suite
|
17
|
+
# # suite << GemInstaller::RailsSmokeTest.suite
|
18
|
+
# return suite
|
19
|
+
# end
|
20
|
+
# end
|
21
|
+
# Test::Unit::UI::Console::TestRunner.run(SmokeTestSuite)
|
data/website/config.yaml
ADDED
@@ -0,0 +1,11 @@
|
|
1
|
+
# Configuration file for webgen
|
2
|
+
# Used to set the parameters of the plugins
|
3
|
+
default_meta_info:
|
4
|
+
Page:
|
5
|
+
blocks:
|
6
|
+
default: {pipeline: tags,redcloth,blocks}
|
7
|
+
Template:
|
8
|
+
blocks:
|
9
|
+
default: {pipeline: tags,redcloth,blocks}
|
10
|
+
tag.menu.show_current_subtree_only: true
|
11
|
+
tag.menu.nested: false
|
@@ -0,0 +1,88 @@
|
|
1
|
+
---
|
2
|
+
title: Design
|
3
|
+
---
|
4
|
+
h1. Design Notes
|
5
|
+
|
6
|
+
These are some notes on the underlying design of GemInstaller, and the current state of development:
|
7
|
+
|
8
|
+
* GemInstaller was developed from nothing but a concept, using "Behavior-Driven Development":http://behaviour-driven.org and "Rspec":http://rspec.rubyforge.org/.
|
9
|
+
* GemInstaller uses "Dependency Injection", an architecture which has many benefits, including testability and enabling "loose coupling and high cohesion":http://www.c2.com/cgi/wiki?CouplingAndCohesion. I originally started with "Needle":http://rubyforge.org/projects/needle/, a Ruby Dependency Injection framework, but switched to a simple home-grown approach in order to not have a dependency on the Needle gem. Read more about Dependency Injection here:
|
10
|
+
** "http://onestepback.org/index.cgi/Tech/Ruby/DependencyInjectionInRuby.rdoc":http://onestepback.org/index.cgi/Tech/Ruby/DependencyInjectionInRuby.rdoc
|
11
|
+
** "http://onestepback.org/articles/depinj/":http://onestepback.org/articles/depinj/
|
12
|
+
** "http://martinfowler.com/bliki/InversionOfControl.html":http://martinfowler.com/bliki/InversionOfControl.html
|
13
|
+
** "http://martinfowler.com/articles/injection.html":http://martinfowler.com/articles/injection.html
|
14
|
+
** "http://www.theserverside.com/tt/articles/article.tss?l=IOCBeginners":http://www.theserverside.com/tt/articles/article.tss?l=IOCBeginners
|
15
|
+
** "http://www.ibm.com/developerworks/edu/j-dw-java-springswing-i.html":http://www.ibm.com/developerworks/edu/j-dw-java-springswing-i.html
|
16
|
+
* A lot of effort has gone into supporting isolated functional testing. Every run of a functional spec or the spec suite creates a new "Test Gem Home" sandbox installation of RubyGems. This creates a new GEM_HOME on the fly for each run. This allows me to test actual gem installation without being connected to a network, and avoid mucking with (or having false failures due to) my actual local RubyGems gem repository. Unfortunately, the Ruby load path still uses the executables from the system installation of RubyGems. I plan on fixing that too (which will allow me to test multiple RubyGems versions), but that seems to be a much trickier task than just having a different GEM_HOME.
|
17
|
+
* Spec/Test Philosophy:
|
18
|
+
** GemInstaller's specs are grouped into distinct categories. This and other testing approaches I use are heavily influenced by this fine article at GroboUtils: "Naming Your Junit Tests":http://groboutils.sourceforge.net/testing-junit/art_naming.html
|
19
|
+
** Unit vs. Functional: Many classes have two identically-named spec files associated with them, under unit and functional.
|
20
|
+
*** Unit Specs: The Unit specs for the most part test only a single class in isolation, usually using mock objects, so they run very fast. Many of them are vestiges of my initial BDD approach when I started from nothing. I incur a little bit of overhead cost to maintain them as the app evolves, but I don't mind that as much as some people :). They also come in very handy when I want to BDD some new behavior and don't want to have the high "Test Gem Home" fixture creation overhead that the functional specs have.
|
21
|
+
*** Functional Specs: These also have a one-to-one relationship with classes for the most part - geminstaller_spec is an exception. Most of these test how groups of classes interact together at various levels. Most of them use the "Test Gem Home" fixture approach. This is effective, but adds several seconds to the startup of each run. There is also overlap between some of them, especially at high levels of the API, which adds some maintenance overhead, but is worth it to me since it helps catch integration bugs.
|
22
|
+
*** Smoke Tests: There are some tests under /spec/smoketests which are not part of the main spec suite. These are really coarse grained scripts. They hit the live rubygems.org gem repository, and install/uninstall actual gems, and exercise my sample rails app which uses GemInstaller. They are used as a check to ensure that my "Test Gem Home" fixture approach is not masking any real-life bugs.
|
23
|
+
* I'm a proponent of high code coverage. I check periodically to ensure I maintain close to 100% code coverage, not counting platform- and version-specific code blocks (and I'll get around to those some day). Also, the sudo recursive invocation stuff still needs some tests, but that's a bit tricky to automate.
|
24
|
+
* The tests are "harder" on Windows (but run fine on mac/linux). The app should work fine, but testing is pretty tricky. I have all tests working against the latest rubygems (1.0.1). Here's what does and doesn't work with tests against latest rubygems on windows:
|
25
|
+
* install_smoketest.rb and autogem_smoketest.rb work
|
26
|
+
* ruby test/test_all.rb works
|
27
|
+
* rake default test task does not work (this seems to be a problem with hoe on windows)
|
28
|
+
* Sometimes test suite still hangs after a while, this is probably some orphaned EmbeddedGemServer process somewhere. A reboot should fix it - this is windows, after all!
|
29
|
+
* One of my motivations for creating GemInstaller was as an exercise to help me learn Ruby better. If you see me doing anything obviously dumb or inefficient in the code or design, please let me know. Some of them I already know about, but haven't fixed, most I'm probably not aware of :)
|
30
|
+
|
31
|
+
<span id="rubygems_compatibility"/>
|
32
|
+
|
33
|
+
h1. Maintaining forward and backward compatibility with multiple RubyGems versions
|
34
|
+
|
35
|
+
* I've put a lot of effort into ensuring that GemInstaller works with older versions of RubyGems, and run automated tests against several recent versions on Continuous Integration.
|
36
|
+
|
37
|
+
* This wasn't as hard as it seems. The hardest part was figuring out what was different between versions. Once you understand that, you can add switch statements to perform different logic or tests depending on the version (which is easy if you use rubygems built in Version Requirement support - see GemInstaller::RubygemsVersionChecker).
|
38
|
+
|
39
|
+
* To run against different RubyGems versions, I have a RUBYGEMS_VERSION environment variable which causes the correct version or RubyGems in spec/fixture/rubygems_dist to be put on the load path and used for the test run.
|
40
|
+
|
41
|
+
* RubyGems 0.9.5 was a major upgrade, the preview release for 1.0. It introduced support for platforms, auto-install of missing dependencies, and many other things that GemInstaller already did.
|
42
|
+
|
43
|
+
* Here are the main differences in GemInstaller when running on RubyGems >=0.9.5:
|
44
|
+
** Don't use missing dependency finder (auto-install of missing dependencies is now built in)
|
45
|
+
** Don't use valid platform selector, use --platform option (auto-selection of platform is now built in)
|
46
|
+
** GemInteractionHandler should throw error on any interactive prompt (since dependencies and platforms are now handled automatically by default)
|
47
|
+
** The "<code>prefer_binary_platform</code> config property":../documentation/documentation.html#prefer_binary_platform_config_property no longer applies, and has no effect.
|
48
|
+
|
49
|
+
<span id="release_process"/>
|
50
|
+
|
51
|
+
h1. Release Process
|
52
|
+
|
53
|
+
Yeah, it's too manual. Notes for improvement below.
|
54
|
+
|
55
|
+
* Add section and entries for new release to History.txt
|
56
|
+
* Add same history info to history section on homepage.
|
57
|
+
* Update version in geminstaller.rb (if it was not done immediately after last publish, which it should have been)
|
58
|
+
* rake update_manifest
|
59
|
+
* Run tests:
|
60
|
+
** CI should be green for all versions
|
61
|
+
** install_smoketest.rb and autogem_smoketest.rb should pass for all RubyGems versions on mac/linux
|
62
|
+
** test_all, install_smoketest.rb and autogem_smoketest.rb should pass for latest RubyGems version on windows
|
63
|
+
* Make sure everything is checked in
|
64
|
+
* Make a tag in svn
|
65
|
+
* rake clean package
|
66
|
+
* Upload gem to rubyforge
|
67
|
+
* rake publish_website
|
68
|
+
* Bump the version in geminstaller.rb to the expected next release version.
|
69
|
+
|
70
|
+
Here's the improvements I need to make to the release process:
|
71
|
+
|
72
|
+
* Avoid duplication of history file to display on home page
|
73
|
+
* Make CI automatically build and tag a gem/package with next version + revision: x.y.z.<svn revision>
|
74
|
+
* Rake task to automatically tag and release latest build from CI and tag
|
75
|
+
|
76
|
+
<span id="rubygems_upgrade_process"/>
|
77
|
+
|
78
|
+
h1. Rubygems Upgrade Process
|
79
|
+
|
80
|
+
Process to test against new rubygems release.
|
81
|
+
|
82
|
+
<pre><code>
|
83
|
+
svn export http://rubygems.rubyforge.org/svn/tags/REL_X_Y_Z spec/fixture/rubygems_dist/rubygems-X.Y.Z
|
84
|
+
</code></pre>
|
85
|
+
|
86
|
+
* add spec/fixture/rubygems_dist/rubytems-X.Y.Z
|
87
|
+
* checkin
|
88
|
+
* Add project for that release on CI
|