Class: Bundler::CLI
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Classes:
| |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
Thor
|
|
Instance Chain:
|
|
Inherits: |
Bundler::Thor
|
Defined in: | lib/bundler/cli.rb, lib/bundler/cli/gem.rb |
Constant Summary
-
AUTO_INSTALL_CMDS =
# File 'lib/bundler/cli.rb', line 12%w[show binstubs outdated exec open console licenses clean].freeze
-
PARSEABLE_COMMANDS =
# File 'lib/bundler/cli.rb', line 13%w[ check config help exec platform show version ].freeze
Thor
- Inherited
AmbiguousTaskError, DynamicTask, HELP_MAPPINGS, HiddenTask, TEMPLATE_EXTNAME, THOR_RESERVED_WORDS, Task, UndefinedTaskError, VERSION
Class Method Summary
- .deprecated_option(*args, &blk)
- .dispatch
- .handle_no_command_error(command, has_namespace = $thor_runner)
- .new(*args) ⇒ CLI constructor
-
.reformatted_help_args(args)
Reformat the arguments passed to bundle that include a –help flag into the corresponding
bundle help #{command}
call. - .source_root
- .start
Thor
- Inherited
.check_unknown_options! | Extend check unknown options to accept a hash of conditions. |
.command_help | Prints help information for the given command. |
.default_command | Sets the default command when thor is executed without an explicit command to be called. |
.default_task | Alias for Thor.default_command. |
.desc | Defines the usage and the description of the next command. |
.disable_required_check! | Disable the check for required options for the given commands. |
.help | Prints help information for this class. |
.long_desc | Defines the long description of the next command. |
.map | Maps an input to a command. |
.method_option | Adds an option to the set of method options. |
.method_options | Declares the options for the next command to be declared. |
.option | Alias for Thor.method_option. |
.options | Alias for Thor.method_options. |
.package_name | Allows for custom “Command” package naming. |
.printable_commands | Returns commands ready to be printed. |
.printable_tasks | Alias for Thor.printable_commands. |
.register | Registers another |
.stop_on_unknown_option! | Stop parsing of options as soon as an unknown option or a regular argument is encountered. |
.subcommand, .subcommand_classes, .subcommands, | |
.subtask | Alias for Thor.subcommand. |
.subtasks | Alias for Thor.subcommands. |
.task_help | Alias for Thor.command_help. |
.banner | The banner for this class. |
.create_task | Alias for Thor.create_command. |
.find_command_possibilities | this is the logic that takes the command name passed in by the user and determines whether it is an unambiguous substrings of a command or alias name. |
.find_task_possibilities | Alias for Thor.find_command_possibilities. |
.normalize_task_name | Alias for Thor.normalize_command_name. |
.retrieve_task_name | Alias for Thor.retrieve_command_name. |
.subcommand_help, | |
.subtask_help | Alias for Thor.subcommand_help. |
.check_unknown_options? | Overwrite check_unknown_options? to take subcommands and options into account. |
.disable_required_check?, .stop_on_unknown_option?, .baseclass, .create_command, | |
.disable_required_check | help command has the required check disabled by default. |
.dispatch | The method responsible for dispatching given the args. |
.dynamic_command_class, .initialize_added, | |
.normalize_command_name | receives a (possibly nil) command name and returns a name that is in the commands hash. |
.retrieve_command_name | Retrieve the command name from given args. |
.stop_on_unknown_option |
Instance Attribute Summary
Thor::Actions
- Included
#behavior, | |
#destination_root | Returns the root for this thor class (also aliased as destination root). |
#destination_root= | Sets the root for this thor class. |
#output_buffer |
Thor::Base
- Included
Instance Method Summary
- #add(*gems)
- #binstubs(*gems)
- #cache
- #check
- #clean
- #cli_help
- #config(*args)
- #console(group = nil)
- #doctor
- #env
- #exec(*args)
- #help(cli = nil)
- #info(gem_name)
- #init
- #inject(name, version)
- #install
- #issue
- #licenses
- #list
- #lock
- #open(name)
- #outdated(*gems)
- #package
- #platform
- #pristine(*gems)
- #remove(*gems)
- #show(gem_name = nil)
- #update(*gems)
- #version
- #viz
- #auto_install private
- #current_command private
- #gem(name) private
- #print_command private
- #warn_on_outdated_bundler private
Thor::Actions
- Included
#add_file | Alias for Thor::Actions#create_file. |
#add_link | Alias for Thor::Actions#create_link. |
#append_file | Alias for Thor::Actions#append_to_file. |
#append_to_file | Append text to a file. |
#apply | Loads an external file and execute it in the instance binding. |
#chmod | Changes the mode of the given file or directory. |
#comment_lines | Comment all lines matching a given regex. |
#copy_file | Examples. |
#create_file | Create a new file relative to the destination root with the given data, which is the return value of a block or a data string. |
#create_link | Create a new file relative to the destination root from the given source. |
#directory | Copies recursively the files from source directory to root directory. |
#empty_directory | Creates an empty directory. |
#find_in_source_paths | Receives a file or directory and search for it in the source paths. |
#get | Gets the content at the given address and places it at the given relative destination. |
#gsub_file | Run a regular expression replacement on a file. |
#in_root | Goes to the root and execute the given block. |
#initialize | Extends initializer to add more configuration options. |
#inject_into_class | Injects text right after the class definition. |
#inject_into_file | Alias for Thor::Actions#insert_into_file. |
#inject_into_module | Injects text right after the module definition. |
#insert_into_file | Injects the given content into a file. |
#inside | Do something in the root or on a provided subfolder. |
#link_file | Links the file from the relative source to the relative destination. |
#prepend_file | Alias for Thor::Actions#prepend_to_file. |
#prepend_to_file | Prepend text to a file. |
#relative_to_original_destination_root | Returns the given path relative to the absolute root (ie, root where the script started). |
#remove_dir | Alias for Thor::Actions#remove_file. |
#remove_file | Removes a file at the given location. |
#run | Executes a command returning the contents of the command. |
#run_ruby_script | Executes a ruby script (taking into account WIN32 platform quirks). |
#source_paths | Holds source paths in instance so they can be manipulated. |
#template | Gets an ERB template at the relative source, executes it and makes a copy at the relative destination. |
#thor | Run a thor command. |
#uncomment_lines | Uncomment all lines matching a given regex. |
#capture, #concat, | |
#action | Wraps an action object and call it accordingly to the thor class behavior. |
#_cleanup_options_and_set, | |
#_shared_configuration | Allow current root to be shared between invocations. |
#with_output_buffer |
Thor
- Inherited
Thor::Base
- Included
#initialize | It receives arguments in an Array and two hashes, one for options and other for configuration. |
Constructor Details
.new(*args) ⇒ CLI
# File 'lib/bundler/cli.rb', line 33
def initialize(*args) super custom_gemfile = [:gemfile] || Bundler.settings[:gemfile] if custom_gemfile && !custom_gemfile.empty? Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", File. (custom_gemfile) Bundler.reset_paths! end Bundler.settings.set_command_option_if_given :retry, [:retry] current_cmd = args.last[:current_command].name auto_install if AUTO_INSTALL_CMDS.include?(current_cmd) rescue UnknownArgumentError => e raise InvalidOption, e. ensure self. ||= {} unprinted_warnings = Bundler.ui.unprinted_warnings Bundler.ui = UI::Shell.new( ) Bundler.ui.level = "debug" if ["verbose"] unprinted_warnings.each {|w| Bundler.ui.warn(w) } if ENV["RUBYGEMS_GEMDEPS"] && !ENV["RUBYGEMS_GEMDEPS"].empty? Bundler.ui.warn( "The RUBYGEMS_GEMDEPS environment variable is set. This enables RubyGems' " \ "experimental Gemfile mode, which may conflict with Bundler and cause unexpected errors. " \ "To remove this warning, unset RUBYGEMS_GEMDEPS.", :wrap => true ) end end
Class Method Details
.deprecated_option(*args, &blk)
[ GitHub ]# File 'lib/bundler/cli.rb', line 64
def self.deprecated_option(*args, &blk) return if Bundler.feature_flag. method_option(*args, &blk) end
.dispatch
[ GitHub ]# File 'lib/bundler/cli.rb', line 26
def self.dispatch(*) super do |i| i.send(:print_command) i.send(:warn_on_outdated_bundler) end end
.handle_no_command_error(command, has_namespace = $thor_runner)
[ GitHub ]# File 'lib/bundler/cli.rb', line 129
def self.handle_no_command_error(command, has_namespace = $thor_runner) if Bundler.feature_flag.plugins? && Bundler::Plugin.command?(command) return Bundler::Plugin.exec_command(command, ARGV[1..-1]) end return super unless command_path = Bundler.which("bundler-#{command}") Kernel.exec(command_path, *ARGV[1..-1]) end
.reformatted_help_args(args)
Reformat the arguments passed to bundle that include a –help flag into the corresponding bundle help #{command}
call
# File 'lib/bundler/cli.rb', line 691
def self.reformatted_help_args(args) bundler_commands = all_commands.keys help_flags = %w[--help -h] exec_commands = %w[e ex exe exec] help_used = args.index {|a| help_flags.include? a } exec_used = args.index {|a| exec_commands.include? a } command = args.find {|a| bundler_commands.include? a } if exec_used && help_used if exec_used + help_used == 1 %w[help exec] else args end elsif help_used args = args.dup args.delete_at(help_used) ["help", command || args].flatten.compact else args end end
.source_root
[ GitHub ]# File 'lib/bundler/cli.rb', line 583
def self.source_root File. (File.join(File.dirname(__FILE__), "templates")) end
.start
[ GitHub ]# File 'lib/bundler/cli.rb', line 17
def self.start(*) super rescue Exception => e Bundler.ui = UI::Shell.new raise e ensure Bundler::SharedHelpers.print_major_deprecations! end
Instance Method Details
#add(*gems)
[ GitHub ]#auto_install (private)
Automatically invoke bundle install
and resume if ::Bundler
.settings exists. This is set through config cmd bundle config auto_install 1
.
Note that this method nil
s out the global Definition
object, so it should be called first, before you instantiate anything like an Installer
that’ll keep a reference to the old one instead.
#binstubs(*gems)
[ GitHub ]#cache
[ GitHub ]#check
[ GitHub ]#clean
[ GitHub ]#cli_help
[ GitHub ]# File 'lib/bundler/cli.rb', line 73
def cli_help version Bundler.ui.info "\n" primary_commands = ["install", "update", Bundler.feature_flag.cache_command_is_package? ? "cache" : "package", "exec", "config", "help"] list = self.class.printable_commands(true) by_name = list.group_by {|name, | name.match(/^bundle (\w+)/)[1] } utilities = by_name.keys.sort - primary_commands primary_commands.map! {|name| (by_name[name] || raise("no primary command #{name}")).first } utilities.map! {|name| by_name[name].first } shell.say "Bundler commands:\n\n" shell.say " Primary commands:\n" shell.print_table(primary_commands, :indent => 4, :truncate => true) shell.say shell.say " Utilities:\n" shell.print_table(utilities, :indent => 4, :truncate => true) shell.say self.class.send(:, shell) end
#config(*args)
[ GitHub ]#console(group = nil)
[ GitHub ]#current_command (private)
[ GitHub ]#doctor
[ GitHub ]#env
[ GitHub ]#exec(*args)
[ GitHub ]#gem(name) (private)
[ GitHub ]# File 'lib/bundler/cli.rb', line 558
def gem(name) end
#help(cli = nil)
[ GitHub ]# File 'lib/bundler/cli.rb', line 104
def help(cli = nil) case cli when "gemfile" then command = "gemfile" when nil then command = "bundle" else command = "bundle-#{cli}" end man_path = File. ("../../../man", __FILE__) man_pages = Hash[Dir.glob(File.join(man_path, "*")).grep(/.*\.\d*\Z/).collect do |f| [File.basename(f, ".*"), f] end] if man_pages.include?(command) if Bundler.which("man") && man_path !~ %r{^file:/.!/META-INF/jruby.home/.} Kernel.exec "man #{man_pages[command]}" else puts File.read("#{man_path}/#{File.basename(man_pages[command])}.txt") end elsif command_path = Bundler.which("bundler-#{cli}") Kernel.exec(command_path, "--help") else super end end
#info(gem_name)
[ GitHub ]#init
[ GitHub ]#inject(name, version)
[ GitHub ]# File 'lib/bundler/cli.rb', line 610
def inject(name, version) SharedHelpers.major_deprecation 2, "The `inject` command has been replaced by the `add` command" require "bundler/cli/inject" Inject.new( .dup, name, version).run end
#install
[ GitHub ]# File 'lib/bundler/cli.rb', line 231
def install SharedHelpers.major_deprecation(2, "The `--force` option has been renamed to `--redownload`") if ARGV.include?("--force") require "bundler/cli/install" Bundler.settings.temporary(:no_install => false) do Install.new( .dup).run end end
#issue
[ GitHub ]#licenses
[ GitHub ]#list
[ GitHub ]#lock
[ GitHub ]#open(name)
[ GitHub ]#outdated(*gems)
[ GitHub ]#package
[ GitHub ]#platform
[ GitHub ]#print_command (private)
[ GitHub ]# File 'lib/bundler/cli.rb', line 740
def print_command return unless Bundler.ui.debug? cmd = current_command command_name = cmd.name return if PARSEABLE_COMMANDS.include?(command_name) command = ["bundle", command_name] + args = .dup .delete_if do |k, v| next unless o = cmd. [k] o.default == v end command << Thor::Options.to_switches( .sort_by(&:first)).strip command.reject!(&:empty?) Bundler.ui.info "Running `#{command * " "}` with bundler #{Bundler::VERSION}" end
#pristine(*gems)
[ GitHub ]#remove(*gems)
[ GitHub ]#show(gem_name = nil)
[ GitHub ]# File 'lib/bundler/cli.rb', line 292
def show(gem_name = nil) if ARGV[0] == "show" rest = ARGV[1..-1] new_command = rest.find {|arg| !arg.start_with?("--") } ? "info" : "list" new_arguments = rest.map do |arg| next arg if arg != "--paths" next "--path" if new_command == "info" end old_argv = ARGV.join(" ") new_argv = [new_command, *new_arguments.compact].join(" ") Bundler::SharedHelpers.major_deprecation(2, "use `bundle #{new_argv}` instead of `bundle #{old_argv}`") end require "bundler/cli/show" Show.new(, gem_name).run end
#update(*gems)
[ GitHub ]# File 'lib/bundler/cli.rb', line 277
def update(*gems) SharedHelpers.major_deprecation(2, "The `--force` option has been renamed to `--redownload`") if ARGV.include?("--force") require "bundler/cli/update" Update.new(, gems).run end
#version
[ GitHub ]# File 'lib/bundler/cli.rb', line 499
def version cli_help = current_command.name == "cli_help" if cli_help || ARGV.include?("version") build_info = " (#{BuildMetadata.built_at} commit #{BuildMetadata.git_commit_sha})" end if !cli_help && Bundler.feature_flag.print_only_version_number? Bundler.ui.info "#{Bundler::VERSION}#{build_info}" else Bundler.ui.info "Bundler version #{Bundler::VERSION}#{build_info}" end end
#viz
[ GitHub ]# File 'lib/bundler/cli.rb', line 539
def viz SharedHelpers.major_deprecation 2, "The `viz` command has been moved to the `bundle-viz` gem, see https://github.com/bundler/bundler-viz" require "bundler/cli/viz" Viz.new( .dup).run end
#warn_on_outdated_bundler (private)
[ GitHub ]# File 'lib/bundler/cli.rb', line 756
def warn_on_outdated_bundler return if Bundler.settings[:disable_version_check] command_name = current_command.name return if PARSEABLE_COMMANDS.include?(command_name) return unless SharedHelpers.md5_available? latest = Fetcher::CompactIndex. new(nil, Source::Rubygems::Remote.new(URI("https://rubygems.org")), nil). send(:compact_index_client). instance_variable_get(:@cache). dependencies("bundler"). map {|d| Gem::Version.new(d.first) }. max return unless latest current = Gem::Version.new(VERSION) return if current >= latest latest_installed = Bundler.rubygems.find_name("bundler").map(&:version).max installation = "To install the latest version, run `gem install bundler#{" --pre" if latest.prerelease?}`" if latest_installed && latest_installed > current suggestion = "To update to the most recent installed version (#{latest_installed}), run `bundle update --bundler`" suggestion = "#{installation}\n#{suggestion}" if latest_installed < latest else suggestion = installation end Bundler.ui.warn "The latest bundler is #{latest}, but you are currently running #{current}.\n#{suggestion}" rescue RuntimeError nil end