ruby-next 0.13.3 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcf5d21d885266f5a03a0568d3759d3aa2dc14e7a787fce60ed5ee2a9e31e32d
-  data.tar.gz: '082bbdb7dd58f4ae65f101ad2f9c7ef88f3a8aaa4b404ed6e3997b09ad892df1'
+  metadata.gz: 8b0e47ba44b062642c2fe2859bfc46eea20edf4a060d1af872ed4c0ea1519d5b
+  data.tar.gz: 230c9f3fa559e841c188be97ea16dc58edce00de409973ea507cf225962ede5c
 SHA512:
-  metadata.gz: 1826875405dd0611fbc51fb2f69402672a3bfafadbd3236fe7101254aad7a9346197905558c01fffc1eb14546f152af6e3d18ceb133ae4250caa37111453bf56
-  data.tar.gz: 928a7f5bb8cbb8cafb1ef2e013ad8cedd6e7dcda806d12eb56b8a8ac8b04f25cf71efd4362e2c3df6f2f3aff77c48ae4ab43baa84a3543703880c4105483f948
+  metadata.gz: f1145cbe7b4afa3ab6d823d59c7391a126b28741f916ae87246406f7779caee3b271e65f1b0d61715d193e57daa7ef7ebbe1539f07b3c6d76757a429cfd0aa27
+  data.tar.gz: 16731c47cd9c169994beda5fd108631db60d9b7e5e25e5f783c9d407790b69dbc9a7f60b487f79a53b540724d94b086c4c2289f18d66fe00a8732a143454eec2

data/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 ## master
 
+## 0.15.0 (2022-03-21)
+
+- Support IRB ([@palkan][])
+
+- Create empty `.rbnext` folder during `nextify` if nothing to transpile. ([@palkan][])
+
+This would prevent from auto-transpiling a library every time when no files should be transpiled.
+
+- Auto-transpile using the current Ruby version. ([@palkan][])
+
+- Support Pry. ([@baygeldin][])
+
+- Add `rescue/ensure/else` within block rewriter for Ruby < 2.5. ([@fargelus][])
+
+## 0.14.1 (2022-01-21)
+
+- Fix nested find patterns transpiling. ([@palkan][])
+
+## 0.14.0 🎄
+
+- Add `Integer.try_convert`. ([@palkan][])
+
+- Add `Enumerable#compact`, `Enumerator::Lazy#compact`. ([@palkan][])
+
+- [Proposed] Add support for binding instance, class, global variables in pattern matching. ([@palkan][])
+
+This brings back rightward assignment: `42 => @v`.
+
+- Add `MatchData#match`. ([@palkan][])
+
+- Add support for command syntax in endless methods (`def foo() = puts "bar"`)
+
+- Add `Refinement#import_methods` support. ([@palkan][])
+
+This API only works in conjunction with transpiling, since it couldn't be backported purely as a method and requires passing an additional argument (Binding).
+
+You can find the details in [the PR](https://github.com/ruby-next/ruby-next/pull/85).
+
+- Added support for instance, class and global variables and expressions for pin operator. ([@palkan][])
+
+- Support omitting parentheses in one-line pattern matching. ([@palkan][])
+
+- Anonymous blocks `def b(&); c(&); end` ([@palkan][]).
+
 ## 0.13.3 (2021-12-08)
 
 - Revert 0.13.2 and freeze Parser version. ([@skryukov][])

data/README.md

@@ -71,8 +71,11 @@ _Please, submit a PR to add your project to the list!_
   - [`ruby -ruby-next`](#uby-next)
   - [Logging & Debugging](#logging-and-debugging)
 - [RuboCop](#rubocop)
+- [Using with IRB](#irb)
+- [Using with Pry](#pry)
 - [Using with EOL Rubies](#using-with-eol-rubies)
 - [Proposed & edge features](#proposed-and-edge-features)
+- [Known limitations](#known-limitations)
 
 ## Overview
 
@@ -200,8 +203,6 @@ You can change the transpiler mode:
 - Via environmental variable `RUBY_NEXT_TRANSPILE_MODE=ast`.
 - Via CLI option ([see below](#cli)).
 
-**NOTE:** For the time being, Unparser doesn't support Ruby 3.0 AST nodes, so we always use rewrite mode in Ruby 3.0+.
-
 ## CLI
 
 Ruby Next ships with the command-line interface (`ruby-next`) which provides the following functionality:
@@ -231,7 +232,7 @@ Usage: ruby-next nextify DIRECTORY_OR_FILE [options]
 
 The behaviour depends on whether you transpile a single file or a directory:
 
-- When transpiling a directory, the `.rbnext` subfolder is created within the target folder with subfolders for each supported Ruby versions (e.g., `.rbnext/2.6`, `.rbnext/2.7`, `.rbnext/3.0`). If you want to create only a single version (the smallest), you can also pass `--single-version` flag. In that case, no version directory is created (i.e., transpiled files go into `.rbnext`).
+- When transpiling a directory, the `.rbnext` subfolder is created within the target folder with subfolders for each supported Ruby versions (e.g., `.rbnext/2.6`, `.rbnext/2.7`, `.rbnext/3.0`, etc.). If you want to create only a single version (the smallest), you can also pass `--single-version` flag. In that case, no version directory is created (i.e., transpiled files go into `.rbnext`).
 
 - When transpiling a file and providing the output path as a _file_ path, only a single version is created. For example:
 
@@ -283,6 +284,8 @@ $ ruby-next core_ext -l --name=filter --name=deconstruct
   - EnumeratorLazyFilterMap
   - HashDeconstructKeys
   - StructDeconstruct
+
+...
 ```
 
 ### CLI configuration file
@@ -453,6 +456,38 @@ AllCops:
 
 **NOTE:** you need `ruby-next` gem available in the environment where you run RuboCop (having `ruby-next-core` is not enough).
 
+## IRB
+
+Ruby Next supports IRB. In order to enable edge Ruby features for your REPL, add the following line to your `.irbrc`:
+
+```ruby
+require "ruby-next/irb"
+```
+
+Alternatively, you can require it at startup:
+
+```sh
+irb -r ruby-next/irb
+# or
+irb -ruby-next/irb
+```
+
+## Pry
+
+Ruby Next supports Pry. In order to enable edge Ruby features for your REPL, add the following line to your `.pryrc`:
+
+```ruby
+require "ruby-next/pry"
+```
+
+Alternatively, you can require it at startup:
+
+```sh
+pry -r ruby-next/pry
+# or
+pry -ruby-next/pry
+```
+
 ## Using with EOL Rubies
 
 We currently provide support for Ruby 2.2, 2.3 and 2.4.
@@ -522,13 +557,38 @@ require "ruby-next/language/runtime"
 
 ### Supported edge features
 
-`Array#intersect?` ([#15198](https://bugs.ruby-lang.org/issues/15198))
+It's too early, Ruby 3.1 has just been released. See its features in the [supported features list](./SUPPORTED_FEATURES.md).
 
 ### Supported proposed features
 
 - _Method reference_ operator (`.:`) ([#13581](https://bugs.ruby-lang.org/issues/13581)).
+- Binding non-local variables in pattern matching (`42 => @v`) ([#18408](https://bugs.ruby-lang.org/issues/18408)).
+
+## Known limitations
+
+Ruby Next aims to be _reasonably compatible_ with MRI. That means, some edge cases could be uncovered. Below is the list of known limitations.
+
+For gem authors, we recommend testing against all supported versions on CI to make sure you're not hit by edge cases.
+
+### Enumerable methods
+
+Using refinements (`using RubyNext`) for modules could lead to unexpected behaviour in case there is also a `prepend` for the same module in Ruby <2.7.
+To eliminate this, we also refine Array (when appropriate), but other enumerables could be affected.
+
+See [this issue](https://bugs.ruby-lang.org/issues/13446) for details.
+
+### `Refinement#import_methods`
+
+- Doesn't support importing methods generated with `eval`.
+- Doesn't support aliases (both `alias` and `alias_method`).
+- In JRuby, importing attribute accessors/readers/writers is not supported.
+- When using AST transpiling in runtime, likely fails to import methods from a transpiled files (due to the updated source location).
+
+See the [original PR](https://github.com/ruby-next/ruby-next/pull/85) for more details.
+
+### Other
 
-- Shorthand Hash/kwarg notation (`data = {x, y}` or `foo(x:, y:)`) ([#15236](https://bugs.ruby-lang.org/issues/15236)).
+See [Parser's known issues](https://github.com/whitequark/parser#known-issues).
 
 ## Contributing
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-next
 version: !ruby/object:Gem::Version
-  version: 0.13.3
+  version: 0.15.0
 platform: ruby
 authors:
 - Vladimir Dementyev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-12-09 00:00:00.000000000 Z
+date: 2022-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-next-core
@@ -16,34 +16,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.13.3
+        version: 0.15.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.13.3
+        version: 0.15.0
 - !ruby/object:Gem::Dependency
   name: ruby-next-parser
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0.3
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.1.0.0
+        version: 3.1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0.3
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.1.0.0
+        version: 3.1.1.0
 - !ruby/object:Gem::Dependency
   name: unparser
   requirement: !ruby/object:Gem::Requirement
@@ -58,20 +52,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.0
-- !ruby/object:Gem::Dependency
-  name: parser
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.3.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.3.0
 description: "\n    Ruby Next is a collection of polyfills and a transpiler for supporting
   latest and upcoming edge CRuby features\n    in older versions and alternative implementations
   (such as mruby, JRuby, Opal, Artichoke, RubyMotion, etc.).\n  "