NEWS for Ruby 2.6.0

本文档是除 bug 修复之外，在版本发布之间所做的用户可见功能更改的列表。

请注意，每个条目都非常简短，没有提供原因或参考信息。要获取包含所有足够信息的更改的完整列表，请参阅 ChangeLog 文件或 Redmine（例如 https://bugs.ruby-lang.org/issues/$FEATURE_OR_BUG_NUMBER）

自 2.5.0 版本以来的更改

语言更改

• $SAFE 现在是进程全局状态，可以再次设置为 0。[Feature #14250]

• 在块传递时进行细化。[Feature #14223]

• 细化发生在 Kernel#public_send 上。[Feature #15326]

• 细化发生在 Kernel#respond_to? 上。[Feature #15327]

• 没有 rescue 的 else 现在会导致语法错误。[EXPERIMENTAL] [Feature #14606]

• 常量名称可以以非 ASCII 大写字母开头。[Feature #13770]

• 引入了无限范围。您可以使用没有结束的 Range，例如 (0..)（或类似地 (0...)）。[Feature #12912]

  以下显示了典型的用例

  ary[1..]                              # identical to ary[1..-1]
  (1...).each {|index| block }          # infinite loop from index 1
  ary.zip(1..) {|elem, index| block }   # ary.each.with_index(1) { }
  

• 关键字参数哈希中的非 Symbol 键会导致异常。

• 删除了“遮蔽外部局部变量”警告。[Feature #12490]

  您现在可以按以下方式编写而不会收到警告

  user = users.find {|user| cond(user) }
  

• 如果异常未被捕获并打印其回溯和错误消息，则打印异常的 cause。[Feature #8257]

• Flip-flop 语法已弃用。[Feature #5400]

核心类更新（仅列出重要的更新）

Array

新方法

• 添加了 Array#union 和 Array#difference 实例方法。[Feature #14097]

修改后的方法

• Array#to_h 现在接受一个将元素映射到新键/值对的块。[Feature #15143]

别名方法

• Array#filter 是 Array#select 的一个新别名。[Feature #13784]

• Array#filter! 是 Array#select! 的一个新别名。[Feature #13784]

Binding

新方法

• 添加了 Binding#source_location。[Feature #14230]

  此方法返回绑定（binding）的源位置，这是一个由 __FILE__ 和 __LINE__ 组成的 2 元素数组。传统上，可以通过 eval("[__FILE__, __LINE__]", binding) 检索相同的信息，但我们计划更改此行为，以便 Kernel#eval 忽略绑定的源位置 [Bug #4352]。因此，用户应改用此新引入的方法而不是 Kernel#eval。

Dir

新方法

• 添加了 Dir#each_child 和 Dir#children 实例方法。[Feature #13969]

Enumerable

新方法

• Enumerable#chain 返回一个枚举器对象，该对象依次遍历接收者的元素和每个参数的元素。[Feature #15144]

修改后的方法

• Enumerable#to_h 现在接受一个将元素映射到新键/值对的块。[Feature #15143]

别名方法

• Enumerable#filter 是 Enumerable#select 的一个新别名。[Feature #13784]

Enumerator::ArithmeticSequence

• 这是一个新的类，用于表示算术序列的生成器，即由公差定义的数字序列。它可以用于表示类似于 Python 切片的内容。您可以通过 Numeric#step 和 Range#step 获取此类的一个实例。

Enumerator::Chain

• 这是一个新的类，用于表示可枚举对象的链，它作为一个单一的枚举器工作，由 Enumerable#chain 和 Enumerator#+ 等方法生成。

Enumerator::Lazy

别名方法

• Enumerator::Lazy#filter 是 Enumerator::Lazy#select 的一个新别名。[Feature #13784]

Enumerator

新方法

• Enumerator#+ 返回一个枚举器对象，该对象依次遍历接收者和其他操作数中的元素。[Feature #15144]

ENV

修改后的方法

• ENV.to_h 现在接受一个将名称和值映射到新键和值的块。[Feature #15143]

Exception

新选项

• Exception#full_message 接受 :highlight 和 :order 选项。[Bug #14324]

Hash

修改后的方法

• Hash#merge、Hash#merge! 和 Hash#update 现在接受多个参数。[Feature #15111]

• Hash#to_h 现在接受一个将键和值映射到新键和值的块。[Feature #15143]

别名方法

• Hash#filter 是 Hash#select 的一个新别名。[Feature #13784]

• Hash#filter! 是 Hash#select! 的一个新别名。[Feature #13784]

IO

新选项

• 添加了新的模式字符 'x' 以用于独占访问打开文件。[Feature #11258]

Kernel

别名方法

• Kernel#then 是 Kernel#yield_self 的一个新别名。[Feature #14594]

新选项

• Kernel#Complex、Kernel#Float、Kernel#Integer 和 Kernel#Rational 接受 :exception 选项来指定错误处理方式。[Feature #12732]

• Kernel#system 接受 :exception 选项，在失败时引发异常。[Feature #14386]

不兼容的更改

• Kernel#system 和 Kernel#exec 不会关闭非标准文件描述符（:close_others 选项的默认值已更改为 false，但我们仍然在我们创建的描述符上设置 FD_CLOEXEC 标志）。[Misc #14907]

KeyError

新选项

• KeyError.new 接受 :receiver 和 :key 选项，以在 Ruby 代码中设置接收者和键。[Feature #14313]

Method

新方法

• 添加了 Method#<< 和 Method#>> 以用于 Proc 组合。[Feature #6284]

Module

修改后的方法

• Module#method_defined?、Module#private_method_defined? 和 Module#protected_method_defined? 现在接受第二个可选参数。如果为 true（默认值），它会检查祖先模块/类，否则只检查类本身。[Feature #14944]

NameError

新选项

• NameError.new 接受一个 :receiver 选项，以在 Ruby 代码中设置接收者。[Feature #14313]

NilClass

新方法

• 添加了 NilClass#=~ 以实现兼容性。[Feature #15231]

NoMethodError

新选项

• NoMethodError.new 接受一个 :receiver 选项，以在 Ruby 代码中设置接收者。[Feature #14313]

Numeric

不兼容的更改

• Numeric#step 现在返回 Enumerator::ArithmeticSequence 类的实例，而不是 Enumerator 类的实例。

OpenStruct

修改后的方法

• OpenStruct#to_h 现在接受一个将键和值映射到新键和值的块。[Feature #15143]

Proc

新方法

• 添加了 Proc#<< 和 Proc#>> 以用于 Proc 组合。[Feature #6284]

不兼容的更改

• Proc#call 不再更改 $SAFE。[Feature #14250]

Random

新方法

• 添加了 Random.bytes。[Feature #4938]

Range

新方法

• 添加了 Range#% 实例方法。[Feature #14697]

不兼容的更改

• Range#=== 现在使用 cover? 而不是 include? 方法。[Feature #14575]

• Range#cover? 现在接受一个 Range 对象。[Feature #14473]

• Range#step 现在返回 Enumerator::ArithmeticSequence 类的实例，而不是 Enumerator 类的实例。

Regexp/String

• 将 Unicode 版本从 10.0.0 更新到 11.0.0。[Feature #14802]

  这包括重写了 String#downcase 的字素簇 (/X/) 算法和格鲁吉亚语 MTAVRULI 的特殊大小写处理。

• 将 Emoji 版本从 5.0 更新到 11.0.0 [Feature #14802]

RubyVM::AbstractSyntaxTree

新方法

• RubyVM::AbstractSyntaxTree.parse 解析给定的字符串并返回 AST 节点。[experimental]

• RubyVM::AbstractSyntaxTree.parse_file 解析给定的文件并返回 AST 节点。[experimental]

• RubyVM::AbstractSyntaxTree.of 返回给定 proc 或方法的 AST 节点。[experimental]

RubyVM

新方法

• RubyVM.resolve_feature_path 识别将由“require(feature)”加载的文件。[experimental] [Feature #15230]

String

• String#crypt 已弃用。[Feature #14915]

新功能

• String#split 如果给定块，则将每个子字符串传递给该块。[Feature #4780]

Struct

修改后的方法

• Struct#to_h 现在接受一个将键和值映射到新键和值的块。[Feature #15143]

别名方法

• Struct#filter 是 Struct#select 的一个新别名。[Feature #13784]

Time

新功能

• Time.new 和 Time#getlocal 接受时区对象以及 UTC 偏移字符串。Time#+、Time#- 和 Time#succ 也保留时区。[Feature #14850]

TracePoint

新功能

• 支持“script_compiled”事件。[Feature #15287]

新方法

• TracePoint#parameters [Feature #14694]

• TracePoint#instruction_sequence [Feature #15287]

• TracePoint#eval_script [Feature #15287]

修改后的方法

• TracePoint#enable 接受新的关键字参数“target:”和“target_line:”。[Feature #15289]

标准库更新（仅列出重要的更新）

BigDecimal

升级到版本 1.4.0。此版本包含一些兼容性问题，有关详细信息，请参阅下面的兼容性问题部分。

修改后的方法

• BigDecimal() 接受新的关键字参数“exception:”，类似于 Float()。

关于近期版本之间差异的说明

您应该想了解 bigdecimal 近期版本之间的差异。请根据以下信息选择适合的 bigdecimal 版本。

• 1.3.5 具有不带“exception:”关键字的 BigDecimal.new。当您指定“-w”选项时，您会看到 BigDecimal.new 的弃用警告。BigDecimal()、BigDecimal.new 和 Object#to_d 方法是相同的。

• 1.4.0 具有带“exception:”关键字的 BigDecimal.new。您总是会看到 BigDecimal.new 的弃用警告。Object#to_d 方法与 BigDecimal() 和 BigDecimal.new 不同。

• 2.0.0 将在 Ruby 2.6.0 发布后不久发布。此版本将不包含 BigDecimal.new 方法。

Bundler

• 将 Bundler 添加到标准库。[Feature #12733]

• 使用 1.17.2，这是最新的稳定版本。

Coverage

添加了一个 oneshot_lines 模式。[Feature #15022]

此模式检查“每行是否至少执行了一次”，而不是“每行执行了多少次”。每行的钩子最多触发一次，触发后移除钩子标志，即零开销运行。

新选项

• 向 Coverage.start 添加 :oneshot_lines 关键字参数。

• 向 Coverage.result 添加 :stop 和 :clear 关键字参数。如果 clear 为 true，则将计数器清零。如果 stop 为 true，则禁用覆盖率测量。

新方法

• Coverage.line_stub，这是一个简单的辅助函数，用于从给定源代码创建行覆盖率的“存根”。

CSV

• 升级到 3.0.2。这包括性能改进，尤其是在写入方面。写入速度提高了约 2 倍。请参阅 github.com/ruby/csv/blob/master/NEWS.md。

ERB

新选项

• 向 ERB.new 添加 :trim_mode 和 :eoutvar 关键字参数。现在，第一个参数以外的非关键字参数已软弃用，将在 Ruby 2.5 EOL 后移除。[Feature #14256]

• erb 命令的 -S 选项已弃用，将在下一个版本中移除。

FileUtils

新方法

• FileUtils#cp_lr。[Feature #4189]

Matrix

新方法

• Matrix#antisymmetric?, Matrix#skew_symmetric?

• Matrix#map!, Matrix#collect! [Feature #14151]

• Matrix#[]=

• Vector#map!, Vector#collect!

• Vector#[]=

Net

新选项

• 向 Net::HTTP.new 添加 :write_timeout 关键字参数。[Feature #13396]

新方法

• 添加 Net::HTTP#write_timeout 和 Net::HTTP#write_timeout=。[Feature #13396]

新常量

• 添加 Net::HTTPClientException 来弃用 Net::HTTPServerException，其名称具有误导性。[Bug #14688]

NKF

• 升级到 nkf v2.1.5

Psych

• 升级到 Psych 3.1.0

RDoc

• 速度提升约 2 倍。

• 使用 SOURCE_DATE_EPOCH 生成文件。

• 修复了因滑动而丢失的方法行号。

• 启用了被忽略的 --width、--exclude 和 --line-numbers。

• 在默认标记符号中添加对“>>>”引语的支持。

• 在 TomDoc 符号中添加对“Raises”行的支持。

• 修复了语法错误输出。

• 修复了许多解析错误。

REXML

• 升级到 REXML 3.1.9。请参阅 github.com/ruby/rexml/blob/master/NEWS.md。

改进了一些 XPath 实现

• concat() 函数：在连接之前将所有参数字符串化。

• string() 函数：支持上下文节点。

• string() 函数：支持处理指令节点。

• 在 XPath 2.0 中支持 "*:{ELEMENT_NAME}" 语法。

修复了部分 XPath 实现

• "//#{ELEMENT_NAME}[#{POSITION}]" 情况

• string() 函数：修复了 function(document) 返回根元素之外的节点的问题。

• "/ #{ELEMENT_NAME} " 情况

• "/ #{ELEMENT_NAME} [ #{PREDICATE} ]" 情况

• "/ #{AXIS}::#{ELEMENT_NAME}" 情况

• "#{N}-#{M}" 情况："-" 前需要一个或多个空格

• "/child::node()" 情况

• "#{FUNCTION}()/#{PATH}" 情况

• "@#{ATTRIBUTE}/parent::" 情况

• "name(#{NODE_SET})" 情况

RSS

新选项

• RSS::Parser.parse 现在接受 Hash 作为选项。可用选项有 :validate、:ignore_unknown_element、:parser_class。

RubyGems

• 升级到 RubyGems 3.0.1

• blog.rubygems.org/2018/12/19/3.0.0-released.html

• blog.rubygems.org/2018/12/23/3.0.1-released.html

Set

别名方法

• Set#filter! 是 Set#select! 的一个新别名。[Feature #13784]

URI

新常量

• 添加 URI::File 以处理文件 URI 方案。[Feature #14035]

兼容性问题（不包括功能性 bug 修复）

Dir

• 带有 '\0' 分隔模式列表的 Dir.glob 已弃用，现在会发出警告。[Feature #14643]

File

• File.read、File.binread、File.write、File.binwrite、File.foreach 和 File.readlines 即使路径以管道字符 '|' 开头也不会调用外部命令。[Feature #14245]

Object

• Object#=~ 已弃用。[Feature #15231]

标准库兼容性问题（不包括功能 bug 修复）

• 这些标准库已升级为默认 gem。

  • e2mmap

  • forwardable

  • irb

  • logger

  • matrix

  • mutex_m

  • ostruct

  • prime

  • rexml

  • rss

  • shell

  • sync

  • thwait

  • tracer

BigDecimal

• 以下方法已被移除。

  • BigDecimal.allocate

  • BigDecimal.ver

• 每个 BigDecimal 对象都是冻结的。[Feature #13984]

• BigDecimal() 解析给定的字符串，类似于 Float()。

• String#to_d 解析接收者字符串，类似于 String#to_f。

• BigDecimal.new 将在 2.0 版本中移除。

Pathname

• Pathname#read、Pathname#binread、Pathname#write、Pathname#binwrite、Pathname#each_line 和 Pathname#readlines 即使路径以管道字符 '|' 开头也不会调用外部命令。这遵循 [Feature #14245]。

实现改进

• 加速 Proc#call，因为我们不再需要考虑 $SAFE。[Feature #14318]

  使用使用 Proc#call 多次的 lc_fizzbuzz 基准测试，我们可以测量到 1.4 倍的改进。[Bug #10212]

• 加速 block.call，其中 block 是传递的块参数。[Feature #14330]

  Ruby 2.5 提高了块传递的性能。[Feature #14045]

  此外，Ruby 2.6 提高了传递块的调用性能。

• 引入了 JIT（即时）编译器的初步实现。[Feature #14235] [experimental]

  • 添加了 --jit 命令行选项以启用 JIT。--jit-verbose=1 有助于检查。有关其他信息，请参阅 ruby --help。

  • 为了生成机器代码，此 JIT 编译器使用用于构建解释器的 C 编译器。目前支持 GCC、Clang 和 Microsoft Visual C++。

  • 在 configure 中添加了 --disable-mjit-support 选项。这是为 JIT 调试添加的，但如果您在构建 JIT 的头文件时遇到错误，可以使用此选项跳过构建它作为一种解决方法。

  • rb_waitpid 在类 Unix 平台上重新实现，以保持与为 JIT 创建的进程兼容[Bug #14867]

• VM 生成器脚本更新；使生成的 VM 更加优化。[GH-1779]

• 启用了 pthreads 平台的 Thread 缓存（用于 Thread.new 和 Thread.start）。[Feature #14757]

• 在具有 POSIX 定时器的平台上消除了定时器线程。[Misc #14937]

• 支持临时堆（theap）。[Bug #14858] [Feature #14989]

  theap 是一个用于短生命周期内存对象的托管堆。例如，创建小型短生命周期的 Hash 对象速度提高了 2 倍。使用 rdoc 基准测试，我们测量了 6-7% 的性能改进。

• 协程的原生实现（arm32、arm64、ppc64le、win32、win64、x86、amd64），以显著提高 Fiber 的性能。[Feature #14739]

杂项更改

• 在 macOS 上，共享库不再在其名称中包含 Ruby 的完整版本号。这消除了每次微小升级时用户需要重新编译所有扩展库的负担。

  之前

  • libruby.2.6.0.dylib

  • libruby.2.6.dylib -> libruby.2.6.0.dylib

  • libruby.dylib -> libruby.2.6.0.dylib

  之后

  • libruby.2.6.dylib

  • libruby.dylib -> libruby.2.6.dylib

• 将 misc/*.el 文件提取到 github.com/ruby/elisp