RubyGems - backports - Versions diffs - 3.16.0 → 3.16.1 - Mend

backports 3.16.0 → 3.16.1

Files changed (404) hide show

data/README.rdoc DELETED Viewed

@@ -1,445 +0,0 @@
-= Backports Library {<img src="https://travis-ci.org/marcandre/backports.svg?branch=master">}[https://travis-ci.org/marcandre/backports] {<img src="https://badge.fury.io/rb/backports.svg" alt="Gem Version" />}[http://badge.fury.io/rb/backports]
-Yearning to use some of the new cool features in Ruby 2.7 while using 2.3.x? Have some legacy code in Ruby 1.8 but can't live without `flat_map`?
-This gem is for you!
-The goal of 'backports' is to make it easier to write ruby code that runs across different versions of Ruby.
-Note: {Next major version (X-mas 2020)}[https://github.com/marcandre/backports/issues/139] will drop support for Ruby < 2.2.
-== Loading backports
-=== Explicitly (recommended)
-For example, if you want to use transform_values and transform_keys, even in Ruby implementations that don't include it:
-  require 'backports/2.4.0/hash/transform_values'
-  require 'backports/2.5.0/hash/transform_keys'
-This will enable Hash#transform_values and Hash#transform_keys, using the native versions if available or otherwise provide a pure Ruby version.
-=== By Module
-To bring all the backports for a given Class/Module, you can specify only that Class:
-    require 'backports/2.3.0/hash'
-This will make sure that Hash responds to dig, fetch_values, <, <=, >, >= and to_proc
-=== Up to a specific Ruby version
-You can load all backports up to a specific version. For example, to bring any version of Ruby mostly up to Ruby 2.4.0's standards:
-  require 'backports/2.4.0'
-This will bring in all the features of 1.8.7 and many features of Ruby 1.9.x all the way up to Ruby 2.4.0 (for all versions of Ruby)!
-While it is not recommended, you may `require 'backports/latest'` as a shortcut to the latest Ruby version supported. This is equivalent to the deprecated `require 'backports'`.
-+Note+: Although I am a Ruby committer, this gem is a personal project and is not endorsed by ruby-core.
-== What's inside
-Goals for backported features:
-1. Won't break older code
-2. Pure Ruby (no C extensions)
-3. Pass ruby/spec[https://github.com/ruby/spec]
-Let's be a bit more precise about the "breaking code" business. It is of course entirely possible that code will break. In particular, you may be distinguishing parameters with duck typing, but a builtin class may, in the future, be responding to a particular call. Here's {an exemple from Rails}(https://github.com/rails/rails/blob/a4b55827721a5967299f3c1531afb3d6d81e4ac0/activerecord/lib/active_record/associations/association.rb#L155-L159) that is relying on the fact that Proc and Method respond to :to_proc and Hash isn't. That is, until Ruby 2.3... This old version of Rails therefore won't work on Ruby 2.3, or on older Rubies with that the `2.3.0/hash/to_proc` loaded...
-For Ruby < 2.0, there are some real incompatibilities. For example, <tt>Module::instance_methods</tt> which returns strings in 1.8 and symbols in 1.9. No change can be made without the risk of breaking existing code. Such incompatibilities are left unchanged, although you can require some of these changes in addition (see below).
-== Installation & compatibility
-+backports+ can be installed with:
-  gem install backports
-To use:
-  require 'rubygems'
-  # For only specific backports:
-  require 'backports/1.9.1/kernel/require_relative'
-  require 'backports/2.0.0/enumerable/lazy'
-  # For all backports up to a given version
-  require 'backports/1.9.2' # All backports for Ruby 1.9.2 and below
-Note: about a dozen of backports have a dependency that will be also loaded. For example, the backport of Enumerable#flat_map uses flatten(1), so if required from Ruby 1.8.6 (where Array#flatten does not accept an argument), the backport for Ruby's 1.8.7 flatten with an argument will also be loaded.
-With bundler, add to your Gemfile:
-  gem 'backports', :require => false
-Run <tt>bundle install</tt> and require the desired backports.
-Compatible with Ruby itself, JRuby and Rubinius.
-= Complete List of backports
-== Ruby 2.7 backports
-* Array
-  * +intersection+
-* Comparable
-  * +clamp+ (with range)
-* Complex
-  * +<=>+
-* Enumerable
-  * +filter_map+
-  * +tally+
-* Enumerator
-  * +produce+ (class method)
-* Time
-  * +floor+, +ceil+
-== Ruby 2.6 backports
-* Array
-  * +difference+, +union+
-  * +to_h+ (with block)
-* Enumerable
-  * +chain+
-  * +to_h+ (with block)
-* Enumerator::Chain (use Enumerable#chain)
-* Hash
-  * +merge+, +merge!+/+update+ (with multiple arguments)
-  * +to_h+ (with block)
-* Kernel
-  * +then+
-* Method
-  * +<<+, +>>+
-* Proc
-  * +<<+, +>>+
-== Ruby 2.5 backports
-* Array
-  * +append+, +prepend+
-* Dir
-  * +children+, +each_child+
-* Enumerable
-  * +any?+, +all?+, +none?+, +one?+ (with pattern argument)
-* Hash
-  * +slice+
-  * +transform_keys+
-* Integer
-  * +sqrt+
-  * +allbits?+, +anybits?+ and +nobits?+
-* Kernel
-  * +yield_self+
-* Module
-  * +attr+, +attr_accessor+, +attr_reader+, +attr_writer+ (now public)
-  * +define_method+, +alias_method+, +undef_method+, +remove_method+ (now public)
-* String
-  * +delete_prefix+, +delete_prefix!+
-  * +delete_suffix+, +delete_suffix!+
-  * +undump+
-* Struct
-  * +new+ (with <code>keyword_init: true</code>)
-== Ruby 2.4 backports
-* Comparable
-  * +clamp+
-* Enumerable
-  * +sum+
-  * +uniq+
-* Hash
-  * +compact+, +compact!+
-  * +transform_values+, +transform_values!+
-* Regexp
-  * +match?+
-* String
-  * +match?+
-* FalseClass, Fixnum, Float, NilClass, TrueClass
-  * +dup+
-== Ruby 2.3 backports
-* Array
-  * +bsearch_index+
-  * +dig+
-* Enumerable
-  * +chunk_while+
-  * +grep_v+
-* Hash
-  * +dig+
-  * +fetch_values+
-  * +to_proc+
-  * <=, <, >=, >
-* Numeric
-  * +negative?+
-  * +positive?+
-* String
-  * unary + and -
-* Struct
-  * +dig+
-== Ruby 2.2 backports
-* Enumerable
-  * +slice_after+
-  * +slice_when+
-* Float
-  * +prev_float+
-  * +next_float+
-* Kernel
-  * +itself+
-* Method
-  * +curry+
-  * +super_method+
-* String
-  * +unicode_normalize+
-  * +unicode_normalize!+
-  * +unicode_normalize?+
-== Ruby 2.1 backports
-* Array
-  * +to_h+
-* Bignum
-  * +bit_length+
-* Enumerable
-  * +to_h+
-* Fixnum
-  * +bit_length+
-* Module
-  * +include+ (now public)
-== Ruby 2.0 backports
-* Array
-  * +bsearch+
-* Enumerable
-  * +lazy+
-* Enumerator::Lazy
-  * all methods
-* Hash
-  * <tt>default_proc=</tt> (with nil argument)
-  * +to_h+
-* nil.to_h
-* Range
-  * +bsearch+
-* Struct
-  * +to_h+
-== Ruby 1.9.3 backports
-* File
-  * +NULL+
-* IO
-  * +advise+ (acts as a noop)
-  * +write+, +binwrite+
-* String
-  * +byteslice+
-  * +prepend+
-== Ruby 1.9.2 backports
-* Array
-  * <tt>rotate, rotate!</tt>
-  * <tt>keep_if, select!</tt>
-  * +product+ (with block)
-  * +repeated_combination+, +repeated_permutation+
-  * <tt>sort_by!</tt>
-  * <tt>uniq, uniq!</tt> (with block)
-* Complex
-  * +to_r+
-* Dir
-  * +home+
-* Enumerable
-  * +chunk+
-  * +flat_map+, +collect_concat+
-  * +join+
-  * +slice_before+
-* Float::INFINITY, NAN
-* Hash
-  * +keep_if+, <tt>select!</tt>
-* Object
-  * <tt>singleton_class</tt>
-* Random (new class)
-*Note*: The methods of +Random+ can't be required individually; the class can only be required whole with <tt>require 'backports/1.9.2/random'</tt>.
-== Ruby 1.9.1 backports
-Additionally, the following Ruby 1.9 features have been backported:
-* Array
-  * +try_convert+
-  * +sample+
-* Enumerable
-  * +each_with_object+
-  * +each_with_index+ (with arguments)
-* Enumerator
-  * +new+ (with block)
-* File
-  * +binread+
-  * +to_path+
-  * All class methods accepting filenames will accept files or anything with a <tt>#to_path</tt> method.
-  * <tt>File.open</tt> accepts an options hash.
-* Float
-  * +round+
-* Hash
-  * +assoc+, +rassoc+
-  * +key+
-  * +try_convert+
-  * <tt>default_proc=</tt>
-* Integer
-  * +magnitude+
-  * +round+
-* IO
-  * +bin_read+
-  * +try_convert+
-  * +ungetbyte+
-  * <tt>IO.open</tt> accepts an options hash.
-* Kernel
-  * +require_relative+
-* Math
-  * +log+ (with base)
-  * +log2+
-* Numeric
-  * +round+
-* Object
-  * +define_singleton_method+
-  * +public_method+
-  * +public_send+
-* Proc
-  * +yield+
-  * +lambda?+
-  * +curry+
-  * <tt>===</tt>
-* Range
-  * <tt>cover?</tt>
-* Regexp
-  * +try_convert+
-* String
-  * <tt>ascii_only?</tt>
-  * +chr+
-  * +clear+
-  * +codepoints+, +each_codepoint+
-  * +get_byte+, +set_byte+
-  * +ord+
-  * +try_convert+
-+Enumerator+ can be accessed directly (instead of <tt>Enumerable::Enumerator</tt>)
-To include _only_ these backports and those of the 1.8 line, <tt>require "backports/1.9.1"</tt>.
-Moreover, a pretty good imitation of +BasicObject+ is available,
-but since it is only an imitation, it must be required explicitly:
-  require 'backports/basic_object'
-== Ruby 1.8.7
-Complete Ruby 1.8.7 backporting (core language). Refer to the official list of changes[https://github.com/ruby/ruby/blob/ruby_1_8_7/NEWS]. That's about 130 backports!
-Only exceptions:
-* String#gsub (the form returning an enumerator)
-* GC.stress=  (not implemented)
-* Array#choice (removed in 1.9, use 1.9.1's Array#sample instead)
-== Libraries
-Libraries are slowly being backported. You simply require them as usual after requiring 'backports/std_lib'. Requiring 'backports/std_lib' after the standard libraries is also supported.
-  require "backports/std_lib"
-  require "prime"
-  42.prime? # => false, even in Ruby 1.8.x
-The following libraries are up to date with Ruby 1.9.3:
-* Matrix
-* Prime
-* Set
-The following library is to date with Ruby 2.0.0:
-* OpenStruct (ostruct)
-I am aware of the following backport gem, which probably won't make it into this gem:
-* Net::SMTP for Ruby 1.8.6: smtp_tls[http://seattlerb.rubyforge.org/smtp_tls/]
-Requiring backports for a given version of Ruby will also load 'backports/std_lib'.
-== Forcing incompatibilities
-Some backports would create incompatibilities in their current Ruby version but could be useful in some projects. It is possible to request such incompatible changes. Backports currently supports the following:
-* Hash
-  * +select+ (returns a Hash instead of an Array)
-* Enumerable / Array
-  * +map+ (returns an enumerator when called without a block)
-* String
-  * +length+, +size+ (for UTF-8 support)
-These must be imported in addition to the backports gem, for example:
-  require "backports/force/hash_select"
-  {}.select{} # => {}, even in Ruby 1.8
-== Thanks
-Thanks for the bug reports and patches, in particular the repeat offenders:
-* Arto Bendiken ( bendiken[http://github.com/bendiken] )
-* Konstantin Haase ( rkh[https://github.com/rkh])
-* Roger Pack ( rdp[http://github.com/rdp] )
-== Contributing
-The best way to submit a patch is to also submit a patch to ruby/spec[https://github.com/ruby/spec] and then a patch to backports that make it pass the spec.
-See below to test rubyspec. Note that only features missing from your Ruby version are tested.
-    git submodule init && git submodule update # => pulls rubyspecs
-    bundle install
-    bundle exec rake spec[hash/slice]          # => tests Hash#slice  (must be in Ruby 2.4 or less)
-    bundle exec rake spec[hash/*]              # => tests all backported Hash methods
-    bundle exec rake spec  (or rake spec[*/*]) # => all rubyspecs for backported methods
-Failures that are acceptable are added the to `tags` file.
-= License
-+backports+ is released under the terms of the MIT License, see the included LICENSE file.
-Author::                 Marc-André Lafortune

data/Rakefile DELETED Viewed

@@ -1,192 +0,0 @@
-begin
-  require "bundler/gem_tasks"
-rescue LoadError
-  # bundler not installed
-end
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/*_test.rb'
-  test.verbose = false
-end
-class SpecRunner
-  STATS = [:files, :examples, :expectations, :failures, :errors]
-  attr_reader :stats, :not_found
-  def initialize
-    @counts = [0] * 5
-    @not_found = []
-  end
-  def run(cmd, path)
-    result = `#{cmd}`
-    match = result.match(/(\d+) files?, (\d+) examples?, (\d+) expectations?, (\d+) failures?, (\d+) errors?/)
-    if match.nil?
-      puts "*** mspec returned with unexpected results:"
-      puts result
-      puts "Command was:", cmd
-      exit
-    end
-    _, ex, p, f, e = data = match.captures.map{|x| x.to_i}
-    not_found << path if ex == 0
-    STATS.each_with_index do |_, i|
-      @counts[i] += data[i]
-    end
-    if f + e > 0
-      puts cmd
-      puts result
-    else
-      print "."
-      STDOUT.flush
-    end
-  end
-  def stats
-    h = {}
-    STATS.zip(@counts).each{|k, v| h[k]=v}
-    h
-  end
-  def report
-    puts "*** Overall:", stats.map{|a| a.join(' ')}.join(', ')
-    puts "No spec found for #{@not_found.join(', ')}" unless @not_found.empty?
-  end
-  def success?
-    stats[:failures] == 0 && stats[:errors] == 0
-  end
-end
-desc "Run specs, where path can be '*/*' (default), 'class/*' or 'class/method'."
-task :spec, :path, :action do |t, args|
-  args.with_defaults(:path => '*/*', :action => 'ci')
-  specs = SpecRunner.new
-  # Avoid unclear error message by checking if at least one spec exists in the old specs
-  has_frozen_spec = !Dir.glob('frozen_old_spec/rubyspec/core/#{path}_spec.rb')
-  if has_frozen_spec || RUBY_VERSION < '1.9'
-    mspec_cmds(args[:path], 'frozen_old_spec', args[:action]) do |cmd, path|
-      specs.run(cmd, path)
-    end
-  end
-  unless RUBY_VERSION < '1.9' # Give up entirely on running new specs in 1.8.x, mainly because of {hash: 'syntax'}
-    mspec_cmds(args[:path], 'spec', args[:action]) do |cmd, path|
-      specs.run(cmd, path)
-    end
-  end
-  specs.report
-  fail unless specs.success?
-end
-task :all_spec do # Necessary because of argument passing bug in 1.8.7
-  Rake::Task[:spec].invoke
-end
-desc "Same as spec, but creating tags for failures"
-task :spec_tag, :path do |t, args|
-  Rake::Task[:spec].invoke(args[:path], 'tag -G fails')
-end
-task :default => [:test, :all_spec]
-DEPENDENCIES = Hash.new([]).merge!(
-  '1.8.7/argf/chars'     => 'backports/1.8.7/string/each_char',
-  '1.8.7/argf/each_char' => 'backports/1.8.7/string/each_char',
-  '1.8.7/array/cycle'    => 'backports/1.8.7/stop_iteration',
-  '1.8.7/enumerable/entries' => ['backports/1.8.7/enumerable/each_with_index', 'backports/1.8.7/enumerable/to_a'],
-  '1.8.7/enumerator/rewind' => 'backports/1.8.7/enumerator/next',
-  '1.8.7/hash/reject' => 'backports/1.8.7/integer/even',
-  '1.9.1/hash/rassoc'    => 'backports/1.9.1/hash/key',
-  '1.9.1/proc/lambda'    => 'backports/1.9.1/proc/curry',
-  '1.9.2/complex/to_r'   => 'complex',
-  '1.9.2/array/select'    => 'backports/1.8.7/array/select',
-  '1.9.2/hash/select'    => 'backports/1.8.7/hash/select',
-  '1.9.2/enumerable/each_entry' => 'backports/1.8.7/enumerable/each_with_index',
-  '2.0.0/hash/to_h'      => 'backports/1.9.1/hash/default_proc',
-  '2.2.0/float/next_float' => 'backports/2.2.0/float/prev_float',
-  '2.2.0/float/prev_float' => 'backports/2.2.0/float/next_float',
-  '2.3.0/array/bsearch_index' => ['backports/2.3.0/array/dig', 'backports/2.3.0/hash/dig'],
-  '2.3.0/array/dig' => ['backports/2.3.0/hash/dig', 'backports/2.3.0/struct/dig'],
-  '2.3.0/hash/dig' => ['backports/2.3.0/array/dig', 'backports/2.3.0/struct/dig'],
-  '2.3.0/struct/dig' => ['backports/2.3.0/array/dig', 'backports/2.3.0/hash/dig'],
-  '2.7.0/enumerable/tally' => ['backports/2.4.0/hash/transform_values', 'backports/2.2.0/kernel/itself'],
-)
-{
-  :each_with_index => %w[enumerable/detect enumerable/find enumerable/find_all enumerable/select enumerable/to_a],
-  :first => %w[enumerable/cycle io/bytes io/chars io/each_byte io/each_char io/lines io/each_line]
-}.each do |req, libs|
-  libs.each{|l| DEPENDENCIES["1.8.7/#{l}"] = "backports/1.8.7/enumerable/#{req}" }
-end
-# These **old** specs cause actual errors while loading in 1.8:
-OLD_IGNORE_IN_18 = %w[
-  1.9.1/symbol/length
-  1.9.1/symbol/size
-  1.9.3/string/byteslice
-  1.8.7/proc/yield
-  1.9.1/proc/case_compare
-  2.4.0/string/match
-  2.4.0/regexp/match
-  2.5.0/module/define_method
-]
-# These **new** specs cause actual errors while loading in 1.9:
-IGNORE_IN_19 = %w[
-  2.1.0/enumerable/to_h
-  2.1.0/array/to_h
-  2.1.0/module/include
-  2.2.0/kernel/itself
-  2.5.0/module/define_method
-  2.5.0/module/alias_method
-  2.5.0/module/undef_method
-  2.5.0/module/remove_method
-  2.5.0/module/attr
-  2.5.0/module/attr_reader
-  2.5.0/module/attr_writer
-  2.5.0/module/attr_accessor
-  2.5.0/struct/new
-]
-# These **new** specs cause actual errors while loading in 2.0.0:
-IGNORE_IN_200 = %w[
-  2.4.0/enumerable/sum
-]
-CLASS_MAP = Hash.new{|k, v| k[v] = v}.merge!(
-  'match_data' => 'matchdata',  # don't ask me why RubySpec uses matchdata instead of match_data
-  'true_class' => 'true',
-  'false_class' => 'false',
-  'nil_class' => 'nil'
-)
-EXTRA_SPECS = {
-  'enumerable/chain' => %w[enumerator/chain/*]
-}
-def mspec_cmds(pattern, spec_folder, action='ci')
-  pattern = "lib/backports/*.*.*/#{pattern}.rb"
-  Dir.glob(pattern) do |lib_path|
-    _match, version, path = lib_path.match(/backports\/(\d\.\d\.\d)\/(.*)\.rb/).to_a
-    next if path =~ /stdlib/
-    next if version <= RUBY_VERSION
-    version_path = "#{version}/#{path}"
-    if RUBY_VERSION < '2.0.0'
-      next if OLD_IGNORE_IN_18.include? version_path if RUBY_VERSION < '1.9'
-      next if IGNORE_IN_19.include? version_path
-      next if spec_folder != 'frozen_old_spec' && version <= '2.0.0'  # Don't run new specs for pre 2.0 features & ruby
-    end
-    next if RUBY_VERSION < '2.1.0' && IGNORE_IN_200.include?(version_path)
-    deps = [*DEPENDENCIES[version_path]].map{|p| "-r #{p}"}.join(' ')
-    klass, method = path.split('/')
-    path = [CLASS_MAP[klass], method].join('/')
-    spec_paths = [path, *EXTRA_SPECS[path]].map {|p| "#{spec_folder}/rubyspec/core/#{p}_spec.rb" }
-    yield %W[mspec #{action}
-              -I lib
-              -r ./set_version/#{version}
-              #{deps}
-              -r backports/#{version_path}
-              #{spec_paths.join(' ')}
-            ].join(' '), path
-  end
-end