ruby-next-core 0.5.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae8ccdf6dc524052fe864e962362b7da9dd6ce804d03b8cde765ed8010f8c9ea
-  data.tar.gz: ad015bedd5ca0a48e0f50f27f9b3c78235c3326e99a65d4f4ae1f9adac0aaa2b
+  metadata.gz: d3395d5a5cd7bbc3f2697682cd8d212c398ef0a76d19b60308f68d027c545300
+  data.tar.gz: aa20461bff07df85835508f8e498b88604c5d31988db06fe4793d2becda92055
 SHA512:
-  metadata.gz: 10eb9b82b0dd65188fe311d0a3bbe1950c148b6d94ed548a59d3b0ced0e41e077e1183315c3cbc2c351def0ee6ac16a2095f49cc425952ab6d276221766f8856
-  data.tar.gz: c65ff2bda5a24e47cd3ee13b80059c50dfdb05a9051c3ae782d8cfabdf9f32b0b936110751cdf65920ac00850e5448c04f606f7870d22c2b02d93692f24c0699
+  metadata.gz: d431025ce839f76a8d39436899b6d38e66ed8818f62a14bfad0e8367cdf29ed11439ed75a91bb9051f68488c70ffdc7622210ac0fe76e3385e7b945a4545113b
+  data.tar.gz: e3ff453d83653ebd4bfefe1bdb30e12e6ac39d25a80311accbfabe7fd0af1395b216c07e6e91a33cb05aa50e45dc6e246e9c118b59d09bf95bb75eb4f6f1a69a

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## master
 
+## 0.5.2 (2020-03-25)
+
+- Enhance logging. ([@palkan][])
+
+Use `RUBY_NEXT_WARN=false` to disable warnings.
+Use `RUBY_NEXT_DEBUG=path.rb` to display the transpiler output only for matching files
+in the runtime mode.
+
 ## 0.5.1 (2020-03-20)
 
 - Add RuboCop integration. ([@palkan][])

data/README.md

@@ -35,6 +35,7 @@ That's why Ruby Next implements the `master` features as fast as possible.
   - [Runtime usage](#runtime-usage)
   - [Bootsnap integration](#using-with-bootsnap)
   - [`ruby -ruby-next`](#uby-next)
+  - [Logging & Debugging](#logging-and-debugging)
 - [RuboCop](#rubocop)
 - [Proposed & edge features](#proposed-and-edge-features)
 
@@ -307,6 +308,16 @@ RUBYOPT="-ruby-next" ruby my_ruby_script.rb
 ruby -ruby-next -e "puts [2, 4, 5].tally"
 ```
 
+## Logging and debugging
+
+Ruby Next prints some debugging information when fails to load a file in the runtime mode (and fallbacks to the built-in loading mechanism).
+
+You can disable these warnings either by providing the `RUBY_NEXT_WARN=false` env variable or by setting `RubyNext.silence_warnings = true` in your code.
+
+You can also enable transpiled source code debugging by setting the `RUBY_NEXT_DEBUG=true` env variable. When it's set, Ruby Next prints the transpiled code before loading it.
+
+You can use a file pattern as the value for the env var to limit the output: for example, `RUBY_NEXT_DEBUG=my_script.rb`.
+
 ## RuboCop
 
 Since Ruby Next provides support for features not available in RuboCop yet, you need to add a patch for compatibility.

data/lib/ruby-next.rb

@@ -34,4 +34,5 @@ module RubyNext
   end
 
   require_relative "ruby-next/core"
+  require_relative "ruby-next/logging"
 end

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

@@ -17,7 +17,7 @@ if load_iseq.source_location[0].include?("/bootsnap/")
         return super unless RubyNext::Language.transformable?(path)
         source = RubyNext::Language.transform(source, rewriters: RubyNext::Language.current_rewriters)
 
-        $stdout.puts ::RubyNext::Utils.source_with_lines(source, path) if ENV["RUBY_NEXT_DEBUG"] == "1"
+        RubyNext.debug_source(source, path)
 
         RubyVM::InstructionSequence.compile(source, path, path).to_binary
       rescue SyntaxError

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

@@ -9,7 +9,7 @@ module RubyNext
             source,
             using: bind&.receiver == TOPLEVEL_BINDING.receiver || bind&.receiver&.is_a?(Module)
           )
-          $stdout.puts ::RubyNext::Utils.source_with_lines(new_source, "(#{caller_locations(1, 1).first})") if ENV["RUBY_NEXT_DEBUG"] == "1"
+          RubyNext.debug_source(new_source, "(#{caller_locations(1, 1).first})")
           super new_source, bind, *args
         end
       end
@@ -22,7 +22,7 @@ module RubyNext
 
           source = args.shift
           new_source = ::RubyNext::Language::Runtime.transform(source, using: false)
-          $stdout.puts ::RubyNext::Utils.source_with_lines(new_source, "(#{caller_locations(1, 1).first})") if ENV["RUBY_NEXT_DEBUG"] == "1"
+          RubyNext.debug_source(new_source, "(#{caller_locations(1, 1).first})")
           super new_source, *args
         end
       end
@@ -35,7 +35,7 @@ module RubyNext
 
           source = args.shift
           new_source = ::RubyNext::Language::Runtime.transform(source, using: false)
-          $stdout.puts ::RubyNext::Utils.source_with_lines(new_source, "(#{caller_locations(1, 1).first})") if ENV["RUBY_NEXT_DEBUG"] == "1"
+          RubyNext.debug_source(new_source, "(#{caller_locations(1, 1).first})")
           super new_source, *args
         end
 
@@ -44,7 +44,7 @@ module RubyNext
 
           source = args.shift
           new_source = ::RubyNext::Language::Runtime.transform(source, using: false)
-          $stdout.puts ::RubyNext::Utils.source_with_lines(new_source, "(#{caller_locations(1, 1).first})") if ENV["RUBY_NEXT_DEBUG"] == "1"
+          RubyNext.debug_source(new_source, "(#{caller_locations(1, 1).first})")
           super new_source, *args
         end
       end

data/lib/ruby-next/language/rewriters/base.rb

@@ -80,7 +80,7 @@ module RubyNext
           end
 
           def warn_custom_parser_required_for(feature)
-            warn(CUSTOM_PARSER_REQUIRED % feature)
+            RubyNext.warn(CUSTOM_PARSER_REQUIRED % feature)
           end
         end
 

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

@@ -24,7 +24,7 @@ module RubyNext
           contents = File.read(path)
           new_contents = transform contents
 
-          $stdout.puts source_with_lines(new_contents, path) if ENV["RUBY_NEXT_DEBUG"] == "1"
+          RubyNext.debug_source new_contents, path
 
           evaluate(new_contents, path)
           true
@@ -83,7 +83,7 @@ module Kernel
     true
   rescue => e
     $LOADED_FEATURES.delete realpath
-    warn "RubyNext failed to require '#{path}': #{e.message}"
+    RubyNext.warn "RubyNext failed to require '#{path}': #{e.message}"
     require_without_ruby_next(path)
   end
 
@@ -98,7 +98,7 @@ module Kernel
     )
     require(realpath)
   rescue => e
-    warn "RubyNext failed to require relative '#{path}' from #{from}: #{e.message}"
+    RubyNext.warn "RubyNext failed to require relative '#{path}' from #{from}: #{e.message}"
     require_relative_without_ruby_next(path)
   end
 
@@ -110,7 +110,7 @@ module Kernel
 
     RubyNext::Language::Runtime.load(realpath, wrap: wrap)
   rescue => e
-    warn "RubyNext failed to load '#{path}': #{e.message}"
+    RubyNext.warn "RubyNext failed to load '#{path}': #{e.message}"
     load_without_ruby_next(path)
   end
 end

data/lib/ruby-next/logging.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "utils"
+
+module RubyNext
+  class << self
+    attr_accessor :silence_warnings
+    attr_reader :debug_enabled
+
+    def warn(msg)
+      return if silence_warnings
+
+      Kernel.warn msg
+    end
+
+    def debug_source(source, filepath = nil)
+      return unless debug_enabled
+
+      return if debug_filter && !filepath.include?(debug_filter)
+
+      $stdout.puts Utils.source_with_lines(source, filepath)
+    end
+
+    def debug_enabled=(val)
+      return if val.nil?
+
+      @debug_enabled = !(val == "false" || val == "0")
+
+      return unless debug_enabled
+
+      return if val == "true" || val == "1"
+
+      @debug_filter = val
+    end
+
+    private
+
+    attr_reader :debug_filter
+  end
+
+  self.silence_warnings = ENV["RUBY_NEXT_WARN"] != "false"
+  self.debug_enabled = ENV["RUBY_NEXT_DEBUG"]
+end

data/lib/ruby-next/utils.rb

@@ -6,7 +6,9 @@ module RubyNext
 
     if $LOAD_PATH.respond_to?(:resolve_feature_path)
       def resolve_feature_path(feature)
-        $LOAD_PATH.resolve_feature_path(feature)&.last
+        catch(LoadError) do
+          $LOAD_PATH.resolve_feature_path(feature)&.last
+        end
       end
     else
       def resolve_feature_path(path)

data/lib/ruby-next/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-next-core
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.2
 platform: ruby
 authors:
 - Vladimir Dementyev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-20 00:00:00.000000000 Z
+date: 2020-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -95,6 +95,7 @@ files:
 - lib/ruby-next/language/runtime.rb
 - lib/ruby-next/language/setup.rb
 - lib/ruby-next/language/unparser.rb
+- lib/ruby-next/logging.rb
 - lib/ruby-next/rubocop.rb
 - lib/ruby-next/utils.rb
 - lib/ruby-next/version.rb