NEWS.md 5.5 KB
Newer Older
Y
Yusuke Endoh 已提交
1 2
# NEWS for Ruby 2.8.0 (tentative; to be 3.0.0)

3 4
This document is a list of user visible feature changes
since the **2.7.0** release, except for bug fixes.
Y
Yusuke Endoh 已提交
5 6 7 8 9 10

Note that each entry is kept so brief that no reason behind or reference
information is supplied with.  For a full list of changes with all
sufficient information, see the ChangeLog file or Redmine
(e.g. `https://bugs.ruby-lang.org/issues/$FEATURE_OR_BUG_NUMBER`).

11
## Language changes
Y
Yusuke Endoh 已提交
12

J
Jeremy Evans 已提交
13 14 15 16
* Keyword arguments are now separated from positional arguments.
  Code that resulted in deprecation warnings in Ruby 2.7 will now
  result in ArgumentError or different behavior. [[Feature #14183]]

17 18 19 20 21
* Procs accepting a single rest argument and keywords are no longer
  subject to autosplatting.  This now matches the behavior of Procs
  accepting a single rest argument and no keywords.
  [[Feature #16166]]

22
    ```ruby
23 24 25 26 27 28 29 30 31
    pr = proc{|*a, **kw| [a, kw]}

    pr.call([1])
    # 2.7 => [[1], {}]
    # 3.0 => [[[1]], {}]

    pr.call([1, {a: 1}])
    # 2.7 => [[1], {:a=>1}] # and deprecation warning
    # 3.0 => [[[1, {:a=>1}]], {}]
32
    ```
33

34 35
* $SAFE is now a normal global variable with no special behavior.
  [[Feature #16131]]
36

J
Jeremy Evans 已提交
37 38 39
* yield in singleton class definitions in methods is now a SyntaxError
  instead of a warning. yield in a class definition outside of a method
  is now a SyntaxError instead of a LocalJumpError.  [[Feature #15575]]
40

41 42
* Rightward assignment statement is added.  [EXPERIMENTAL]
  [[Feature #15921]]
N
Nobuyoshi Nakada 已提交
43 44 45 46 47

    ```ruby
    fib(10) => x
    ```

48
## Command line options
Y
Yusuke Endoh 已提交
49

50 51 52
## Core classes updates

Outstanding ones only.
Y
Yusuke Endoh 已提交
53

54 55 56 57 58 59 60
* Dir

    * Modified method

        * Dir.glob and Dir.[] now sort the results by default, and
          accept `sort:` keyword option.  [[Feature #8709]]

61
* Hash
Y
Yusuke Endoh 已提交
62

63
    * Modified method
Y
Yusuke Endoh 已提交
64

65
        * Hash#transform_keys now accepts a hash that maps keys to new
66
          keys.  [[Feature #16274]]
Y
Yusuke Endoh 已提交
67

J
Jeremy Evans 已提交
68 69 70 71
* Kernel

    * Modified method

72 73
        * Kernel#clone when called with `freeze: false` keyword will call
          #initialize_clone with the `freeze: false` keyword.
J
Jeremy Evans 已提交
74 75 76
          [[Bug #14266]]

        * Kernel#eval when called with two arguments will use "(eval)"
77
          for `__FILE__` and 1 for `__LINE__` in the evaluated code.
J
Jeremy Evans 已提交
78 79 80 81 82 83 84 85 86 87 88 89
          [[Bug #4352]]

* Module

    * Modified method

        * Module#include now includes the arguments in modules and
          classes that have already included or prepended the receiver,
          mirroring the behavior if the arguments were included in the
          receiver before the other modules and classes included or
          prepended the receiver.  [[Feature #9573]]

90 91 92 93 94 95 96
* Symbol

    * Modified method

        * Symbol#to_proc now returns a lambda Proc.
          [[Feature #16260]]

97 98 99
## Stdlib updates

Outstanding ones only.
Y
Yusuke Endoh 已提交
100

101 102 103 104
* Net::HTTP

    * New method

105
        * Add Net::HTTP#verify_hostname= and Net::HTTP#verify_hostname
106
          to skip hostname verification.  [[Feature #16555]]
107

108 109 110
    * Modified method

        * Net::HTTP.get, Net::HTTP.get_response, and Net::HTTP.get_print can
111 112
          take request headers as a Hash in the second argument when the first
          argument is a URI.
113

114 115 116
## Compatibility issues

Excluding feature bug fixes.
Y
Yusuke Endoh 已提交
117

118
* Regexp literals are frozen [[Feature #8948]] [[Feature #16377]]
119

120
    ```ruby
121 122
    /foo/.frozen? #=> true
    ```
123

124
* Bundled gems
125

126 127 128 129
    * net-telnet and xmlrpc have been removed from the bundled gems.
      If you are interested in maintaining them, please comment on
      your plan to https://github.com/ruby/xmlrpc
      or https://github.com/ruby/net-telnet.
130

131 132 133 134 135 136 137
* EXPERIMENTAL: Hash#each consistently yields a 2-element array [[Bug #12706]]

    * Now `{ a: 1 }.each(&->(k, v) { })` raises an ArgumentError
      due to lambda's arity check.
    * This is experimental; if it brings a big incompatibility issue,
      it may be reverted until 2.8/3.0 release.

138 139 140
## Stdlib compatibility issues

Excluding feature bug fixes.
Y
Yusuke Endoh 已提交
141

142
## C API updates
Y
Yusuke Endoh 已提交
143

J
Jeremy Evans 已提交
144 145 146
* C API functions related to $SAFE have been removed.
  [[Feature #16131]]

147 148 149
* C API header file `ruby/ruby.h` was split. [[GH-2991]] Should have no implact
  on extension libraries, but users might experience slow compilations.

150
## Implementation improvements
Y
Yusuke Endoh 已提交
151

152 153 154 155 156
* The number of hashes allocated when using a keyword splat in
  a method call has been reduced to a maximum of 1, and passing
  a keyword splat to a method that accepts specific keywords
  does not allocate a hash.

157
## Miscellaneous changes
158

159
* Methods using `ruby2_keywords` will no longer keep empty keyword
J
Jeremy Evans 已提交
160
  splats, those are now removed just as they are for methods not
161
  using `ruby2_keywords`.
J
Jeremy Evans 已提交
162 163 164 165

* Taint deprecation warnings are now issued in regular mode in
  addition to verbose warning mode.  [[Feature #16131]]

166

167
[Bug #4352]:      https://bugs.ruby-lang.org/issues/4352
168
[Feature #8709]:  https://bugs.ruby-lang.org/issues/8709
169
[Feature #8948]:  https://bugs.ruby-lang.org/issues/8948
170 171 172
[Feature #9573]:  https://bugs.ruby-lang.org/issues/9573
[Feature #14183]: https://bugs.ruby-lang.org/issues/14183
[Bug #14266]:     https://bugs.ruby-lang.org/issues/14266
173 174
[Feature #15575]: https://bugs.ruby-lang.org/issues/15575
[Feature #16131]: https://bugs.ruby-lang.org/issues/16131
175
[Feature #16166]: https://bugs.ruby-lang.org/issues/16166
176
[Feature #16260]: https://bugs.ruby-lang.org/issues/16260
177 178
[Feature #16274]: https://bugs.ruby-lang.org/issues/16274
[Feature #16377]: https://bugs.ruby-lang.org/issues/16377
179
[Bug #12706]:     https://bugs.ruby-lang.org/issues/12706
N
Nobuyoshi Nakada 已提交
180
[Feature #15921]: https://bugs.ruby-lang.org/issues/15921
181
[Feature #16555]: https://bugs.ruby-lang.org/issues/16555
182
[GH-2991]:        https://github.com/ruby/ruby/pull/2991