#$@%#$%!

Ngiler SH3LL 360
: / opt / alt / ruby33 / share / rubygems / rubygems /

Information Server
MySQL : OFF Perl : OFF CURL : ON WGET : OFF PKEXEC : OFF

Directive	Local Value
IP Address	162.0.209.101
System	Linux premium169.web-hosting.com 4.18.0-553.50.1.lve.el8.x86_64 #1 SMP Thu Apr 17 19:10:24 UTC 2025 x86_64
User	luxeelil
PHP Version	8.0.30
Software	LiteSpeed
Doc root	Writable

Edit File : user_interaction.rb \| Size : 13.10 KB
# frozen_string_literal: true #-- # Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others. # All rights reserved. # See LICENSE.txt for permissions. #++ require_relative "deprecate" require_relative "text" ## # Module that defines the default UserInteraction. Any class including this # module will have access to the +ui+ method that returns the default UI. module Gem::DefaultUserInteraction include Gem::Text ## # The default UI is a class variable of the singleton class for this # module. @ui = nil ## # Return the default UI. def self.ui @ui \|\|= Gem::ConsoleUI.new end ## # Set the default UI. If the default UI is never explicitly set, a simple # console based UserInteraction will be used automatically. def self.ui=(new_ui) @ui = new_ui end ## # Use +new_ui+ for the duration of +block+. def self.use_ui(new_ui) old_ui = @ui @ui = new_ui yield ensure @ui = old_ui end ## # See DefaultUserInteraction::ui def ui Gem::DefaultUserInteraction.ui end ## # See DefaultUserInteraction::ui= def ui=(new_ui) Gem::DefaultUserInteraction.ui = new_ui end ## # See DefaultUserInteraction::use_ui def use_ui(new_ui, &block) Gem::DefaultUserInteraction.use_ui(new_ui, &block) end end ## # UserInteraction allows RubyGems to interact with the user through standard # methods that can be replaced with more-specific UI methods for different # displays. # # Since UserInteraction dispatches to a concrete UI class you may need to # reference other classes for specific behavior such as Gem::ConsoleUI or # Gem::SilentUI. # # Example: # # class X # include Gem::UserInteraction # # def get_answer # n = ask("What is the meaning of life?") # end # end module Gem::UserInteraction include Gem::DefaultUserInteraction ## # Displays an alert +statement+. Asks a +question+ if given. def alert(statement, question = nil) ui.alert statement, question end ## # Displays an error +statement+ to the error output location. Asks a # +question+ if given. def alert_error(statement, question = nil) ui.alert_error statement, question end ## # Displays a warning +statement+ to the warning output location. Asks a # +question+ if given. def alert_warning(statement, question = nil) ui.alert_warning statement, question end ## # Asks a +question+ and returns the answer. def ask(question) ui.ask question end ## # Asks for a password with a +prompt+ def ask_for_password(prompt) ui.ask_for_password prompt end ## # Asks a yes or no +question+. Returns true for yes, false for no. def ask_yes_no(question, default = nil) ui.ask_yes_no question, default end ## # Asks the user to answer +question+ with an answer from the given +list+. def choose_from_list(question, list) ui.choose_from_list question, list end ## # Displays the given +statement+ on the standard output (or equivalent). def say(statement = "") ui.say statement end ## # Terminates the RubyGems process with the given +exit_code+ def terminate_interaction(exit_code = 0) ui.terminate_interaction exit_code end ## # Calls +say+ with +msg+ or the results of the block if really_verbose # is true. def verbose(msg = nil) say(clean_text(msg \|\| yield)) if Gem.configuration.really_verbose end end ## # Gem::StreamUI implements a simple stream based user interface. class Gem::StreamUI extend Gem::Deprecate ## # The input stream attr_reader :ins ## # The output stream attr_reader :outs ## # The error stream attr_reader :errs ## # Creates a new StreamUI wrapping +in_stream+ for user input, +out_stream+ # for standard output, +err_stream+ for error output. If +usetty+ is true # then special operations (like asking for passwords) will use the TTY # commands to disable character echo. def initialize(in_stream, out_stream, err_stream=$stderr, usetty=true) @ins = in_stream @outs = out_stream @errs = err_stream @usetty = usetty end ## # Returns true if TTY methods should be used on this StreamUI. def tty? @usetty && @ins.tty? end ## # Prints a formatted backtrace to the errors stream if backtraces are # enabled. def backtrace(exception) return unless Gem.configuration.backtrace @errs.puts "\t#{exception.backtrace.join "\n\t"}" end ## # Choose from a list of options. +question+ is a prompt displayed above # the list. +list+ is a list of option strings. Returns the pair # [option_name, option_index]. def choose_from_list(question, list) @outs.puts question list.each_with_index do \|item, index\| @outs.puts " #{index + 1}. #{item}" end @outs.print "> " @outs.flush result = @ins.gets return nil, nil unless result result = result.strip.to_i - 1 return nil, nil unless (0...list.size) === result [list[result], result] end ## # Ask a question. Returns a true for yes, false for no. If not connected # to a tty, raises an exception if default is nil, otherwise returns # default. def ask_yes_no(question, default=nil) unless tty? if default.nil? raise Gem::OperationNotSupportedError, "Not connected to a tty and no default specified" else return default end end default_answer = case default when nil "yn" when true "Yn" else "yN" end result = nil while result.nil? do result = case ask "#{question} [#{default_answer}]" when /^y/i then true when /^n/i then false when /^$/ then default end end result end ## # Ask a question. Returns an answer if connected to a tty, nil otherwise. def ask(question) return nil unless tty? @outs.print(question + " ") @outs.flush result = @ins.gets result&.chomp! result end ## # Ask for a password. Does not echo response to terminal. def ask_for_password(question) return nil unless tty? @outs.print(question, " ") @outs.flush password = _gets_noecho @outs.puts password&.chomp! password end def require_io_console @require_io_console \|\|= begin begin require "io/console" rescue LoadError end true end end def _gets_noecho require_io_console @ins.noecho { @ins.gets } end ## # Display a statement. def say(statement="") @outs.puts statement end ## # Display an informational alert. Will ask +question+ if it is not nil. def alert(statement, question=nil) @outs.puts "INFO: #{statement}" ask(question) if question end ## # Display a warning on stderr. Will ask +question+ if it is not nil. def alert_warning(statement, question=nil) @errs.puts "WARNING: #{statement}" ask(question) if question end ## # Display an error message in a location expected to get error messages. # Will ask +question+ if it is not nil. def alert_error(statement, question=nil) @errs.puts "ERROR: #{statement}" ask(question) if question end ## # Terminate the application with exit code +status+, running any exit # handlers that might have been defined. def terminate_interaction(status = 0) close raise Gem::SystemExitException, status end def close end ## # Return a progress reporter object chosen from the current verbosity. def progress_reporter(args) case Gem.configuration.verbose when nil, false SilentProgressReporter.new(@outs, args) when true SimpleProgressReporter.new(@outs, args) else VerboseProgressReporter.new(@outs, args) end end ## # An absolutely silent progress reporter. class SilentProgressReporter ## # The count of items is never updated for the silent progress reporter. attr_reader :count ## # Creates a silent progress reporter that ignores all input arguments. def initialize(out_stream, size, initial_message, terminal_message = nil) end ## # Does not print +message+ when updated as this object has taken a vow of # silence. def updated(message) end ## # Does not print anything when complete as this object has taken a vow of # silence. def done end end ## # A basic dotted progress reporter. class SimpleProgressReporter include Gem::DefaultUserInteraction ## # The number of progress items counted so far. attr_reader :count ## # Creates a new progress reporter that will write to +out_stream+ for # +size+ items. Shows the given +initial_message+ when progress starts # and the +terminal_message+ when it is complete. def initialize(out_stream, size, initial_message, terminal_message = "complete") @out = out_stream @total = size @count = 0 @terminal_message = terminal_message @out.puts initial_message end ## # Prints out a dot and ignores +message+. def updated(message) @count += 1 @out.print "." @out.flush end ## # Prints out the terminal message. def done @out.puts "\n#{@terminal_message}" end end ## # A progress reporter that prints out messages about the current progress. class VerboseProgressReporter include Gem::DefaultUserInteraction ## # The number of progress items counted so far. attr_reader :count ## # Creates a new progress reporter that will write to +out_stream+ for # +size+ items. Shows the given +initial_message+ when progress starts # and the +terminal_message+ when it is complete. def initialize(out_stream, size, initial_message, terminal_message = "complete") @out = out_stream @total = size @count = 0 @terminal_message = terminal_message @out.puts initial_message end ## # Prints out the position relative to the total and the +message+. def updated(message) @count += 1 @out.puts "#{@count}/#{@total}: #{message}" end ## # Prints out the terminal message. def done @out.puts @terminal_message end end ## # Return a download reporter object chosen from the current verbosity def download_reporter(args) if [nil, false].include?(Gem.configuration.verbose) \|\| !@outs.tty? SilentDownloadReporter.new(@outs, args) else ThreadedDownloadReporter.new(@outs, args) end end ## # An absolutely silent download reporter. class SilentDownloadReporter ## # The silent download reporter ignores all arguments def initialize(out_stream, args) end ## # The silent download reporter does not display +filename+ or care about # +filesize+ because it is silent. def fetch(filename, filesize) end ## # Nothing can update the silent download reporter. def update(current) end ## # The silent download reporter won't tell you when the download is done. # Because it is silent. def done end end ## # A progress reporter that behaves nicely with threaded downloading. class ThreadedDownloadReporter MUTEX = Thread::Mutex.new ## # The current file name being displayed attr_reader :file_name ## # Creates a new threaded download reporter that will display on # +out_stream+. The other arguments are ignored. def initialize(out_stream, args) @file_name = nil @out = out_stream end ## # Tells the download reporter that the +file_name+ is being fetched. # The other arguments are ignored. def fetch(file_name, args) if @file_name.nil? @file_name = file_name locked_puts "Fetching #{@file_name}" end end ## # Updates the threaded download reporter for the given number of +bytes+. def update(bytes) # Do nothing. end ## # Indicates the download is complete. def done # Do nothing. end private def locked_puts(message) MUTEX.synchronize do @out.puts message end end end end ## # Subclass of StreamUI that instantiates the user interaction using $stdin, # $stdout, and $stderr. class Gem::ConsoleUI < Gem::StreamUI ## # The Console UI has no arguments as it defaults to reading input from # stdin, output to stdout and warnings or errors to stderr. def initialize super $stdin, $stdout, $stderr, true end end ## # SilentUI is a UI choice that is absolutely silent. class Gem::SilentUI < Gem::StreamUI ## # The SilentUI has no arguments as it does not use any stream. def initialize io = NullIO.new super io, io, io, false end def close end def download_reporter(args) # :nodoc: SilentDownloadReporter.new(@outs, args) end def progress_reporter(args) # :nodoc: SilentProgressReporter.new(@outs, args) end ## # An absolutely silent IO. class NullIO def puts(args) end def print(args) end def flush end def gets(*args) end def tty? false end end end Back

Edit File : user_interaction.rb | Size : 13.10 KB

# frozen_string_literal: true

#--
# Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others.
# All rights reserved.
# See LICENSE.txt for permissions.
#++

require_relative "deprecate"
require_relative "text"

##
# Module that defines the default UserInteraction.  Any class including this
# module will have access to the +ui+ method that returns the default UI.

module Gem::DefaultUserInteraction
  include Gem::Text

##
  # The default UI is a class variable of the singleton class for this
  # module.

@ui = nil

##
  # Return the default UI.

def self.ui
    @ui ||= Gem::ConsoleUI.new
  end

##
  # Set the default UI.  If the default UI is never explicitly set, a simple
  # console based UserInteraction will be used automatically.

def self.ui=(new_ui)
    @ui = new_ui
  end

##
  # Use +new_ui+ for the duration of +block+.

def self.use_ui(new_ui)
    old_ui = @ui
    @ui = new_ui
    yield
  ensure
    @ui = old_ui
  end

##
  # See DefaultUserInteraction::ui

def ui
    Gem::DefaultUserInteraction.ui
  end

##
  # See DefaultUserInteraction::ui=

def ui=(new_ui)
    Gem::DefaultUserInteraction.ui = new_ui
  end

##
  # See DefaultUserInteraction::use_ui

def use_ui(new_ui, &block)
    Gem::DefaultUserInteraction.use_ui(new_ui, &block)
  end
end

##
# UserInteraction allows RubyGems to interact with the user through standard
# methods that can be replaced with more-specific UI methods for different
# displays.
#
# Since UserInteraction dispatches to a concrete UI class you may need to
# reference other classes for specific behavior such as Gem::ConsoleUI or
# Gem::SilentUI.
#
# Example:
#
#   class X
#     include Gem::UserInteraction
#
#     def get_answer
#       n = ask("What is the meaning of life?")
#     end
#   end

module Gem::UserInteraction
  include Gem::DefaultUserInteraction

##
  # Displays an alert +statement+.  Asks a +question+ if given.

def alert(statement, question = nil)
    ui.alert statement, question
  end

##
  # Displays an error +statement+ to the error output location.  Asks a
  # +question+ if given.

def alert_error(statement, question = nil)
    ui.alert_error statement, question
  end

##
  # Displays a warning +statement+ to the warning output location.  Asks a
  # +question+ if given.

def alert_warning(statement, question = nil)
    ui.alert_warning statement, question
  end

##
  # Asks a +question+ and returns the answer.

def ask(question)
    ui.ask question
  end

##
  # Asks for a password with a +prompt+

def ask_for_password(prompt)
    ui.ask_for_password prompt
  end

##
  # Asks a yes or no +question+.  Returns true for yes, false for no.

def ask_yes_no(question, default = nil)
    ui.ask_yes_no question, default
  end

##
  # Asks the user to answer +question+ with an answer from the given +list+.

def choose_from_list(question, list)
    ui.choose_from_list question, list
  end

##
  # Displays the given +statement+ on the standard output (or equivalent).

def say(statement = "")
    ui.say statement
  end

##
  # Terminates the RubyGems process with the given +exit_code+

def terminate_interaction(exit_code = 0)
    ui.terminate_interaction exit_code
  end

##
  # Calls +say+ with +msg+ or the results of the block if really_verbose
  # is true.

def verbose(msg = nil)
    say(clean_text(msg || yield)) if Gem.configuration.really_verbose
  end
end

##
# Gem::StreamUI implements a simple stream based user interface.

class Gem::StreamUI
  extend Gem::Deprecate

##
  # The input stream

attr_reader :ins

##
  # The output stream

attr_reader :outs

##
  # The error stream

attr_reader :errs

##
  # Creates a new StreamUI wrapping +in_stream+ for user input, +out_stream+
  # for standard output, +err_stream+ for error output.  If +usetty+ is true
  # then special operations (like asking for passwords) will use the TTY
  # commands to disable character echo.

def initialize(in_stream, out_stream, err_stream=$stderr, usetty=true)
    @ins = in_stream
    @outs = out_stream
    @errs = err_stream
    @usetty = usetty
  end

##
  # Returns true if TTY methods should be used on this StreamUI.

def tty?
    @usetty && @ins.tty?
  end

##
  # Prints a formatted backtrace to the errors stream if backtraces are
  # enabled.

def backtrace(exception)
    return unless Gem.configuration.backtrace

@errs.puts "\t#{exception.backtrace.join "\n\t"}"
  end

##
  # Choose from a list of options.  +question+ is a prompt displayed above
  # the list.  +list+ is a list of option strings.  Returns the pair
  # [option_name, option_index].

def choose_from_list(question, list)
    @outs.puts question

list.each_with_index do |item, index|
      @outs.puts " #{index + 1}. #{item}"
    end

@outs.print "> "
    @outs.flush

result = @ins.gets

return nil, nil unless result

result = result.strip.to_i - 1
    return nil, nil unless (0...list.size) === result
    [list[result], result]
  end

##
  # Ask a question.  Returns a true for yes, false for no.  If not connected
  # to a tty, raises an exception if default is nil, otherwise returns
  # default.

def ask_yes_no(question, default=nil)
    unless tty?
      if default.nil?
        raise Gem::OperationNotSupportedError,
              "Not connected to a tty and no default specified"
      else
        return default
      end
    end

default_answer = case default
                     when nil
                       "yn"
                     when true
                       "Yn"
                     else
                       "yN"
    end

result = nil

while result.nil? do
      result = case ask "#{question} [#{default_answer}]"
               when /^y/i then true
               when /^n/i then false
               when /^$/  then default
      end
    end

result
  end

##
  # Ask a question.  Returns an answer if connected to a tty, nil otherwise.

def ask(question)
    return nil unless tty?

@outs.print(question + "  ")
    @outs.flush

result = @ins.gets
    result&.chomp!
    result
  end

##
  # Ask for a password. Does not echo response to terminal.

def ask_for_password(question)
    return nil unless tty?

@outs.print(question, "  ")
    @outs.flush

password = _gets_noecho
    @outs.puts
    password&.chomp!
    password
  end

def require_io_console
    @require_io_console ||= begin
      begin
        require "io/console"
      rescue LoadError
      end
      true
    end
  end

def _gets_noecho
    require_io_console
    @ins.noecho { @ins.gets }
  end

##
  # Display a statement.

def say(statement="")
    @outs.puts statement
  end

##
  # Display an informational alert.  Will ask +question+ if it is not nil.

def alert(statement, question=nil)
    @outs.puts "INFO:  #{statement}"
    ask(question) if question
  end

##
  # Display a warning on stderr.  Will ask +question+ if it is not nil.

def alert_warning(statement, question=nil)
    @errs.puts "WARNING:  #{statement}"
    ask(question) if question
  end

##
  # Display an error message in a location expected to get error messages.
  # Will ask +question+ if it is not nil.

def alert_error(statement, question=nil)
    @errs.puts "ERROR:  #{statement}"
    ask(question) if question
  end

##
  # Terminate the application with exit code +status+, running any exit
  # handlers that might have been defined.

def terminate_interaction(status = 0)
    close
    raise Gem::SystemExitException, status
  end

def close
  end

##
  # Return a progress reporter object chosen from the current verbosity.

def progress_reporter(*args)
    case Gem.configuration.verbose
    when nil, false
      SilentProgressReporter.new(@outs, *args)
    when true
      SimpleProgressReporter.new(@outs, *args)
    else
      VerboseProgressReporter.new(@outs, *args)
    end
  end

##
  # An absolutely silent progress reporter.

class SilentProgressReporter
    ##
    # The count of items is never updated for the silent progress reporter.

attr_reader :count

##
    # Creates a silent progress reporter that ignores all input arguments.

def initialize(out_stream, size, initial_message, terminal_message = nil)
    end

##
    # Does not print +message+ when updated as this object has taken a vow of
    # silence.

def updated(message)
    end

##
    # Does not print anything when complete as this object has taken a vow of
    # silence.

def done
    end
  end

##
  # A basic dotted progress reporter.

class SimpleProgressReporter
    include Gem::DefaultUserInteraction

##
    # The number of progress items counted so far.

attr_reader :count

##
    # Creates a new progress reporter that will write to +out_stream+ for
    # +size+ items.  Shows the given +initial_message+ when progress starts
    # and the +terminal_message+ when it is complete.

def initialize(out_stream, size, initial_message, terminal_message = "complete")
      @out = out_stream
      @total = size
      @count = 0
      @terminal_message = terminal_message

@out.puts initial_message
    end

##
    # Prints out a dot and ignores +message+.

def updated(message)
      @count += 1
      @out.print "."
      @out.flush
    end

##
    # Prints out the terminal message.

def done
      @out.puts "\n#{@terminal_message}"
    end
  end

##
  # A progress reporter that prints out messages about the current progress.

class VerboseProgressReporter
    include Gem::DefaultUserInteraction

##
    # The number of progress items counted so far.

attr_reader :count

def initialize(out_stream, size, initial_message, terminal_message = "complete")
      @out = out_stream
      @total = size
      @count = 0
      @terminal_message = terminal_message

@out.puts initial_message
    end

##
    # Prints out the position relative to the total and the +message+.

def updated(message)
      @count += 1
      @out.puts "#{@count}/#{@total}: #{message}"
    end

##
    # Prints out the terminal message.

def done
      @out.puts @terminal_message
    end
  end

##
  # Return a download reporter object chosen from the current verbosity

def download_reporter(*args)
    if [nil, false].include?(Gem.configuration.verbose) || !@outs.tty?
      SilentDownloadReporter.new(@outs, *args)
    else
      ThreadedDownloadReporter.new(@outs, *args)
    end
  end

##
  # An absolutely silent download reporter.

class SilentDownloadReporter
    ##
    # The silent download reporter ignores all arguments

def initialize(out_stream, *args)
    end

##
    # The silent download reporter does not display +filename+ or care about
    # +filesize+ because it is silent.

def fetch(filename, filesize)
    end

##
    # Nothing can update the silent download reporter.

def update(current)
    end

##
    # The silent download reporter won't tell you when the download is done.
    # Because it is silent.

def done
    end
  end

##
  # A progress reporter that behaves nicely with threaded downloading.

class ThreadedDownloadReporter
    MUTEX = Thread::Mutex.new

##
    # The current file name being displayed

attr_reader :file_name

##
    # Creates a new threaded download reporter that will display on
    # +out_stream+.  The other arguments are ignored.

def initialize(out_stream, *args)
      @file_name = nil
      @out = out_stream
    end

##
    # Tells the download reporter that the +file_name+ is being fetched.
    # The other arguments are ignored.

def fetch(file_name, *args)
      if @file_name.nil?
        @file_name = file_name
        locked_puts "Fetching #{@file_name}"
      end
    end

##
    # Updates the threaded download reporter for the given number of +bytes+.

def update(bytes)
      # Do nothing.
    end

##
    # Indicates the download is complete.

def done
      # Do nothing.
    end

private

def locked_puts(message)
      MUTEX.synchronize do
        @out.puts message
      end
    end
  end
end

##
# Subclass of StreamUI that instantiates the user interaction using $stdin,
# $stdout, and $stderr.

class Gem::ConsoleUI < Gem::StreamUI
  ##
  # The Console UI has no arguments as it defaults to reading input from
  # stdin, output to stdout and warnings or errors to stderr.

def initialize
    super $stdin, $stdout, $stderr, true
  end
end

##
# SilentUI is a UI choice that is absolutely silent.

class Gem::SilentUI < Gem::StreamUI
  ##
  # The SilentUI has no arguments as it does not use any stream.

def initialize
    io = NullIO.new
    super io, io, io, false
  end

def close
  end

def download_reporter(*args) # :nodoc:
    SilentDownloadReporter.new(@outs, *args)
  end

def progress_reporter(*args) # :nodoc:
    SilentProgressReporter.new(@outs, *args)
  end

##
  # An absolutely silent IO.

class NullIO
    def puts(*args)
    end

def print(*args)
    end

def flush
    end

def gets(*args)
    end

def tty?
      false
    end
  end
end

Back