ruby-next-core 0.5.3 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9779cf5c0dea7fff2e3185f6409a7ea21287d4d4b38466e7393c2cebb97d128a
-  data.tar.gz: b1ef29ce986cbaa595e3a5e257674869d3e7d5842185385728d5f70eb81996fc
+  metadata.gz: 5447b309915122d9f6dc9a366c34a566891c9f9cc569722c0999e020ef891d6b
+  data.tar.gz: 9c2da837b1c9e4d2d36ea8665a90f7d3c004d6175b1d0e82262396846ac00f6a
 SHA512:
-  metadata.gz: 26de1a278bceaa3423b21e4f7b1c6c791e9fe3e42d319864fd0041d29f86b5946095ea42e03811169aa41be1220e4726ec57a24f19f939ec8fb197662505f2f1
-  data.tar.gz: 9ef7af94930ac374f7732e1ff71b57b4ee135be8609e0343314117f362af994c177dfa2541cfcc0802029320341e3c509b11ef8a2fdf0ab0e5d80451e902d803
+  metadata.gz: 7644e4703b233a730a3af183efaae78ea53cf5915ea70cc297ab8ebc8ff9346aad233c642cbf1d38ec82dc49deeab266e20ed35667e6c4069a7bb2f16b6c4e16
+  data.tar.gz: 42fe6bf61bfd0cc97c1107455b873d97065eeb3f8c0c6ae3d7921b1fa208c155114e0e6012045d335fa31f1591093fabb58a3a2f1828c9fe668c2e798335ee80

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## master
 
+## 0.6.0 (2020-04-23)
+
+- Changed the way edge/proposed features are activated. ([@palkan][])
+
+Use `--edge` or `--proposed` flags for `ruby-next nextify` or
+`require "ruby-next/language/{edge,proposed}"` in your code.
+
+See more in the [Readme](./README.md#proposed-and-edge-features).
+
+- Updated RuboCop integration. ([@palkan][])
+
+Make sure you use `TargetRubyVersion: next` in your RuboCop configuration.
+
+- Upgraded to `ruby-next-parser` for edge features. ([@palkan][])
+
+It's no longer needed to use Parser gem from Ruby Next package registry.
+
 ## 0.5.3 (2020-03-25)
 
 - Enhance logging. ([@palkan][])

data/README.md

@@ -27,6 +27,7 @@ That's why Ruby Next implements the `master` features as fast as possible.
 ## Table of contents
 
 - [Overview](#overview)
+- [Quick Start](#quick-start)
 - [Polyfills](#using-only-polyfills)
 - [Transpiling](#transpiling)
   - [Modes](#transpiler-modes)
@@ -51,6 +52,27 @@ programmatically or via CLI. It also could be done in runtime.
 Currently, Ruby Next supports Ruby versions 2.5+ (including JRuby 9.2.8+).
 Please, [open an issue](https://github.com/ruby-next/ruby-next/issues/new/choose) if you would like us to support older Ruby versions.
 
+## Quick start
+
+The quickest way to start experimenting with Ruby Next is to install the gem and run a sample script. For example:
+
+```sh
+# Install Ruby Next globally
+$ gem install ruby-next
+
+# Call ruby with -ruby-next flag
+$ ruby -ruby-next -e "
+ case {hello: 'martian'}
+ in hello: hello if hello =~ /human/
+   puts '🙂'
+ in hello: 'martian'
+   puts '👽'
+ end
+"
+
+=> 👽
+```
+
 ## Using only polyfills
 
 First, install a gem:
@@ -79,7 +101,7 @@ using RubyNext
 
 Ruby Next only refines core classes if necessary; thus, this line wouldn't have any effect in the edge Ruby.
 
-**NOTE:** Even if the runtime already contains a monkey-patch with the backported functionality, we consider the method as _dirty_ and activate the refinement for it. Thus, you always have a predictable behaviour. That's why we recommend using refinements for gems development.
+**NOTE:** Even if the runtime already contains a monkey-patch with the backported functionality, we consider the method as _dirty_ and activate the refinement for it. Thus, you always have predictable behaviour. That's why we recommend using refinements for gems development.
 
 Alternatively, you can go with monkey-patches. Just add this line:
 
@@ -124,7 +146,7 @@ gem install ruby-next
 
 Ruby Next currently provides two different modes of generating transpiled code: _AST_ and _rewrite_.
 
-In the AST mode, we parse the source code into AST, modifies this AST and **generate a new code from AST** (using [unparser][unparser]). Thus, the transpiled code being identical in terms of functionality has a different formatting.
+In the AST mode, we parse the source code into AST, modifies this AST and **generate a new code from AST** (using [unparser][unparser]). Thus, the transpiled code being identical in terms of functionality has different formatting.
 
 In the rewrite mode, we apply changes to the source code itself, thus, keeping the original formatting of the unaffected code (in a similar way to RuboCop's autocorrect feature).
 
@@ -292,10 +314,12 @@ To enable this integration, add the following line after the `require "bootsnap/
 require "ruby-next/language/bootsnap"
 ```
 
-**NOTE:** there is no way to invalidate the cache when you upgrade Ruby Next (e.g., due to the bug fixes), so you should do this manually.
+**NOTE:** There is no way to invalidate the cache when you upgrade Ruby Next (e.g., due to the bug fixes), so you should do this manually.
 
 ## `uby-next`
 
+_This is [not a typo](https://github.com/ruby-next/ruby-next/pull/8), that’s the way `ruby -ruby-next` works: it’s equal to `ruby -r uby-next`, and [`uby-next.rb`](https://github.com/ruby-next/ruby-next/blob/master/lib/uby-next.rb) is a special file that activates the runtime mode._
+
 You can also enable runtime mode by requiring `uby-next` while running a Ruby executable:
 
 ```sh
@@ -328,7 +352,7 @@ require:
   - ruby-next/rubocop
 ```
 
-**NOTE:** You should use `TargetRubyVersion: 2.7`.
+You must set `TargetRubyVersion: next` to make RuboCop use a Ruby Next parser.
 
 Alternatively, you can load the patch from the command line by running: `rubocop -r ruby-next/rubocop ...`.
 
@@ -349,48 +373,33 @@ This includes:
 - Features proposed in [Ruby bug tracker](https://bugs.ruby-lang.org/) (_proposed_)
 - Features once merged to master but got reverted.
 
-These features require a [custom parser](#using-ruby-next-parser).
+These features are disabled by default, you must opt-in in one of the following ways:
 
-Currently, the only such feature is the [_method reference_ operator](https://bugs.ruby-lang.org/issues/13581):
+- Add `--edge` or `--proposed` option to `nextify` command when using CLI.
+- Enable programmatically when using a runtime mode:
 
-- Add `--enable-method-reference` option to `nextify` command when using CLI.
-- OR add it programmatically when using a runtime mode (see [example](https://github.com/ruby-next/ruby-next/blob/master/default.mspec)).
-- OR set `RUBY_NEXT_ENABLE_METHOD_REFERENCE=1` environment variable (works with CLI as well).
-
-### Prerequisites
-
-Our own version of [parser][next_parser] gem is hosted on Github Package Registry. That makes the installation process a bit more complicated than usual.
-
-You must obtain an access token to use it. See the [GPR docs](https://help.github.com/en/github/managing-packages-with-github-package-registry/configuring-rubygems-for-use-with-github-package-registry#authenticating-to-github-package-registry).
-
-### Installing with Bundler
+```ruby
+# It's important to load language module first
+require "ruby-next/language"
 
-First, configure your bundler to access GPR:
+require "ruby-next/language/edge"
+# or
+require "ruby-next/language/proposed"
 
-```sh
-bundle config --local https://rubygems.pkg.github.com/ruby-next USERNAME:ACCESS_TOKEN
+# and then activate the runtime mode
+require "ruby-next/language/runtime"
+# or require "ruby-next/language/bootsnap"
 ```
 
-Then, add to your Gemfile:
-
-```ruby
-source "https://rubygems.pkg.github.com/ruby-next" do
-  gem "parser", "~> 2.7.0.100", "< 2.7.1"
-end
-
-gem "ruby-next"
-```
+- Set `RUBY_NEXT_EDGE=1` or `RUBY_NEXT_PROPOSED=1` environment variable.
 
-**NOTE:** we don't add `parser` and `unparser` to the gem's runtime deps, 'cause they're not necessary if you only need polyfills.
+### Supported edge features
 
-### Installing globally via `gem`
+Not yet.
 
-You can install `ruby-next` globally by running the following commands:
+### Supported proposed features
 
-```sh
-gem install parser -v "~> 2.7.0.100" -v "< 2.7.1" --source "https://USERNAME:ACCESS_TOKEN@rubygems.pkg.github.com/ruby-next"
-gem install ruby-next
-```
+- _Method reference_ operator (`.:`) ([link](https://bugs.ruby-lang.org/issues/13581)).
 
 ## Contributing
 

data/lib/ruby-next/cli.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "ruby-next"
-require "ruby-next/language"
 
 require "ruby-next/commands/base"
 require "ruby-next/commands/nextify"

data/lib/ruby-next/commands/nextify.rb

@@ -3,6 +3,8 @@
 require "fileutils"
 require "pathname"
 
+require "ruby-next/language"
+
 module RubyNext
   module Commands
     class Nextify < Base
@@ -38,9 +40,12 @@ module RubyNext
             @single_version = true
           end
 
-          opts.on("--enable-method-reference", "Enable reverted method reference syntax (requires custom parser)") do
-            require "ruby-next/language/rewriters/method_reference"
-            Language.rewriters << Language::Rewriters::MethodReference
+          opts.on("--edge", "Enable edge (master) Ruby features") do |val|
+            require "ruby-next/language/edge"
+          end
+
+          opts.on("--proposed", "Enable proposed/experimental Ruby features") do |val|
+            require "ruby-next/language/proposed"
           end
 
           opts.on(

data/lib/ruby-next/language/edge.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+# Load edge Ruby features

data/lib/ruby-next/language/parser.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "parser/ruby27"
+require "parser/rubynext"
 
 module RubyNext
   module Language
@@ -10,7 +10,7 @@ module RubyNext
 
     class << self
       def parser
-        ::Parser::Ruby27.new(Builder.new).tap do |prs|
+        ::Parser::RubyNext.new(Builder.new).tap do |prs|
           prs.diagnostics.tap do |diagnostics|
             diagnostics.all_errors_are_fatal = true
           end

data/lib/ruby-next/language/proposed.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# Load experimental, proposed etc. Ruby features
+
+require "ruby-next/language/rewriters/method_reference"
+RubyNext::Language.rewriters << RubyNext::Language::Rewriters::MethodReference

data/lib/ruby-next/language.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-gem "parser", ">= 2.7.0.0"
+gem "ruby-next-parser", ">= 2.8.0.0"
 gem "unparser", ">= 0.4.7"
 
 require "set"
@@ -166,9 +166,12 @@ module RubyNext
     require "ruby-next/language/rewriters/endless_range"
     rewriters << Rewriters::EndlessRange
 
-    if ENV["RUBY_NEXT_ENABLE_METHOD_REFERENCE"] == "1"
-      require "ruby-next/language/rewriters/method_reference"
-      RubyNext::Language.rewriters << RubyNext::Language::Rewriters::MethodReference
+    if ENV["RUBY_NEXT_EDGE"] == "1"
+      require "ruby-next/language/edge"
+    end
+
+    if ENV["RUBY_NEXT_PROPOSED"] == "1"
+      require "ruby-next/language/proposed"
     end
   end
 end

data/lib/ruby-next/rubocop.rb

@@ -1,7 +1,50 @@
 # frozen_string_literal: true
 
 # This file contains patches to RuboCop to support
-# edge features and fix some bugs with 2.7 syntax
+# edge features and fix some bugs with 2.7+ syntax
+
+require "parser/ruby-next/version"
+
+module RuboCop
+  # Transform Ruby Next parser version to a float, e.g.: "2.8.0.1" => 2.801
+  RUBY_NEXT_VERSION = Parser::NEXT_VERSION.match(/(^\d+)\.(.+)$/)[1..-1].map { |part| part.delete(".") }.join(".").to_f
+
+  class TargetRuby
+    class RuboCopNextConfig < RuboCopConfig
+      private
+
+      def find_version
+        version = @config.for_all_cops["TargetRubyVersion"]
+        return unless version == "next"
+
+        RUBY_NEXT_VERSION
+      end
+    end
+
+    new_rubies = KNOWN_RUBIES + [RUBY_NEXT_VERSION]
+    remove_const :KNOWN_RUBIES
+    const_set :KNOWN_RUBIES, new_rubies
+
+    new_sources = [RuboCopNextConfig] + SOURCES
+    remove_const :SOURCES
+    const_set :SOURCES, new_sources
+  end
+end
+
+module RuboCop
+  class ProcessedSource
+    module ParserClassExt
+      def parser_class(version)
+        return super unless version == RUBY_NEXT_VERSION
+
+        require "parser/rubynext"
+        Parser::RubyNext
+      end
+    end
+
+    prepend ParserClassExt
+  end
+end
 
 module RuboCop
   module AST

data/lib/ruby-next/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyNext
-  VERSION = "0.5.3"
+  VERSION = "0.6.0"
 end

data/lib/uby-next.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+# Activate all features
+ENV["RUBY_NEXT_EDGE"] = "1"
+ENV["RUBY_NEXT_PROPOSED"] = "1"
+
 require "ruby-next/language/runtime"
 require "ruby-next/core/runtime"
 

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: ruby-next-core
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.6.0
 platform: ruby
 authors:
 - Vladimir Dementyev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-25 00:00:00.000000000 Z
+date: 2020-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: parser
+  name: ruby-next-parser
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.0.5
+        version: 2.8.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.0.5
+        version: 2.8.0.0
 - !ruby/object:Gem::Dependency
   name: unparser
   requirement: !ruby/object:Gem::Requirement
@@ -84,8 +84,10 @@ files:
 - lib/ruby-next/core_ext.rb
 - lib/ruby-next/language.rb
 - lib/ruby-next/language/bootsnap.rb
+- lib/ruby-next/language/edge.rb
 - lib/ruby-next/language/eval.rb
 - lib/ruby-next/language/parser.rb
+- lib/ruby-next/language/proposed.rb
 - lib/ruby-next/language/rewriters/args_forward.rb
 - lib/ruby-next/language/rewriters/base.rb
 - lib/ruby-next/language/rewriters/endless_range.rb