bundler-maglev- 1.0.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/.gitignore +22 -0
- data/.travis.yml +32 -0
- data/CHANGELOG.md +805 -0
- data/ISSUES.md +62 -0
- data/LICENSE +23 -0
- data/README.md +29 -0
- data/Rakefile +212 -0
- data/UPGRADING.md +103 -0
- data/bin/bundle +22 -0
- data/bundler.gemspec +30 -0
- data/lib/bundler.rb +286 -0
- data/lib/bundler/capistrano.rb +11 -0
- data/lib/bundler/cli.rb +520 -0
- data/lib/bundler/definition.rb +438 -0
- data/lib/bundler/dependency.rb +134 -0
- data/lib/bundler/deployment.rb +58 -0
- data/lib/bundler/dsl.rb +257 -0
- data/lib/bundler/environment.rb +47 -0
- data/lib/bundler/gem_helper.rb +151 -0
- data/lib/bundler/gem_installer.rb +9 -0
- data/lib/bundler/gem_tasks.rb +2 -0
- data/lib/bundler/graph.rb +130 -0
- data/lib/bundler/index.rb +138 -0
- data/lib/bundler/installer.rb +97 -0
- data/lib/bundler/lazy_specification.rb +74 -0
- data/lib/bundler/lockfile_parser.rb +108 -0
- data/lib/bundler/remote_specification.rb +59 -0
- data/lib/bundler/resolver.rb +464 -0
- data/lib/bundler/rubygems_ext.rb +237 -0
- data/lib/bundler/rubygems_integration.rb +349 -0
- data/lib/bundler/runtime.rb +152 -0
- data/lib/bundler/settings.rb +115 -0
- data/lib/bundler/setup.rb +23 -0
- data/lib/bundler/shared_helpers.rb +71 -0
- data/lib/bundler/source.rb +708 -0
- data/lib/bundler/spec_set.rb +135 -0
- data/lib/bundler/templates/Executable +16 -0
- data/lib/bundler/templates/Gemfile +4 -0
- data/lib/bundler/templates/newgem/Gemfile.tt +4 -0
- data/lib/bundler/templates/newgem/Rakefile.tt +1 -0
- data/lib/bundler/templates/newgem/bin/newgem.tt +3 -0
- data/lib/bundler/templates/newgem/gitignore.tt +4 -0
- data/lib/bundler/templates/newgem/lib/newgem.rb.tt +9 -0
- data/lib/bundler/templates/newgem/lib/newgem/version.rb.tt +7 -0
- data/lib/bundler/templates/newgem/newgem.gemspec.tt +24 -0
- data/lib/bundler/ui.rb +73 -0
- data/lib/bundler/vendor/thor.rb +358 -0
- data/lib/bundler/vendor/thor/actions.rb +314 -0
- data/lib/bundler/vendor/thor/actions/create_file.rb +105 -0
- data/lib/bundler/vendor/thor/actions/create_link.rb +57 -0
- data/lib/bundler/vendor/thor/actions/directory.rb +93 -0
- data/lib/bundler/vendor/thor/actions/empty_directory.rb +134 -0
- data/lib/bundler/vendor/thor/actions/file_manipulation.rb +270 -0
- data/lib/bundler/vendor/thor/actions/inject_into_file.rb +109 -0
- data/lib/bundler/vendor/thor/base.rb +576 -0
- data/lib/bundler/vendor/thor/core_ext/file_binary_read.rb +9 -0
- data/lib/bundler/vendor/thor/core_ext/hash_with_indifferent_access.rb +75 -0
- data/lib/bundler/vendor/thor/core_ext/ordered_hash.rb +100 -0
- data/lib/bundler/vendor/thor/error.rb +30 -0
- data/lib/bundler/vendor/thor/group.rb +273 -0
- data/lib/bundler/vendor/thor/invocation.rb +168 -0
- data/lib/bundler/vendor/thor/parser.rb +4 -0
- data/lib/bundler/vendor/thor/parser/argument.rb +67 -0
- data/lib/bundler/vendor/thor/parser/arguments.rb +161 -0
- data/lib/bundler/vendor/thor/parser/option.rb +120 -0
- data/lib/bundler/vendor/thor/parser/options.rb +175 -0
- data/lib/bundler/vendor/thor/rake_compat.rb +66 -0
- data/lib/bundler/vendor/thor/runner.rb +309 -0
- data/lib/bundler/vendor/thor/shell.rb +88 -0
- data/lib/bundler/vendor/thor/shell/basic.rb +302 -0
- data/lib/bundler/vendor/thor/shell/color.rb +108 -0
- data/lib/bundler/vendor/thor/shell/html.rb +121 -0
- data/lib/bundler/vendor/thor/task.rb +113 -0
- data/lib/bundler/vendor/thor/util.rb +229 -0
- data/lib/bundler/vendor/thor/version.rb +3 -0
- data/lib/bundler/vendored_thor.rb +7 -0
- data/lib/bundler/version.rb +6 -0
- data/lib/bundler/vlad.rb +11 -0
- data/man/bundle-config.ronn +90 -0
- data/man/bundle-exec.ronn +111 -0
- data/man/bundle-install.ronn +317 -0
- data/man/bundle-package.ronn +59 -0
- data/man/bundle-update.ronn +176 -0
- data/man/bundle.ronn +80 -0
- data/man/gemfile.5.ronn +284 -0
- data/man/index.txt +6 -0
- data/spec/bundler/gem_helper_spec.rb +143 -0
- data/spec/cache/gems_spec.rb +230 -0
- data/spec/cache/git_spec.rb +12 -0
- data/spec/cache/path_spec.rb +27 -0
- data/spec/cache/platform_spec.rb +57 -0
- data/spec/install/deploy_spec.rb +197 -0
- data/spec/install/deprecated_spec.rb +37 -0
- data/spec/install/gems/c_ext_spec.rb +48 -0
- data/spec/install/gems/env_spec.rb +107 -0
- data/spec/install/gems/flex_spec.rb +313 -0
- data/spec/install/gems/groups_spec.rb +259 -0
- data/spec/install/gems/packed_spec.rb +84 -0
- data/spec/install/gems/platform_spec.rb +192 -0
- data/spec/install/gems/resolving_spec.rb +72 -0
- data/spec/install/gems/simple_case_spec.rb +770 -0
- data/spec/install/gems/sudo_spec.rb +74 -0
- data/spec/install/gems/win32_spec.rb +26 -0
- data/spec/install/gemspec_spec.rb +125 -0
- data/spec/install/git_spec.rb +570 -0
- data/spec/install/invalid_spec.rb +35 -0
- data/spec/install/path_spec.rb +405 -0
- data/spec/install/upgrade_spec.rb +26 -0
- data/spec/lock/git_spec.rb +35 -0
- data/spec/lock/lockfile_spec.rb +739 -0
- data/spec/other/check_spec.rb +221 -0
- data/spec/other/config_spec.rb +40 -0
- data/spec/other/console_spec.rb +54 -0
- data/spec/other/exec_spec.rb +248 -0
- data/spec/other/ext_spec.rb +37 -0
- data/spec/other/help_spec.rb +39 -0
- data/spec/other/init_spec.rb +40 -0
- data/spec/other/newgem_spec.rb +46 -0
- data/spec/other/open_spec.rb +35 -0
- data/spec/other/show_spec.rb +82 -0
- data/spec/quality_spec.rb +62 -0
- data/spec/resolver/basic_spec.rb +20 -0
- data/spec/resolver/platform_spec.rb +82 -0
- data/spec/runtime/executable_spec.rb +110 -0
- data/spec/runtime/load_spec.rb +107 -0
- data/spec/runtime/platform_spec.rb +90 -0
- data/spec/runtime/require_spec.rb +231 -0
- data/spec/runtime/setup_spec.rb +730 -0
- data/spec/runtime/with_clean_env_spec.rb +15 -0
- data/spec/spec_helper.rb +92 -0
- data/spec/support/builders.rb +597 -0
- data/spec/support/helpers.rb +239 -0
- data/spec/support/indexes.rb +112 -0
- data/spec/support/matchers.rb +77 -0
- data/spec/support/path.rb +71 -0
- data/spec/support/platforms.rb +53 -0
- data/spec/support/ruby_ext.rb +20 -0
- data/spec/support/rubygems_ext.rb +37 -0
- data/spec/support/rubygems_hax/platform.rb +11 -0
- data/spec/support/sudo.rb +21 -0
- data/spec/update/gems_spec.rb +122 -0
- data/spec/update/git_spec.rb +196 -0
- data/spec/update/source_spec.rb +51 -0
- metadata +296 -0
@@ -0,0 +1,135 @@
|
|
1
|
+
require 'tsort'
|
2
|
+
require 'forwardable'
|
3
|
+
|
4
|
+
module Bundler
|
5
|
+
class SpecSet
|
6
|
+
extend Forwardable
|
7
|
+
include TSort, Enumerable
|
8
|
+
|
9
|
+
def_delegators :@specs, :<<, :length, :add, :remove
|
10
|
+
def_delegators :sorted, :each
|
11
|
+
|
12
|
+
def initialize(specs)
|
13
|
+
@specs = specs.sort_by { |s| s.name }
|
14
|
+
end
|
15
|
+
|
16
|
+
def for(dependencies, skip = [], check = false, match_current_platform = false)
|
17
|
+
handled, deps, specs = {}, dependencies.dup, []
|
18
|
+
skip << 'bundler'
|
19
|
+
|
20
|
+
until deps.empty?
|
21
|
+
dep = deps.shift
|
22
|
+
next if handled[dep] || skip.include?(dep.name)
|
23
|
+
|
24
|
+
spec = lookup[dep.name].find do |s|
|
25
|
+
match_current_platform ?
|
26
|
+
Gem::Platform.match(s.platform) :
|
27
|
+
s.match_platform(dep.__platform)
|
28
|
+
end
|
29
|
+
|
30
|
+
handled[dep] = true
|
31
|
+
|
32
|
+
if spec
|
33
|
+
specs << spec
|
34
|
+
|
35
|
+
spec.dependencies.each do |d|
|
36
|
+
next if d.type == :development
|
37
|
+
d = DepProxy.new(d, dep.__platform) unless match_current_platform
|
38
|
+
deps << d
|
39
|
+
end
|
40
|
+
elsif check
|
41
|
+
return false
|
42
|
+
end
|
43
|
+
end
|
44
|
+
|
45
|
+
if spec = lookup['bundler'].first
|
46
|
+
specs << spec
|
47
|
+
end
|
48
|
+
|
49
|
+
check ? true : SpecSet.new(specs)
|
50
|
+
end
|
51
|
+
|
52
|
+
def valid_for?(deps)
|
53
|
+
self.for(deps, [], true)
|
54
|
+
end
|
55
|
+
|
56
|
+
def [](key)
|
57
|
+
key = key.name if key.respond_to?(:name)
|
58
|
+
lookup[key].reverse
|
59
|
+
end
|
60
|
+
|
61
|
+
def []=(key, value)
|
62
|
+
@specs << value
|
63
|
+
@lookup = nil
|
64
|
+
@sorted = nil
|
65
|
+
value
|
66
|
+
end
|
67
|
+
|
68
|
+
def sort!
|
69
|
+
self
|
70
|
+
end
|
71
|
+
|
72
|
+
def to_a
|
73
|
+
sorted.dup
|
74
|
+
end
|
75
|
+
|
76
|
+
def to_hash
|
77
|
+
lookup.dup
|
78
|
+
end
|
79
|
+
|
80
|
+
def materialize(deps, missing_specs = nil)
|
81
|
+
materialized = self.for(deps, [], false, true).to_a
|
82
|
+
materialized.map! do |s|
|
83
|
+
next s unless s.is_a?(LazySpecification)
|
84
|
+
spec = s.__materialize__
|
85
|
+
if missing_specs
|
86
|
+
missing_specs << s unless spec
|
87
|
+
else
|
88
|
+
raise GemNotFound, "Could not find #{s.full_name} in any of the sources" unless spec
|
89
|
+
end
|
90
|
+
spec if spec
|
91
|
+
end
|
92
|
+
SpecSet.new(materialized.compact)
|
93
|
+
end
|
94
|
+
|
95
|
+
def merge(set)
|
96
|
+
arr = sorted.dup
|
97
|
+
set.each do |s|
|
98
|
+
next if arr.any? { |s2| s2.name == s.name && s2.version == s.version && s2.platform == s.platform }
|
99
|
+
arr << s
|
100
|
+
end
|
101
|
+
SpecSet.new(arr)
|
102
|
+
end
|
103
|
+
|
104
|
+
private
|
105
|
+
|
106
|
+
def sorted
|
107
|
+
rake = @specs.find { |s| s.name == 'rake' }
|
108
|
+
@sorted ||= ([rake] + tsort).compact.uniq
|
109
|
+
end
|
110
|
+
|
111
|
+
def lookup
|
112
|
+
@lookup ||= begin
|
113
|
+
lookup = Hash.new { |h,k| h[k] = [] }
|
114
|
+
specs = @specs.sort_by do |s|
|
115
|
+
s.platform.to_s == 'ruby' ? "\0" : s.platform.to_s
|
116
|
+
end
|
117
|
+
specs.reverse_each do |s|
|
118
|
+
lookup[s.name] << s
|
119
|
+
end
|
120
|
+
lookup
|
121
|
+
end
|
122
|
+
end
|
123
|
+
|
124
|
+
def tsort_each_node
|
125
|
+
@specs.each { |s| yield s }
|
126
|
+
end
|
127
|
+
|
128
|
+
def tsort_each_child(s)
|
129
|
+
s.dependencies.sort_by { |d| d.name }.each do |d|
|
130
|
+
next if d.type == :development
|
131
|
+
lookup[d.name].each { |s2| yield s2 }
|
132
|
+
end
|
133
|
+
end
|
134
|
+
end
|
135
|
+
end
|
@@ -0,0 +1,16 @@
|
|
1
|
+
#!/usr/bin/env <%= RbConfig::CONFIG['ruby_install_name'] %>
|
2
|
+
#
|
3
|
+
# This file was generated by Bundler.
|
4
|
+
#
|
5
|
+
# The application '<%= executable %>' is installed as part of a gem, and
|
6
|
+
# this file is here to facilitate running it.
|
7
|
+
#
|
8
|
+
|
9
|
+
require 'pathname'
|
10
|
+
ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../<%= relative_gemfile_path %>",
|
11
|
+
Pathname.new(__FILE__).realpath)
|
12
|
+
|
13
|
+
require 'rubygems'
|
14
|
+
require 'bundler/setup'
|
15
|
+
|
16
|
+
load Gem.bin_path('<%= spec.name %>', '<%= executable %>')
|
@@ -0,0 +1 @@
|
|
1
|
+
require "bundler/gem_tasks"
|
@@ -0,0 +1,9 @@
|
|
1
|
+
require "<%=config[:name]%>/version"
|
2
|
+
|
3
|
+
<%- config[:constant_array].each_with_index do |c,i| -%>
|
4
|
+
<%= ' '*i %>module <%= c %>
|
5
|
+
<%- end -%>
|
6
|
+
<%= ' '*config[:constant_array].size %># Your code goes here...
|
7
|
+
<%- (config[:constant_array].size-1).downto(0) do |i| -%>
|
8
|
+
<%= ' '*i %>end
|
9
|
+
<%- end -%>
|
@@ -0,0 +1,24 @@
|
|
1
|
+
# -*- encoding: utf-8 -*-
|
2
|
+
$:.push File.expand_path("../lib", __FILE__)
|
3
|
+
require "<%=config[:name]%>/version"
|
4
|
+
|
5
|
+
Gem::Specification.new do |s|
|
6
|
+
s.name = <%=config[:name].inspect%>
|
7
|
+
s.version = <%=config[:constant_name]%>::VERSION
|
8
|
+
s.authors = ["<%= config[:author_name] %>"]
|
9
|
+
s.email = ["<%= config[:author_email] %>"]
|
10
|
+
s.homepage = ""
|
11
|
+
s.summary = %q{TODO: Write a gem summary}
|
12
|
+
s.description = %q{TODO: Write a gem description}
|
13
|
+
|
14
|
+
s.rubyforge_project = <%=config[:name].inspect%>
|
15
|
+
|
16
|
+
s.files = `git ls-files`.split("\n")
|
17
|
+
s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
|
18
|
+
s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
|
19
|
+
s.require_paths = ["lib"]
|
20
|
+
|
21
|
+
# specify any dependencies here; for example:
|
22
|
+
# s.add_development_dependency "rspec"
|
23
|
+
# s.add_runtime_dependency "rest-client"
|
24
|
+
end
|
data/lib/bundler/ui.rb
ADDED
@@ -0,0 +1,73 @@
|
|
1
|
+
require 'rubygems/user_interaction'
|
2
|
+
|
3
|
+
module Bundler
|
4
|
+
class UI
|
5
|
+
def warn(message)
|
6
|
+
end
|
7
|
+
|
8
|
+
def debug(message)
|
9
|
+
end
|
10
|
+
|
11
|
+
def error(message)
|
12
|
+
end
|
13
|
+
|
14
|
+
def info(message)
|
15
|
+
end
|
16
|
+
|
17
|
+
def confirm(message)
|
18
|
+
end
|
19
|
+
|
20
|
+
class Shell < UI
|
21
|
+
attr_writer :shell
|
22
|
+
|
23
|
+
def initialize(shell)
|
24
|
+
@shell = shell
|
25
|
+
@quiet = false
|
26
|
+
@debug = ENV['DEBUG']
|
27
|
+
end
|
28
|
+
|
29
|
+
def debug(msg)
|
30
|
+
@shell.say(msg) if @debug && !@quiet
|
31
|
+
end
|
32
|
+
|
33
|
+
def info(msg)
|
34
|
+
@shell.say(msg) if !@quiet
|
35
|
+
end
|
36
|
+
|
37
|
+
def confirm(msg)
|
38
|
+
@shell.say(msg, :green) if !@quiet
|
39
|
+
end
|
40
|
+
|
41
|
+
def warn(msg)
|
42
|
+
@shell.say(msg, :yellow)
|
43
|
+
end
|
44
|
+
|
45
|
+
def error(msg)
|
46
|
+
@shell.say(msg, :red)
|
47
|
+
end
|
48
|
+
|
49
|
+
def be_quiet!
|
50
|
+
@quiet = true
|
51
|
+
end
|
52
|
+
|
53
|
+
def debug!
|
54
|
+
@debug = true
|
55
|
+
end
|
56
|
+
end
|
57
|
+
|
58
|
+
class RGProxy < ::Gem::SilentUI
|
59
|
+
def initialize(ui)
|
60
|
+
@ui = ui
|
61
|
+
super()
|
62
|
+
end
|
63
|
+
|
64
|
+
def say(message)
|
65
|
+
if message =~ /native extensions/
|
66
|
+
@ui.info "with native extensions "
|
67
|
+
else
|
68
|
+
@ui.debug(message)
|
69
|
+
end
|
70
|
+
end
|
71
|
+
end
|
72
|
+
end
|
73
|
+
end
|
@@ -0,0 +1,358 @@
|
|
1
|
+
require 'thor/base'
|
2
|
+
|
3
|
+
class Thor
|
4
|
+
class << self
|
5
|
+
# Sets the default task when thor is executed without an explicit task to be called.
|
6
|
+
#
|
7
|
+
# ==== Parameters
|
8
|
+
# meth<Symbol>:: name of the defaut task
|
9
|
+
#
|
10
|
+
def default_task(meth=nil)
|
11
|
+
case meth
|
12
|
+
when :none
|
13
|
+
@default_task = 'help'
|
14
|
+
when nil
|
15
|
+
@default_task ||= from_superclass(:default_task, 'help')
|
16
|
+
else
|
17
|
+
@default_task = meth.to_s
|
18
|
+
end
|
19
|
+
end
|
20
|
+
|
21
|
+
# Registers another Thor subclass as a command.
|
22
|
+
#
|
23
|
+
# ==== Parameters
|
24
|
+
# klass<Class>:: Thor subclass to register
|
25
|
+
# command<String>:: Subcommand name to use
|
26
|
+
# usage<String>:: Short usage for the subcommand
|
27
|
+
# description<String>:: Description for the subcommand
|
28
|
+
def register(klass, subcommand_name, usage, description, options={})
|
29
|
+
if klass <= Thor::Group
|
30
|
+
desc usage, description, options
|
31
|
+
define_method(subcommand_name) { invoke klass }
|
32
|
+
else
|
33
|
+
desc usage, description, options
|
34
|
+
subcommand subcommand_name, klass
|
35
|
+
end
|
36
|
+
end
|
37
|
+
|
38
|
+
# Defines the usage and the description of the next task.
|
39
|
+
#
|
40
|
+
# ==== Parameters
|
41
|
+
# usage<String>
|
42
|
+
# description<String>
|
43
|
+
# options<String>
|
44
|
+
#
|
45
|
+
def desc(usage, description, options={})
|
46
|
+
if options[:for]
|
47
|
+
task = find_and_refresh_task(options[:for])
|
48
|
+
task.usage = usage if usage
|
49
|
+
task.description = description if description
|
50
|
+
else
|
51
|
+
@usage, @desc, @hide = usage, description, options[:hide] || false
|
52
|
+
end
|
53
|
+
end
|
54
|
+
|
55
|
+
# Defines the long description of the next task.
|
56
|
+
#
|
57
|
+
# ==== Parameters
|
58
|
+
# long description<String>
|
59
|
+
#
|
60
|
+
def long_desc(long_description, options={})
|
61
|
+
if options[:for]
|
62
|
+
task = find_and_refresh_task(options[:for])
|
63
|
+
task.long_description = long_description if long_description
|
64
|
+
else
|
65
|
+
@long_desc = long_description
|
66
|
+
end
|
67
|
+
end
|
68
|
+
|
69
|
+
# Maps an input to a task. If you define:
|
70
|
+
#
|
71
|
+
# map "-T" => "list"
|
72
|
+
#
|
73
|
+
# Running:
|
74
|
+
#
|
75
|
+
# thor -T
|
76
|
+
#
|
77
|
+
# Will invoke the list task.
|
78
|
+
#
|
79
|
+
# ==== Parameters
|
80
|
+
# Hash[String|Array => Symbol]:: Maps the string or the strings in the array to the given task.
|
81
|
+
#
|
82
|
+
def map(mappings=nil)
|
83
|
+
@map ||= from_superclass(:map, {})
|
84
|
+
|
85
|
+
if mappings
|
86
|
+
mappings.each do |key, value|
|
87
|
+
if key.respond_to?(:each)
|
88
|
+
key.each {|subkey| @map[subkey] = value}
|
89
|
+
else
|
90
|
+
@map[key] = value
|
91
|
+
end
|
92
|
+
end
|
93
|
+
end
|
94
|
+
|
95
|
+
@map
|
96
|
+
end
|
97
|
+
|
98
|
+
# Declares the options for the next task to be declared.
|
99
|
+
#
|
100
|
+
# ==== Parameters
|
101
|
+
# Hash[Symbol => Object]:: The hash key is the name of the option and the value
|
102
|
+
# is the type of the option. Can be :string, :array, :hash, :boolean, :numeric
|
103
|
+
# or :required (string). If you give a value, the type of the value is used.
|
104
|
+
#
|
105
|
+
def method_options(options=nil)
|
106
|
+
@method_options ||= {}
|
107
|
+
build_options(options, @method_options) if options
|
108
|
+
@method_options
|
109
|
+
end
|
110
|
+
|
111
|
+
# Adds an option to the set of method options. If :for is given as option,
|
112
|
+
# it allows you to change the options from a previous defined task.
|
113
|
+
#
|
114
|
+
# def previous_task
|
115
|
+
# # magic
|
116
|
+
# end
|
117
|
+
#
|
118
|
+
# method_option :foo => :bar, :for => :previous_task
|
119
|
+
#
|
120
|
+
# def next_task
|
121
|
+
# # magic
|
122
|
+
# end
|
123
|
+
#
|
124
|
+
# ==== Parameters
|
125
|
+
# name<Symbol>:: The name of the argument.
|
126
|
+
# options<Hash>:: Described below.
|
127
|
+
#
|
128
|
+
# ==== Options
|
129
|
+
# :desc - Description for the argument.
|
130
|
+
# :required - If the argument is required or not.
|
131
|
+
# :default - Default value for this argument. It cannot be required and have default values.
|
132
|
+
# :aliases - Aliases for this option.
|
133
|
+
# :type - The type of the argument, can be :string, :hash, :array, :numeric or :boolean.
|
134
|
+
# :banner - String to show on usage notes.
|
135
|
+
#
|
136
|
+
def method_option(name, options={})
|
137
|
+
scope = if options[:for]
|
138
|
+
find_and_refresh_task(options[:for]).options
|
139
|
+
else
|
140
|
+
method_options
|
141
|
+
end
|
142
|
+
|
143
|
+
build_option(name, options, scope)
|
144
|
+
end
|
145
|
+
|
146
|
+
# Prints help information for the given task.
|
147
|
+
#
|
148
|
+
# ==== Parameters
|
149
|
+
# shell<Thor::Shell>
|
150
|
+
# task_name<String>
|
151
|
+
#
|
152
|
+
def task_help(shell, task_name)
|
153
|
+
meth = normalize_task_name(task_name)
|
154
|
+
task = all_tasks[meth]
|
155
|
+
handle_no_task_error(meth) unless task
|
156
|
+
|
157
|
+
shell.say "Usage:"
|
158
|
+
shell.say " #{banner(task)}"
|
159
|
+
shell.say
|
160
|
+
class_options_help(shell, nil => task.options.map { |_, o| o })
|
161
|
+
if task.long_description
|
162
|
+
shell.say "Description:"
|
163
|
+
shell.print_wrapped(task.long_description, :ident => 2)
|
164
|
+
else
|
165
|
+
shell.say task.description
|
166
|
+
end
|
167
|
+
end
|
168
|
+
|
169
|
+
# Prints help information for this class.
|
170
|
+
#
|
171
|
+
# ==== Parameters
|
172
|
+
# shell<Thor::Shell>
|
173
|
+
#
|
174
|
+
def help(shell, subcommand = false)
|
175
|
+
list = printable_tasks(true, subcommand)
|
176
|
+
Thor::Util.thor_classes_in(self).each do |klass|
|
177
|
+
list += klass.printable_tasks(false)
|
178
|
+
end
|
179
|
+
list.sort!{ |a,b| a[0] <=> b[0] }
|
180
|
+
|
181
|
+
shell.say "Tasks:"
|
182
|
+
shell.print_table(list, :ident => 2, :truncate => true)
|
183
|
+
shell.say
|
184
|
+
class_options_help(shell)
|
185
|
+
end
|
186
|
+
|
187
|
+
# Returns tasks ready to be printed.
|
188
|
+
def printable_tasks(all = true, subcommand = false)
|
189
|
+
(all ? all_tasks : tasks).map do |_, task|
|
190
|
+
next if task.hidden?
|
191
|
+
item = []
|
192
|
+
item << banner(task, false, subcommand)
|
193
|
+
item << (task.description ? "# #{task.description.gsub(/\s+/m,' ')}" : "")
|
194
|
+
item
|
195
|
+
end.compact
|
196
|
+
end
|
197
|
+
|
198
|
+
def subcommands
|
199
|
+
@subcommands ||= from_superclass(:subcommands, [])
|
200
|
+
end
|
201
|
+
|
202
|
+
def subcommand(subcommand, subcommand_class)
|
203
|
+
self.subcommands << subcommand.to_s
|
204
|
+
subcommand_class.subcommand_help subcommand
|
205
|
+
define_method(subcommand) { |*args| invoke subcommand_class, args }
|
206
|
+
end
|
207
|
+
|
208
|
+
# Extend check unknown options to accept a hash of conditions.
|
209
|
+
#
|
210
|
+
# === Parameters
|
211
|
+
# options<Hash>: A hash containing :only and/or :except keys
|
212
|
+
def check_unknown_options!(options={})
|
213
|
+
@check_unknown_options ||= Hash.new
|
214
|
+
options.each do |key, value|
|
215
|
+
if value
|
216
|
+
@check_unknown_options[key] = Array(value)
|
217
|
+
else
|
218
|
+
@check_unknown_options.delete(key)
|
219
|
+
end
|
220
|
+
end
|
221
|
+
@check_unknown_options
|
222
|
+
end
|
223
|
+
|
224
|
+
# Overwrite check_unknown_options? to take subcommands and options into account.
|
225
|
+
def check_unknown_options?(config) #:nodoc:
|
226
|
+
options = check_unknown_options
|
227
|
+
return false unless options
|
228
|
+
|
229
|
+
task = config[:current_task]
|
230
|
+
return true unless task
|
231
|
+
|
232
|
+
name = task.name
|
233
|
+
|
234
|
+
if subcommands.include?(name)
|
235
|
+
false
|
236
|
+
elsif options[:except]
|
237
|
+
!options[:except].include?(name.to_sym)
|
238
|
+
elsif options[:only]
|
239
|
+
options[:only].include?(name.to_sym)
|
240
|
+
else
|
241
|
+
true
|
242
|
+
end
|
243
|
+
end
|
244
|
+
|
245
|
+
protected
|
246
|
+
|
247
|
+
# The method responsible for dispatching given the args.
|
248
|
+
def dispatch(meth, given_args, given_opts, config) #:nodoc:
|
249
|
+
meth ||= retrieve_task_name(given_args)
|
250
|
+
task = all_tasks[normalize_task_name(meth)]
|
251
|
+
|
252
|
+
if task
|
253
|
+
args, opts = Thor::Options.split(given_args)
|
254
|
+
else
|
255
|
+
args, opts = given_args, nil
|
256
|
+
task = Thor::DynamicTask.new(meth)
|
257
|
+
end
|
258
|
+
|
259
|
+
opts = given_opts || opts || []
|
260
|
+
config.merge!(:current_task => task, :task_options => task.options)
|
261
|
+
|
262
|
+
trailing = args[Range.new(arguments.size, -1)]
|
263
|
+
new(args, opts, config).invoke_task(task, trailing || [])
|
264
|
+
end
|
265
|
+
|
266
|
+
# The banner for this class. You can customize it if you are invoking the
|
267
|
+
# thor class by another ways which is not the Thor::Runner. It receives
|
268
|
+
# the task that is going to be invoked and a boolean which indicates if
|
269
|
+
# the namespace should be displayed as arguments.
|
270
|
+
#
|
271
|
+
def banner(task, namespace = nil, subcommand = false)
|
272
|
+
"#{basename} #{task.formatted_usage(self, $thor_runner, subcommand)}"
|
273
|
+
end
|
274
|
+
|
275
|
+
def baseclass #:nodoc:
|
276
|
+
Thor
|
277
|
+
end
|
278
|
+
|
279
|
+
def create_task(meth) #:nodoc:
|
280
|
+
if @usage && @desc
|
281
|
+
base_class = @hide ? Thor::HiddenTask : Thor::Task
|
282
|
+
tasks[meth] = base_class.new(meth, @desc, @long_desc, @usage, method_options)
|
283
|
+
@usage, @desc, @long_desc, @method_options, @hide = nil
|
284
|
+
true
|
285
|
+
elsif self.all_tasks[meth] || meth == "method_missing"
|
286
|
+
true
|
287
|
+
else
|
288
|
+
puts "[WARNING] Attempted to create task #{meth.inspect} without usage or description. " <<
|
289
|
+
"Call desc if you want this method to be available as task or declare it inside a " <<
|
290
|
+
"no_tasks{} block. Invoked from #{caller[1].inspect}."
|
291
|
+
false
|
292
|
+
end
|
293
|
+
end
|
294
|
+
|
295
|
+
def initialize_added #:nodoc:
|
296
|
+
class_options.merge!(method_options)
|
297
|
+
@method_options = nil
|
298
|
+
end
|
299
|
+
|
300
|
+
# Retrieve the task name from given args.
|
301
|
+
def retrieve_task_name(args) #:nodoc:
|
302
|
+
meth = args.first.to_s unless args.empty?
|
303
|
+
|
304
|
+
if meth && (map[meth] || meth !~ /^\-/)
|
305
|
+
args.shift
|
306
|
+
else
|
307
|
+
nil
|
308
|
+
end
|
309
|
+
end
|
310
|
+
|
311
|
+
# Receives a task name (can be nil), and try to get a map from it.
|
312
|
+
# If a map can't be found use the sent name or the default task.
|
313
|
+
def normalize_task_name(meth) #:nodoc:
|
314
|
+
meth = map[meth.to_s] || find_subcommand_and_update_argv(meth) || meth || default_task
|
315
|
+
meth.to_s.gsub('-','_') # treat foo-bar > foo_bar
|
316
|
+
end
|
317
|
+
|
318
|
+
# terrible hack that overwrites ARGV
|
319
|
+
def find_subcommand_and_update_argv(subcmd_name) #:nodoc:
|
320
|
+
return unless subcmd_name
|
321
|
+
cmd = find_subcommand(subcmd_name)
|
322
|
+
ARGV[0] = cmd if cmd
|
323
|
+
cmd
|
324
|
+
end
|
325
|
+
|
326
|
+
def find_subcommand(subcmd_name)
|
327
|
+
possibilities = find_subcommand_possibilities subcmd_name
|
328
|
+
if possibilities.size > 1
|
329
|
+
raise "Ambiguous subcommand #{subcmd_name} matches [#{possibilities.join(', ')}]"
|
330
|
+
elsif possibilities.size < 1
|
331
|
+
return nil
|
332
|
+
end
|
333
|
+
|
334
|
+
possibilities.first
|
335
|
+
end
|
336
|
+
|
337
|
+
def find_subcommand_possibilities(subcmd_name)
|
338
|
+
len = subcmd_name.length
|
339
|
+
all_tasks.map {|t| t.first}.select { |n| subcmd_name == n[0, len] }
|
340
|
+
end
|
341
|
+
|
342
|
+
def subcommand_help(cmd)
|
343
|
+
desc "help [COMMAND]", "Describe subcommands or one specific subcommand"
|
344
|
+
class_eval <<-RUBY
|
345
|
+
def help(task = nil, subcommand = true); super; end
|
346
|
+
RUBY
|
347
|
+
end
|
348
|
+
end
|
349
|
+
|
350
|
+
include Thor::Base
|
351
|
+
|
352
|
+
map HELP_MAPPINGS => :help
|
353
|
+
|
354
|
+
desc "help [TASK]", "Describe available tasks or one specific task"
|
355
|
+
def help(task = nil, subcommand = false)
|
356
|
+
task ? self.class.task_help(shell, task) : self.class.help(shell, subcommand)
|
357
|
+
end
|
358
|
+
end
|