etude_for_ruby 0.1.4 → 0.2.3

data/vendor/bundle/ruby/2.4.0/gems/rspec-core-3.5.4/lib/rspec/core/option_parser.rb

@@ -1,289 +0,0 @@
-# http://www.ruby-doc.org/stdlib/libdoc/optparse/rdoc/classes/OptionParser.html
-require 'optparse'
-
-module RSpec::Core
-  # @private
-  class Parser
-    def self.parse(args, source=nil)
-      new(args).parse(source)
-    end
-
-    attr_reader :original_args
-
-    def initialize(original_args)
-      @original_args = original_args
-    end
-
-    def parse(source=nil)
-      return { :files_or_directories_to_run => [] } if original_args.empty?
-      args = original_args.dup
-
-      options = args.delete('--tty') ? { :tty => true } : {}
-      begin
-        parser(options).parse!(args)
-      rescue OptionParser::InvalidOption => e
-        failure = e.message
-        failure << " (defined in #{source})" if source
-        abort "#{failure}\n\nPlease use --help for a listing of valid options"
-      end
-
-      options[:files_or_directories_to_run] = args
-      options
-    end
-
-  private
-
-    # rubocop:disable MethodLength
-    # rubocop:disable Metrics/AbcSize
-    # rubocop:disable CyclomaticComplexity
-    # rubocop:disable PerceivedComplexity
-    def parser(options)
-      OptionParser.new do |parser|
-        parser.banner = "Usage: rspec [options] [files or directories]\n\n"
-
-        parser.on('-I PATH', 'Specify PATH to add to $LOAD_PATH (may be used more than once).') do |dirs|
-          options[:libs] ||= []
-          options[:libs].concat(dirs.split(File::PATH_SEPARATOR))
-        end
-
-        parser.on('-r', '--require PATH', 'Require a file.') do |path|
-          options[:requires] ||= []
-          options[:requires] << path
-        end
-
-        parser.on('-O', '--options PATH', 'Specify the path to a custom options file.') do |path|
-          options[:custom_options_file] = path
-        end
-
-        parser.on('--order TYPE[:SEED]', 'Run examples by the specified order type.',
-                  '  [defined] examples and groups are run in the order they are defined',
-                  '  [rand]    randomize the order of groups and examples',
-                  '  [random]  alias for rand',
-                  '  [random:SEED] e.g. --order random:123') do |o|
-          options[:order] = o
-        end
-
-        parser.on('--seed SEED', Integer, 'Equivalent of --order rand:SEED.') do |seed|
-          options[:order] = "rand:#{seed}"
-        end
-
-        parser.on('--bisect[=verbose]', 'Repeatedly runs the suite in order to isolate the failures to the ',
-                  '  smallest reproducible case.') do |argument|
-          options[:bisect] = argument || true
-          options[:runner] = RSpec::Core::Invocations::Bisect.new
-        end
-
-        parser.on('--[no-]fail-fast[=COUNT]', 'Abort the run after a certain number of failures (1 by default).') do |argument|
-          if argument == true
-            value = 1
-          elsif argument == false || argument == 0
-            value = false
-          else
-            begin
-              value = Integer(argument)
-            rescue ArgumentError
-              RSpec.warning "Expected an integer value for `--fail-fast`, got: #{argument.inspect}", :call_site => nil
-            end
-          end
-          set_fail_fast(options, value)
-        end
-
-        parser.on('--failure-exit-code CODE', Integer,
-                  'Override the exit code used when there are failing specs.') do |code|
-          options[:failure_exit_code] = code
-        end
-
-        parser.on('-X', '--[no-]drb', 'Run examples via DRb.') do |use_drb|
-          options[:drb] = use_drb
-          options[:runner] = RSpec::Core::Invocations::DRbWithFallback.new if use_drb
-        end
-
-        parser.on('--drb-port PORT', 'Port to connect to the DRb server.') do |o|
-          options[:drb_port] = o.to_i
-        end
-
-        parser.separator("\n  **** Output ****\n\n")
-
-        parser.on('-f', '--format FORMATTER', 'Choose a formatter.',
-                  '  [p]rogress (default - dots)',
-                  '  [d]ocumentation (group and example names)',
-                  '  [h]tml',
-                  '  [j]son',
-                  '  custom formatter class name') do |o|
-          options[:formatters] ||= []
-          options[:formatters] << [o]
-        end
-
-        parser.on('-o', '--out FILE',
-                  'Write output to a file instead of $stdout. This option applies',
-                  '  to the previously specified --format, or the default format',
-                  '  if no format is specified.'
-                 ) do |o|
-          options[:formatters] ||= [['progress']]
-          options[:formatters].last << o
-        end
-
-        parser.on('--deprecation-out FILE', 'Write deprecation warnings to a file instead of $stderr.') do |file|
-          options[:deprecation_stream] = file
-        end
-
-        parser.on('-b', '--backtrace', 'Enable full backtrace.') do |_o|
-          options[:full_backtrace] = true
-        end
-
-        parser.on('-c', '--[no-]color', '--[no-]colour', 'Enable color in the output.') do |o|
-          options[:color] = o
-        end
-
-        parser.on('-p', '--[no-]profile [COUNT]',
-                  'Enable profiling of examples and list the slowest examples (default: 10).') do |argument|
-          options[:profile_examples] = if argument.nil?
-                                         true
-                                       elsif argument == false
-                                         false
-                                       else
-                                         begin
-                                           Integer(argument)
-                                         rescue ArgumentError
-                                           RSpec.warning "Non integer specified as profile count, separate " \
-                                                       "your path from options with -- e.g. " \
-                                                       "`rspec --profile -- #{argument}`",
-                                                         :call_site => nil
-                                           true
-                                         end
-                                       end
-        end
-
-        parser.on('--dry-run', 'Print the formatter output of your suite without',
-                  '  running any examples or hooks') do |_o|
-          options[:dry_run] = true
-        end
-
-        parser.on('-w', '--warnings', 'Enable ruby warnings') do
-          $VERBOSE = true
-        end
-
-        parser.separator <<-FILTERING
-
-  **** Filtering/tags ****
-
-    In addition to the following options for selecting specific files, groups, or
-    examples, you can select individual examples by appending the line number(s) to
-    the filename:
-
-      rspec path/to/a_spec.rb:37:87
-
-    You can also pass example ids enclosed in square brackets:
-
-      rspec path/to/a_spec.rb[1:5,1:6] # run the 5th and 6th examples/groups defined in the 1st group
-
-FILTERING
-
-        parser.on('--only-failures', "Filter to just the examples that failed the last time they ran.") do
-          configure_only_failures(options)
-        end
-
-        parser.on("--next-failure", "Apply `--only-failures` and abort after one failure.",
-                  "  (Equivalent to `--only-failures --fail-fast --order defined`)") do
-          configure_only_failures(options)
-          set_fail_fast(options, 1)
-          options[:order] ||= 'defined'
-        end
-
-        parser.on('-P', '--pattern PATTERN', 'Load files matching pattern (default: "spec/**/*_spec.rb").') do |o|
-          if options[:pattern]
-            options[:pattern] += ',' + o
-          else
-            options[:pattern] = o
-          end
-        end
-
-        parser.on('--exclude-pattern PATTERN',
-                  'Load files except those matching pattern. Opposite effect of --pattern.') do |o|
-          options[:exclude_pattern] = o
-        end
-
-        parser.on('-e', '--example STRING', "Run examples whose full nested names include STRING (may be",
-                  "  used more than once)") do |o|
-          (options[:full_description] ||= []) << Regexp.compile(Regexp.escape(o))
-        end
-
-        parser.on('-t', '--tag TAG[:VALUE]',
-                  'Run examples with the specified tag, or exclude examples',
-                  'by adding ~ before the tag.',
-                  '  - e.g. ~slow',
-                  '  - TAG is always converted to a symbol') do |tag|
-          filter_type = tag =~ /^~/ ? :exclusion_filter : :inclusion_filter
-
-          name, value = tag.gsub(/^(~@|~|@)/, '').split(':', 2)
-          name = name.to_sym
-
-          parsed_value = case value
-                         when  nil        then true # The default value for tags is true
-                         when 'true'      then true
-                         when 'false'     then false
-                         when 'nil'       then nil
-                         when /^:/        then value[1..-1].to_sym
-                         when /^\d+$/     then Integer(value)
-                         when /^\d+.\d+$/ then Float(value)
-                         else
-                           value
-                         end
-
-          add_tag_filter(options, filter_type, name, parsed_value)
-        end
-
-        parser.on('--default-path PATH', 'Set the default path where RSpec looks for examples (can',
-                  '  be a path to a file or a directory).') do |path|
-          options[:default_path] = path
-        end
-
-        parser.separator("\n  **** Utility ****\n\n")
-
-        parser.on('--init', 'Initialize your project with RSpec.') do |_cmd|
-          options[:runner] = RSpec::Core::Invocations::InitializeProject.new
-        end
-
-        parser.on('-v', '--version', 'Display the version.') do
-          options[:runner] = RSpec::Core::Invocations::PrintVersion.new
-        end
-
-        # These options would otherwise be confusing to users, so we forcibly
-        # prevent them from executing.
-        #
-        #   * --I is too similar to -I.
-        #   * -d was a shorthand for --debugger, which is removed, but now would
-        #     trigger --default-path.
-        invalid_options = %w[-d --I]
-
-        parser.on_tail('-h', '--help', "You're looking at it.") do
-          options[:runner] = RSpec::Core::Invocations::PrintHelp.new(parser, invalid_options)
-        end
-
-        # This prevents usage of the invalid_options.
-        invalid_options.each do |option|
-          parser.on(option) do
-            raise OptionParser::InvalidOption.new
-          end
-        end
-      end
-    end
-    # rubocop:enable Metrics/AbcSize
-    # rubocop:enable MethodLength
-    # rubocop:enable CyclomaticComplexity
-    # rubocop:enable PerceivedComplexity
-
-    def add_tag_filter(options, filter_type, tag_name, value=true)
-      (options[filter_type] ||= {})[tag_name] = value
-    end
-
-    def set_fail_fast(options, value)
-      options[:fail_fast] = value
-    end
-
-    def configure_only_failures(options)
-      options[:only_failures] = true
-      add_tag_filter(options, :inclusion_filter, :last_run_status, 'failed')
-    end
-  end
-end

data/vendor/bundle/ruby/2.4.0/gems/rspec-core-3.5.4/lib/rspec/core/ordering.rb

@@ -1,158 +0,0 @@
-module RSpec
-  module Core
-    # @private
-    module Ordering
-      # @private
-      # The default global ordering (defined order).
-      class Identity
-        def order(items)
-          items
-        end
-      end
-
-      # @private
-      # Orders items randomly.
-      class Random
-        def initialize(configuration)
-          @configuration = configuration
-          @used = false
-        end
-
-        def used?
-          @used
-        end
-
-        def order(items)
-          @used = true
-
-          seed = @configuration.seed.to_s
-          items.sort_by { |item| jenkins_hash_digest(seed + item.id) }
-        end
-
-      private
-
-        # http://en.wikipedia.org/wiki/Jenkins_hash_function
-        # Jenkins provides a good distribution and is simpler than MD5.
-        # It's a bit slower than MD5 (primarily because `Digest::MD5` is
-        # implemented in C) but has the advantage of not requiring us
-        # to load another part of stdlib, which we try to minimize.
-        def jenkins_hash_digest(string)
-          hash = 0
-
-          string.each_byte do |byte|
-            hash += byte
-            hash &= MAX_32_BIT
-            hash += ((hash << 10) & MAX_32_BIT)
-            hash &= MAX_32_BIT
-            hash ^= hash >> 6
-          end
-
-          hash += ((hash << 3) & MAX_32_BIT)
-          hash &= MAX_32_BIT
-          hash ^= hash >> 11
-          hash += ((hash << 15) & MAX_32_BIT)
-          hash &= MAX_32_BIT
-          hash
-        end
-
-        MAX_32_BIT = 4_294_967_295
-      end
-
-      # @private
-      # Orders items based on a custom block.
-      class Custom
-        def initialize(callable)
-          @callable = callable
-        end
-
-        def order(list)
-          @callable.call(list)
-        end
-      end
-
-      # @private
-      # Stores the different ordering strategies.
-      class Registry
-        def initialize(configuration)
-          @configuration = configuration
-          @strategies    = {}
-
-          register(:random,  Random.new(configuration))
-
-          identity = Identity.new
-          register(:defined, identity)
-
-          # The default global ordering is --defined.
-          register(:global, identity)
-        end
-
-        def fetch(name, &fallback)
-          @strategies.fetch(name, &fallback)
-        end
-
-        def register(sym, strategy)
-          @strategies[sym] = strategy
-        end
-
-        def used_random_seed?
-          @strategies[:random].used?
-        end
-      end
-
-      # @private
-      # Manages ordering configuration.
-      #
-      # @note This is not intended to be used externally. Use
-      #       the APIs provided by `RSpec::Core::Configuration` instead.
-      class ConfigurationManager
-        attr_reader :seed, :ordering_registry
-
-        def initialize
-          @ordering_registry = Registry.new(self)
-          @seed = rand(0xFFFF)
-          @seed_forced = false
-          @order_forced = false
-        end
-
-        def seed_used?
-          ordering_registry.used_random_seed?
-        end
-
-        def seed=(seed)
-          return if @seed_forced
-          register_ordering(:global, ordering_registry.fetch(:random))
-          @seed = seed.to_i
-        end
-
-        def order=(type)
-          order, seed = type.to_s.split(':')
-          @seed = seed.to_i if seed
-
-          ordering_name = if order.include?('rand')
-                            :random
-                          elsif order == 'defined'
-                            :defined
-                          end
-
-          register_ordering(:global, ordering_registry.fetch(ordering_name)) if ordering_name
-        end
-
-        def force(hash)
-          if hash.key?(:seed)
-            self.seed = hash[:seed]
-            @seed_forced  = true
-            @order_forced = true
-          elsif hash.key?(:order)
-            self.order = hash[:order]
-            @order_forced = true
-          end
-        end
-
-        def register_ordering(name, strategy=Custom.new(Proc.new { |l| yield l }))
-          return if @order_forced && name == :global
-          ordering_registry.register(name, strategy)
-        end
-      end
-    end
-  end
-end

data/vendor/bundle/ruby/2.4.0/gems/rspec-core-3.5.4/lib/rspec/core/pending.rb

@@ -1,165 +0,0 @@
-module RSpec
-  module Core
-    # Provides methods to mark examples as pending. These methods are available
-    # to be called from within any example or hook.
-    module Pending
-      # Raised in the middle of an example to indicate that it should be marked
-      # as skipped.
-      class SkipDeclaredInExample < StandardError
-        attr_reader :argument
-
-        def initialize(argument)
-          @argument = argument
-        end
-      end
-
-      # If Test::Unit is loaded, we'll use its error as baseclass, so that
-      # Test::Unit will report unmet RSpec expectations as failures rather than
-      # errors.
-      begin
-        class PendingExampleFixedError < Test::Unit::AssertionFailedError; end
-      rescue
-        class PendingExampleFixedError < StandardError; end
-      end
-
-      # @private
-      NO_REASON_GIVEN = 'No reason given'
-
-      # @private
-      NOT_YET_IMPLEMENTED = 'Not yet implemented'
-
-      # @overload pending()
-      # @overload pending(message)
-      #
-      # Marks an example as pending. The rest of the example will still be
-      # executed, and if it passes the example will fail to indicate that the
-      # pending can be removed.
-      #
-      # @param message [String] optional message to add to the summary report.
-      #
-      # @example
-      #     describe "an example" do
-      #       # reported as "Pending: no reason given"
-      #       it "is pending with no message" do
-      #         pending
-      #         raise "broken"
-      #       end
-      #
-      #       # reported as "Pending: something else getting finished"
-      #       it "is pending with a custom message" do
-      #         pending("something else getting finished")
-      #         raise "broken"
-      #       end
-      #     end
-      #
-      # @note `before(:example)` hooks are eval'd when you use the `pending`
-      #   method within an example. If you want to declare an example `pending`
-      #   and bypass the `before` hooks as well, you can pass `:pending => true`
-      #   to the `it` method:
-      #
-      #       it "does something", :pending => true do
-      #         # ...
-      #       end
-      #
-      #   or pass `:pending => "something else getting finished"` to add a
-      #   message to the summary report:
-      #
-      #       it "does something", :pending => "something else getting finished" do
-      #         # ...
-      #       end
-      def pending(message=nil)
-        current_example = RSpec.current_example
-
-        if block_given?
-          raise ArgumentError, <<-EOS.gsub(/^\s+\|/, '')
-            |The semantics of `RSpec::Core::Pending#pending` have changed in
-            |RSpec 3. In RSpec 2.x, it caused the example to be skipped. In
-            |RSpec 3, the rest of the example is still run but is expected to
-            |fail, and will be marked as a failure (rather than as pending) if
-            |the example passes.
-            |
-            |Passing a block within an example is now deprecated. Marking the
-            |example as pending provides the same behavior in RSpec 3 which was
-            |provided only by the block in RSpec 2.x.
-            |
-            |Move the code in the block provided to `pending` into the rest of
-            |the example body.
-            |
-            |Called from #{CallerFilter.first_non_rspec_line}.
-            |
-          EOS
-        elsif current_example
-          Pending.mark_pending! current_example, message
-        else
-          raise "`pending` may not be used outside of examples, such as in " \
-                "before(:context). Maybe you want `skip`?"
-        end
-      end
-
-      # @overload skip()
-      # @overload skip(message)
-      #
-      # Marks an example as pending and skips execution.
-      #
-      # @param message [String] optional message to add to the summary report.
-      #
-      # @example
-      #     describe "an example" do
-      #       # reported as "Pending: no reason given"
-      #       it "is skipped with no message" do
-      #         skip
-      #       end
-      #
-      #       # reported as "Pending: something else getting finished"
-      #       it "is skipped with a custom message" do
-      #         skip "something else getting finished"
-      #       end
-      #     end
-      def skip(message=nil)
-        current_example = RSpec.current_example
-
-        Pending.mark_skipped!(current_example, message) if current_example
-
-        raise SkipDeclaredInExample.new(message)
-      end
-
-      # @private
-      #
-      # Mark example as skipped.
-      #
-      # @param example [RSpec::Core::Example] the example to mark as skipped
-      # @param message_or_bool [Boolean, String] the message to use, or true
-      def self.mark_skipped!(example, message_or_bool)
-        Pending.mark_pending! example, message_or_bool
-        example.metadata[:skip] = true
-      end
-
-      # @private
-      #
-      # Mark example as pending.
-      #
-      # @param example [RSpec::Core::Example] the example to mark as pending
-      # @param message_or_bool [Boolean, String] the message to use, or true
-      def self.mark_pending!(example, message_or_bool)
-        message = if !message_or_bool || !(String === message_or_bool)
-                    NO_REASON_GIVEN
-                  else
-                    message_or_bool
-                  end
-
-        example.metadata[:pending] = true
-        example.execution_result.pending_message = message
-        example.execution_result.pending_fixed = false
-      end
-
-      # @private
-      #
-      # Mark example as fixed.
-      #
-      # @param example [RSpec::Core::Example] the example to mark as fixed
-      def self.mark_fixed!(example)
-        example.execution_result.pending_fixed = true
-      end
-    end
-  end
-end