brakeman 4.5.0 → 4.5.1

data/lib/brakeman/version.rb

@@ -1,3 +1,3 @@
 module Brakeman
-  Version = "4.5.0"
+  Version = "4.5.1"
 end

data/lib/brakeman/warning.rb

@@ -9,7 +9,7 @@ class Brakeman::Warning
     :line, :method, :model, :template, :user_input, :user_input_type,
     :warning_code, :warning_set, :warning_type
 
-  attr_accessor :code, :context, :file, :message, :relative_path
+  attr_accessor :code, :context, :file, :message
 
   TEXT_CONFIDENCE = {
     0 => "High",
@@ -34,11 +34,11 @@ class Brakeman::Warning
     :file => :@file,
     :gem_info => :@gem_info,
     :line => :@line,
+    :link => :@link,
     :link_path => :@link_path,
     :message => :@message,
     :method => :@method,
     :model => :@model,
-    :relative_path => :@relative_path,
     :template => :@template,
     :user_input => :@user_input,
     :warning_set => :@warning_set,
@@ -100,9 +100,11 @@ class Brakeman::Warning
     unless @warning_set
       if self.model
         @warning_set = :model
+        @file ||= self.model.file
       elsif self.template
         @warning_set = :template
         @called_from = self.template.render_path
+        @file ||= self.template.file
       elsif self.controller
         @warning_set = :controller
       else
@@ -112,6 +114,8 @@ class Brakeman::Warning
 
     if options[:warning_code]
       @warning_code = Brakeman::WarningCodes.code options[:warning_code]
+    else
+      @warning_code = nil
     end
 
     Brakeman.debug("Warning created without warning code: #{options[:warning_code]}") unless @warning_code
@@ -221,7 +225,7 @@ class Brakeman::Warning
     when :template
       @row["Template"] = self.view_name.to_s
     when :model
-      @row["Model"] = self.model.to_s
+      @row["Model"] = self.model.name.to_s
     when :controller
       @row["Controller"] = self.controller.to_s
     when :warning
@@ -235,7 +239,7 @@ class Brakeman::Warning
   def to_s
    output =  "(#{TEXT_CONFIDENCE[self.confidence]}) #{self.warning_type} - #{self.message}"
    output << " near line #{self.line}" if self.line
-   output << " in #{self.file}" if self.file
+   output << " in #{self.file.relative}" if self.file
    output << ": #{self.format_code}" if self.code
 
    output
@@ -247,37 +251,43 @@ class Brakeman::Warning
     warning_code_string = sprintf("%03d", @warning_code)
     code_string = @code.inspect
 
-    Digest::SHA2.new(256).update("#{warning_code_string}#{code_string}#{location_string}#{@relative_path}#{self.confidence}").to_s
+    Digest::SHA2.new(256).update("#{warning_code_string}#{code_string}#{location_string}#{self.file.relative}#{self.confidence}").to_s
   end
 
   def location include_renderer = true
     case @warning_set
     when :template
-      location = { :type => :template, :template => self.view_name(include_renderer) }
+      { :type => :template, :template => self.view_name(include_renderer) }
     when :model
-      location = { :type => :model, :model => self.model }
+      { :type => :model, :model => self.model.name }
     when :controller
-      location = { :type => :controller, :controller => self.controller }
+      { :type => :controller, :controller => self.controller }
     when :warning
       if self.class
-        location = { :type => :method, :class => self.class, :method => self.method }
+        { :type => :method, :class => self.class, :method => self.method }
       else
-        location = nil
+        nil
       end
     end
   end
 
-  def to_hash
+  def to_hash absolute_paths: true
+    if self.called_from and not absolute_paths
+      render_path = self.called_from.with_relative_paths
+    else
+      render_path = self.called_from
+    end
+
     { :warning_type => self.warning_type,
       :warning_code => @warning_code,
       :fingerprint => self.fingerprint,
       :check_name => self.check.gsub(/^Brakeman::Check/, ''),
       :message => self.message.to_s,
-      :file => self.file,
+      :file => (absolute_paths ? self.file.absolute : self.file.relative),
       :line => self.line,
       :link => self.link,
       :code => (@code && self.format_code(false)),
-      :render_path => self.called_from,
+      :render_path => render_path,
       :location => self.location(false),
       :user_input => (@user_input && self.format_user_input(false)),
       :confidence => TEXT_CONFIDENCE[self.confidence]

data/lib/brakeman/warning_codes.rb

@@ -110,6 +110,7 @@ module Brakeman::WarningCodes
     :CVE_2018_8048 => 106,
     :CVE_2018_3741 => 107,
     :CVE_2018_3760 => 108,
+    :force_ssl_disabled => 109,
   }
 
   def self.code name

data/lib/ruby_parser/bm_sexp_processor.rb

@@ -45,6 +45,7 @@ class Brakeman::SexpProcessor
     @expected            = Sexp
     @processors = self.class.processors
     @context    = []
+    @current_class = @current_module = @current_method = @visibility = nil
 
     if @processors.empty?
       public_methods.each do |name|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brakeman
 version: !ruby/object:Gem::Version
-  version: 4.5.0
+  version: 4.5.1
 platform: ruby
 authors:
 - Justin Collins
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-16 00:00:00.000000000 Z
+date: 2019-05-11 00:00:00.000000000 Z
 dependencies: []
 description: Brakeman detects security vulnerabilities in Ruby on Rails applications
   via static analysis.
@@ -83,60 +83,75 @@ files:
 - bundle/ruby/2.5.0/gems/haml-4.0.7/lib/haml/template/plugin.rb
 - bundle/ruby/2.5.0/gems/haml-4.0.7/lib/haml/util.rb
 - bundle/ruby/2.5.0/gems/haml-4.0.7/lib/haml/version.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/AUTHORS
-- bundle/ruby/2.5.0/gems/highline-1.7.10/COPYING
-- bundle/ruby/2.5.0/gems/highline-1.7.10/Changelog.md
-- bundle/ruby/2.5.0/gems/highline-1.7.10/Gemfile
-- bundle/ruby/2.5.0/gems/highline-1.7.10/INSTALL
-- bundle/ruby/2.5.0/gems/highline-1.7.10/LICENSE
-- bundle/ruby/2.5.0/gems/highline-1.7.10/README.rdoc
-- bundle/ruby/2.5.0/gems/highline-1.7.10/TODO
-- bundle/ruby/2.5.0/gems/highline-1.7.10/highline.gemspec
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/color_scheme.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/compatibility.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/import.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/menu.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/question.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/simulate.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/string_extensions.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/style.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/system_extensions.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/lib/highline/version.rb
-- bundle/ruby/2.5.0/gems/highline-1.7.10/setup.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/AUTHORS
+- bundle/ruby/2.5.0/gems/highline-2.0.2/COPYING
+- bundle/ruby/2.5.0/gems/highline-2.0.2/Changelog.md
+- bundle/ruby/2.5.0/gems/highline-2.0.2/Gemfile
+- bundle/ruby/2.5.0/gems/highline-2.0.2/LICENSE
+- bundle/ruby/2.5.0/gems/highline-2.0.2/README.md
+- bundle/ruby/2.5.0/gems/highline-2.0.2/TODO
+- bundle/ruby/2.5.0/gems/highline-2.0.2/appveyor.yml
+- bundle/ruby/2.5.0/gems/highline-2.0.2/highline.gemspec
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/builtin_styles.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/color_scheme.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/compatibility.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/custom_errors.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/import.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/io_console_compatible.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/list.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/list_renderer.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/menu.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/menu/item.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/paginator.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/question.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/question/answer_converter.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/question_asker.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/simulate.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/statement.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/string.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/string_extensions.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/style.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/template_renderer.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/terminal.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/terminal/io_console.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/terminal/ncurses.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/terminal/unix_stty.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/version.rb
+- bundle/ruby/2.5.0/gems/highline-2.0.2/lib/highline/wrapper.rb
 - bundle/ruby/2.5.0/gems/ruby2ruby-2.4.2/History.rdoc
 - bundle/ruby/2.5.0/gems/ruby2ruby-2.4.2/Manifest.txt
 - bundle/ruby/2.5.0/gems/ruby2ruby-2.4.2/README.rdoc
 - bundle/ruby/2.5.0/gems/ruby2ruby-2.4.2/lib/ruby2ruby.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/History.rdoc
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/Manifest.txt
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/README.rdoc
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/compare/normalize.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/debugging.md
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/rp_extensions.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/rp_stringscanner.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby20_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby20_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby21_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby21_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby22_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby22_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby23_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby23_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby24_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby24_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby25_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby25_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby26_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby26_parser.y
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby_lexer.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby_lexer.rex
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby_lexer.rex.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby_parser.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby_parser.yy
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/lib/ruby_parser_extras.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/tools/munge.rb
-- bundle/ruby/2.5.0/gems/ruby_parser-3.13.0/tools/ripper.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/History.rdoc
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/Manifest.txt
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/README.rdoc
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/compare/normalize.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/debugging.md
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/rp_extensions.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/rp_stringscanner.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby20_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby20_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby21_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby21_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby22_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby22_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby23_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby23_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby24_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby24_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby25_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby25_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby26_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby26_parser.y
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby_lexer.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby_lexer.rex
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby_lexer.rex.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby_parser.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby_parser.yy
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/lib/ruby_parser_extras.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/tools/munge.rb
+- bundle/ruby/2.5.0/gems/ruby_parser-3.13.1/tools/ripper.rb
 - bundle/ruby/2.5.0/gems/ruby_parser-legacy-1.0.0/History.rdoc
 - bundle/ruby/2.5.0/gems/ruby_parser-legacy-1.0.0/Manifest.txt
 - bundle/ruby/2.5.0/gems/ruby_parser-legacy-1.0.0/README.rdoc
@@ -337,15 +352,15 @@ files:
 - bundle/ruby/2.5.0/gems/tilt-2.0.9/lib/tilt/wikicloth.rb
 - bundle/ruby/2.5.0/gems/tilt-2.0.9/lib/tilt/yajl.rb
 - bundle/ruby/2.5.0/gems/tilt-2.0.9/tilt.gemspec
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/CHANGELOG.md
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/MIT-LICENSE.txt
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/README.md
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/data/display_width.marshal.gz
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/lib/unicode/display_width.rb
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/lib/unicode/display_width/constants.rb
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/lib/unicode/display_width/index.rb
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/lib/unicode/display_width/no_string_ext.rb
-- bundle/ruby/2.5.0/gems/unicode-display_width-1.5.0/lib/unicode/display_width/string_ext.rb
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/CHANGELOG.md
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/MIT-LICENSE.txt
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/README.md
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/data/display_width.marshal.gz
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/lib/unicode/display_width.rb
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/lib/unicode/display_width/constants.rb
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/lib/unicode/display_width/index.rb
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/lib/unicode/display_width/no_string_ext.rb
+- bundle/ruby/2.5.0/gems/unicode-display_width-1.6.0/lib/unicode/display_width/string_ext.rb
 - lib/brakeman.rb
 - lib/brakeman/app_tree.rb
 - lib/brakeman/call_index.rb
@@ -368,6 +383,7 @@ files:
 - lib/brakeman/checks/check_file_access.rb
 - lib/brakeman/checks/check_file_disclosure.rb
 - lib/brakeman/checks/check_filter_skipping.rb
+- lib/brakeman/checks/check_force_ssl.rb
 - lib/brakeman/checks/check_forgery_setting.rb
 - lib/brakeman/checks/check_header_dos.rb
 - lib/brakeman/checks/check_i18n_xss.rb
@@ -425,6 +441,7 @@ files:
 - lib/brakeman/commandline.rb
 - lib/brakeman/differ.rb
 - lib/brakeman/file_parser.rb
+- lib/brakeman/file_path.rb
 - lib/brakeman/format/style.css
 - lib/brakeman/messages.rb
 - lib/brakeman/options.rb

data/bundle/ruby/2.5.0/gems/highline-1.7.10/Gemfile

@@ -1,11 +0,0 @@
-source "https://rubygems.org"
-
-gemspec
-
-gem "rake", :require => false
-gem "rdoc", :require => false
-
-group(:development, :tests) do
-  gem "code_statistics", :require => false
-  gem "test-unit", :require => false
-end

data/bundle/ruby/2.5.0/gems/highline-1.7.10/INSTALL

@@ -1,59 +0,0 @@
-= Installing HighLine
-
-RubyGems is the preferred easy install method for HighLine.  However, you can
-install HighLine manually as described below.
-
-== Requirements
-
-HighLine from version >= 1.7.0 requires ruby >= 1.9.3
-
-== Installing the Gem
-
-HighLine is intended to be installed via the
-RubyGems[http://rubyforge.org/projects/rubygems/] system.  To get the latest
-version, simply enter the following into your command prompt:
-
-	$ sudo gem install highline
-
-You must have RubyGems[http://rubyforge.org/projects/rubygems/] installed for
-the above to work.
-
-If you want to build the gem locally, make sure you have
-Rake[http://rubyforge.org/projects/rake/] installed then run the following
-command:
-
-  $ rake package
-
-== Installing Manually
-
-Download the latest version of HighLine from the
-{RubyForge project page}[http://rubyforge.org/frs/?group_id=683].  Navigate to
-the root project directory and enter:
-
-	$ sudo ruby setup.rb
-
-== Installing HighLine on JRuby
-
-If you are using HighLine on JRuby, many features will not work properly
-without a working ncurses installation.  First, ensure that you have
-ncurses installed and then install the ffi-ncurses gem.
-
-If ffi-ncurses fails to find your ncurses library, you may need to set the
-RUBY_FFI_NCURSES envirionment variable, i.e:
-
-  RUBY_FFI_NCURSES_LIB=ncursesw ruby examples/hello.rb
-
-For details, see the ffi-ncurses documentation at:
-http://github.com/seanohalpin/ffi-ncurses
-
-== Using termios
-
-While not a requirement, HighLine will take advantage of the termios library if
-installed (on Unix).  This slightly improves HighLine's character reading
-capabilities and thus is recommended for all Unix users.
-
-If using the HighLine gem, you should be able to add termios as easily as:
-
-	$ sudo gem install termios
-
-For manual installs, consult the termios documentation.

data/bundle/ruby/2.5.0/gems/highline-1.7.10/README.rdoc

@@ -1,74 +0,0 @@
-= HighLine
-
-by James Edward Gray II
-
-{<img src="https://travis-ci.org/JEG2/highline.svg" alt="Build Status" />}[https://travis-ci.org/JEG2/highline]
-{<img src="https://img.shields.io/gem/v/highline.svg?style=flat" />}[http://rubygems.org/gems/highline]
-
-== Description
-
-Welcome to HighLine.
-
-HighLine was designed to ease the tedious tasks of doing console input and
-output with low-level methods like gets() and puts().  HighLine provides a
-robust system for requesting data from a user, without needing to code all the
-error checking and validation rules and without needing to convert the typed
-Strings into what your program really needs.  Just tell HighLine what you're
-after, and let it do all the work.
-
-== Documentation
-
-See HighLine and HighLine::Question for documentation.  
-
-Start hacking in your code with HighLine with:
-
-  require 'highline/import'
-
-== Examples
-
-Basic usage:
-
-  ask("Company?  ") { |q| q.default = "none" }
-
-Validation:
-
-  ask("Age?  ", Integer) { |q| q.in = 0..105 }
-  ask("Name?  (last, first)  ") { |q| q.validate = /\A\w+, ?\w+\Z/ }
-
-Type conversion for answers:
-
-  ask("Birthday?  ", Date)
-  ask("Interests?  (comma sep list)  ", lambda { |str| str.split(/,\s*/) })
-
-Reading passwords:
-
-  ask("Enter your password:  ") { |q| q.echo = false }
-  ask("Enter your password:  ") { |q| q.echo = "x" }
-
-ERb based output (with HighLine's ANSI color tools):
-
-  say("This should be <%= color('bold', BOLD) %>!")
-
-Menus:
-
-  choose do |menu|
-    menu.prompt = "Please choose your favorite programming language?  "
-
-    menu.choice(:ruby) { say("Good choice!") }
-    menu.choices(:python, :perl) { say("Not from around here, are you?") }
-  end
-
-For more examples see the examples/ directory of this project.
-
-== Requirements
-
-HighLine from version >= 1.7.0 requires ruby >= 1.9.3
-
-== Installing
-
-See the INSTALL file for instructions.
-
-== Questions and/or Comments
-
-Feel free to email {James Edward Gray II}[mailto:james@grayproductions.net] or
-{Gregory Brown}[mailto:gregory.t.brown@gmail.com] with any questions.