rpr 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 733f4164bf9ff2410c5cdf227dca97bbc72fc8fecb32d4fbb66077f9115a462d
-  data.tar.gz: ef779720bbb0e94e58bed6b81ff3f2974bc7f822d10d30561920a33d222072c7
+  metadata.gz: d923de497b9fdd3e34eddd7abee262a84812bd7236e25bb7a5b304e2fdd78a08
+  data.tar.gz: 3dba086559d87976fc1ebf508efafcb676d997042e964890250cec3ef6990a62
 SHA512:
-  metadata.gz: a025a546328696653b114051ecbc05e776d79fff2524f92a27e9c58c28f2aa1a44fd4429af676b7fb80b93de605df6aaf38dcb314ee96105b738f08ab2d25523
-  data.tar.gz: f0ed9dfa384f9f9f1a94ab660f3115485a6014fd7505b2db96c2026db78a793bca40a53ab5f44219aac1373be81eda65359d1b0084d35e015f23e848b152a7fe
+  metadata.gz: 855dc01da970373f90a5f04345c9a721431c21ae1fbe063be8e5de4e4a0daae43144548208aa349a0b7e200069db88917d60c2871772156688af40a8a25fb94e
+  data.tar.gz: bd4b639388586ec71556215eaa81a4eda67b4719446983f0610fbf228d6fc7b5fd6ceaca220ff606dd4ec2b26d9906a15576a7d122c486eabbab7e36de60f65e

data/.travis.yml

@@ -1,10 +1,10 @@
 language: ruby
 
 rvm:
-  - 2.2.9
-  - 2.3.6
-  - 2.4.3
-  - 2.5.0
+  - 2.3.8
+  - 2.4.5
+  - 2.5.3
+  - 2.6.0
   - ruby-head
 matrix:
   allow_failures:

data/README.md

@@ -9,8 +9,14 @@ RPR displays Ruby's AST on command line.
 ## Support parsers
 
 - [Ripper](http://ruby-doc.org/stdlib-2.3.0/libdoc/ripper/rdoc/Ripper.html)
-- [RuboCop](https://github.com/bbatsov/rubocop)
+  - `sexp`
+  - `lex`
+  - `tokenize`
 - [Parser](https://github.com/whitequark/parser)
+- [RuboCop](https://github.com/bbatsov/rubocop)
+- [RubyParser](https://github.com/seattlerb/ruby_parser)
+- RubyVM::AbstractSyntaxTree (Since Ruby 2.6)
+- [MinRuby](https://github.com/mame/minruby)
 
 ## Installation
 
@@ -46,7 +52,10 @@ $ rpr hello.rb
 
 ### Specify Parser
 
-Default: `sexp`
+The default parser is `sexp`.
+You can find all supported parsers with `--help` option.
+
+For example:
 
 ```sh
 $ rpr hello.rb --parser rubocop
@@ -61,7 +70,10 @@ $ rpr hello.rb --method tokenize
 
 ### Specify output formatter
 
-Default: `pp`
+The default formatter is `pp`.
+You can find all supported formatters with `--help` option.
+
+For example:
 
 ```sh
 $ rpr hello.rb --formatter json
@@ -123,6 +135,15 @@ locals: _  __  _dir_  _ex_  _file_  _in_  _out_  _pry_
 [3] pry(#<Array>)> exit
 ```
 
+Print an AST as a PNG image with Graphviz.
+
+```sh
+$ rpr hello.rb -f dot | dot -Tpng -oast.png
+$ open ast.png
+```
+
+![ast](https://user-images.githubusercontent.com/4361134/50540867-63b51300-0bdd-11e9-9b0c-63aa70e980be.png)
+
 ### Configuration
 
 Rpr searches config file from `./.rpr` or `~/.config/rpr`. `./.rpr` is priority.

data/lib/rpr.rb

@@ -19,8 +19,8 @@ module Rpr
         puts VERSION
       end
 
-      formatter = find_formatter(options[:formatter])
       parser = find_parser(options[:parser])
+      formatter = find_formatter(options[:formatter])
 
       if options[:expression]
         res = parser.parse(options[:expression])

data/lib/rpr/formatter/dot.rb

@@ -0,0 +1,92 @@
+module Rpr
+  module Formatter
+    module UnifiedInterface
+      refine Object do
+        def node_value() inspect end
+        def traversable?() false end
+      end
+
+      if defined?(Rpr::Parser::Sexp)
+        refine Array do
+          def node_value() traversable? ? self[0].to_s : super end
+          def children
+            res = []
+            self[1..-1].each do |child|
+              if child.is_a?(Array) &&
+                 !child.traversable? &&
+                 !(child.size == 2 && child[0].is_a?(Integer) && child[1].is_a?(Integer))
+                res.concat(child)
+              else
+                res << child
+              end
+            end
+            res
+          end
+          def traversable?() self.first.is_a?(Symbol) end
+        end
+      end
+
+      if defined?(Rpr::Parser::Parser) || defined?(Rpr::Parser::Rubocop)
+        refine ::Parser::AST::Node do
+          def node_value() self.type.to_s end
+          def traversable?() true end
+        end
+      end
+
+      if defined?(Rpr::Parser::Rubyparser)
+        refine Sexp do
+          def node_value() self.sexp_type.to_s end
+          def children() self.each.to_a end
+          def traversable?() true end
+        end
+      end
+
+      if defined?(Rpr::Parser::Rubyvm_ast)
+        refine RubyVM::AbstractSyntaxTree::Node do
+          def node_value() self.type.to_s end
+          def traversable?() true end
+        end
+      end
+    end
+
+    # Formatter for Graphviz
+    class Dot
+      using UnifiedInterface
+
+      def self.print(object)
+        self.new.print(object)
+      end
+
+      def initialize
+        @id = :a
+      end
+
+      def print(object)
+        puts 'digraph{graph [dpi=288;];'
+        traverse_and_print(object)
+        puts "}"
+      end
+
+      private
+
+      def traverse_and_print(object, parent = 'ROOT')
+        label = object.node_value
+        shape = object.traversable? ? 'oval' : 'box'
+        id = gen_id()
+
+        puts "#{id} -> #{parent}"
+        puts "#{id}[ label=#{label.inspect} shape=#{shape} ]"
+
+        if object.traversable?
+          object.children.each do |child|
+            traverse_and_print(child, id)
+          end
+        end
+      end
+
+      def gen_id
+        @id = @id.succ
+      end
+    end
+  end
+end

data/lib/rpr/version.rb

@@ -1,3 +1,3 @@
 module Rpr
-  VERSION = "1.8.0"
+  VERSION = "1.9.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rpr
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Masataka Kuwabara
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-12-27 00:00:00.000000000 Z
+date: 2018-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -228,6 +228,7 @@ files:
 - exe/rpr
 - lib/rpr.rb
 - lib/rpr/config.rb
+- lib/rpr/formatter/dot.rb
 - lib/rpr/formatter/json.rb
 - lib/rpr/formatter/pp.rb
 - lib/rpr/formatter/pry.rb