For Ruby packagers to set configuration defaults. Set in rubygems/defaults/operating_system.rb
For Ruby implementers to set configuration defaults. Set in rubygems/defaults/#{RUBY_ENGINE}.rb
Bulk threshold value. If the number of missing gems are above this threshold value, then a bulk download technique is used. (deprecated)
Create the config file object. args is the list of arguments from the command line.
The following command line options are handled early here rather than later at the time most command options are processed.
--config-file, --config-file==NAME |
Obviously these need to be handled by the ConfigFile object to ensure we get the right config file. |
--backtrace |
Backtrace needs to be turned on early so that errors before normal option parsing can be properly handled. |
--debug |
Enable Ruby level debug messages. Handled early for the same reason as –backtrace. |
# File lib/rubygems/config_file.rb, line 162 def initialize(arg_list) @config_file_name = nil need_config_file_name = false arg_list = arg_list.map do |arg| if need_config_file_name then @config_file_name = arg need_config_file_name = false nil elsif arg =~ /^--config-file=(.*)/ then @config_file_name = $1 nil elsif arg =~ /^--config-file$/ then need_config_file_name = true nil else arg end end.compact @backtrace = DEFAULT_BACKTRACE @benchmark = DEFAULT_BENCHMARK @bulk_threshold = DEFAULT_BULK_THRESHOLD @verbose = DEFAULT_VERBOSITY @update_sources = DEFAULT_UPDATE_SOURCES operating_system_config = Marshal.load Marshal.dump(OPERATING_SYSTEM_DEFAULTS) platform_config = Marshal.load Marshal.dump(PLATFORM_DEFAULTS) system_config = load_file SYSTEM_WIDE_CONFIG_FILE user_config = load_file config_file_name.dup.untaint @hash = operating_system_config.merge platform_config @hash = @hash.merge system_config @hash = @hash.merge user_config # HACK these override command-line args, which is bad @backtrace = @hash[:backtrace] if @hash.key? :backtrace @benchmark = @hash[:benchmark] if @hash.key? :benchmark @bulk_threshold = @hash[:bulk_threshold] if @hash.key? :bulk_threshold @home = @hash[:gemhome] if @hash.key? :gemhome @path = @hash[:gempath] if @hash.key? :gempath @update_sources = @hash[:update_sources] if @hash.key? :update_sources @verbose = @hash[:verbose] if @hash.key? :verbose @ssl_verify_mode = @hash[:ssl_verify_mode] if @hash.key? :ssl_verify_mode @ssl_ca_cert = @hash[:ssl_ca_cert] if @hash.key? :ssl_ca_cert load_api_keys Gem.sources = @hash[:sources] if @hash.key? :sources handle_arguments arg_list end
Return the configuration information for key.
# File lib/rubygems/config_file.rb, line 353 def [](key) @hash[key.to_s] end
Set configuration option key to value.
# File lib/rubygems/config_file.rb, line 358 def []=(key, value) @hash[key.to_s] = value end
True if the backtrace option has been specified, or debug is on.
# File lib/rubygems/config_file.rb, line 262 def backtrace @backtrace or $DEBUG end
The name of the configuration file.
# File lib/rubygems/config_file.rb, line 267 def config_file_name @config_file_name || Gem.config_file end
Location of RubyGems.org credentials
# File lib/rubygems/config_file.rb, line 217 def credentials_path File.join Gem.user_home, '.gem', 'credentials' end
Delegates to @hash
# File lib/rubygems/config_file.rb, line 272 def each(&block) hash = @hash.dup hash.delete :update_sources hash.delete :verbose hash.delete :benchmark hash.delete :backtrace hash.delete :bulk_threshold yield :update_sources, @update_sources yield :verbose, @verbose yield :benchmark, @benchmark yield :backtrace, @backtrace yield :bulk_threshold, @bulk_threshold yield 'config_file_name', @config_file_name if @config_file_name hash.each(&block) end
Handle the command arguments.
# File lib/rubygems/config_file.rb, line 292 def handle_arguments(arg_list) @args = [] arg_list.each do |arg| case arg when /^--(backtrace|traceback)$/ then @backtrace = true when /^--bench(mark)?$/ then @benchmark = true when /^--debug$/ then $DEBUG = true else @args << arg end end end
# File lib/rubygems/config_file.rb, line 221 def load_api_keys @api_keys = if File.exist? credentials_path then load_file(credentials_path) else @hash end if @api_keys.key? :rubygems_api_key then @rubygems_api_key = @api_keys[:rubygems_api_key] @api_keys[:rubygems] = @api_keys.delete :rubygems_api_key unless @api_keys.key? :rubygems end end
# File lib/rubygems/config_file.rb, line 248 def load_file(filename) Gem.load_yaml return {} unless filename and File.exist? filename begin YAML.load(File.read(filename)) rescue ArgumentError warn "Failed to load #{config_file_name}" rescue Errno::EACCES warn "Failed to load #{config_file_name} due to permissions problem." end or {} end
Really verbose mode gives you extra output.
# File lib/rubygems/config_file.rb, line 310 def really_verbose case verbose when true, false, nil then false else true end end
# File lib/rubygems/config_file.rb, line 233 def rubygems_api_key=(api_key) config = load_file(credentials_path).merge(:rubygems_api_key => api_key) dirname = File.dirname credentials_path Dir.mkdir(dirname) unless File.exist? dirname Gem.load_yaml File.open(credentials_path, 'w') do |f| f.write config.to_yaml end @rubygems_api_key = api_key end
Generated with the Darkfish Rdoc Generator 2.