repper 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0889e10cd309dbdd42315e1049c2f7e10a9ab46b949b08c390614965aa2c1483'
-  data.tar.gz: 8ef2f61c38c6e23abcd933c1e3e462602c19d153824c7632114673b57b291ad5
+  metadata.gz: dc27c0c06fc2947ca6485a0cbf9a904e83b959f5e05e5ae98d9441600d24c988
+  data.tar.gz: 0a597629326934ec23073f9729fa19eaa9e7f56e8ec11cd4573911039d36f908
 SHA512:
-  metadata.gz: a78030f011bb7d74c0263b2e6353114bdd94c9bdd5ee05f36ec7712dd5ad719f23050cea5627fb51cfc8ebe8bdf8b7813ec2094ea163c0253c58996e1fa5997c
-  data.tar.gz: 28b9f8a9243497e1be1ae2243c81817e2dc566532b314b03b9aa3410a947a9eb50f16b79b9b33a8e76e189c63efbc98b173acf160f814ca9bff2e91deb1d839f
+  metadata.gz: 2041d9d7fc5f71e536c123f2274fe1353ba14d6c8b6fc01e63a1f45165618a94bd9268a9dd221eb8348f2c96a4ead548a383940ce986d5c8330ace7860c5f87b
+  data.tar.gz: bf2029e67d73116b47484304e20565c150179576d0645982c8433d3608cb8365e6f06860c9e820414c9d71d0abe9f239fb0b7ea97bd77a04b599ecfdac982d50

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 ## [Unreleased]
 
-## [1.0.0] - 2022-04-30
+## [1.1.1] - 2026-10-23
+
+### Fixed
+
+- correct indentation when using newer `regexp_parser` versions
+
+## [1.1.0] - 2022-05-29
+
+### Added
+
+- codemod capability and corresponding `exe/repper` executable
+- new format `Repper::Format::Extended`
+- `Regexp#original_inspect` when using `Regexp#inspect` override
+
+### Fixed
+
+- use the more appropriate `:inline` format when passing `format: nil | false`
+
+## [1.0.0] - 2022-05-09
 
 - Initial release

data/Gemfile

@@ -5,6 +5,8 @@ gemspec
 
 # gem 'regexp_parser', path: '../regexp_parser'
 
+gem "irb"
+gem "pry"
 gem "rake", "~> 13.0"
-
 gem "rspec", "~> 3.0"
+gem "simplecov-cobertura"

data/README.md

@@ -1,9 +1,12 @@
-<h1>
-  Repper
-  <img alt='Rapper necklace with dollar pendant' src='https://user-images.githubusercontent.com/10758879/167485870-5c49284d-a783-453e-8be0-a3597c2ef97c.png' height='46' align='right' />
-</h1>
+<img alt='Rapper necklace with dollar pendant' src='https://user-images.githubusercontent.com/10758879/167485870-5c49284d-a783-453e-8be0-a3597c2ef97c.png' height='64' align='right' />
 
-Repper is a regular expression pretty printer for Ruby.
+# Repper
+
+[![Gem Version](https://badge.fury.io/rb/repper.svg)](http://badge.fury.io/rb/repper)
+[![Build Status](https://github.com/jaynetics/repper/actions/workflows/main.yml/badge.svg)](https://github.com/jaynetics/repper/actions)
+[![Coverage](https://codecov.io/gh/jaynetics/repper/branch/main/graph/badge.svg?token=4C6EKINE4B)](https://codecov.io/gh/jaynetics/repper)
+
+Repper is a regular expression pretty printer and formatter for Ruby.
 
 ## Installation
 
@@ -11,20 +14,28 @@ Repper is a regular expression pretty printer for Ruby.
 
 ## Usage
 
-`repper` can be integrated into the REPL (e.g. IRB) through core extensions or used manually.
+`repper` can be integrated into the REPL (e.g. IRB) through core extensions for Regexp pretty-printing, integrated into editors to format Regexps, or called manually.
 
 There are also a few customization options.
 
-### Full REPL integration (recommended)
+### REPL integration
+
+#### Via Regexp#inspect (recommended)
 
 `require 'repper/core_ext/regexp'` in your `~/.irbrc` or `~/.pryrc` to override `Regexp#inspect` and automatically use `repper` to display Regexps:
 
-<img width="313" alt="screenshot1" src="https://user-images.githubusercontent.com/10758879/167497359-e5bb94db-1382-465b-903a-3e114721b7a6.png">
+<img width="475" alt="screenshot1" src="https://user-images.githubusercontent.com/10758879/167719748-60f4013a-c8d4-4a62-843a-d9f27057bcd3.png">
 
-### Extending Kernel#pp
+#### Via Kernel#pp
 
 Alternatively, `require 'repper/core_ext/kernel'` to make the `pp` command give nicer output for Regexps (which will look like above by default).
 
+### Editor integration
+
+Use [vscode-repper](https://github.com/jaynetics/vscode-repper) to format Regexps in VSCode.
+
+![vscode-repper](https://user-images.githubusercontent.com/10758879/170892739-e2f408f2-e239-4b13-8d28-c14fb7a9dbb9.gif)
+
 ### Using Repper manually
 
 ```ruby
@@ -36,11 +47,13 @@ Repper.render(/foo/) # returns the pretty print String
 
 #### Customizing the format
 
-The default format is the annotated, indented format shown above.
+Multiple formats are available out of the box:
 
-If you want to see the indented structure without annotations, use the `:structured` format.
-
-If you only want colorization you can use the `:inline` format.
+- `:annotated` is the default, verbose format, shown above
+- `:inline` adds only colorization and does not restructure the Regexp
+- `:structured` is like `:annotated`, just without annotations
+- `:x` (or `:extended`) returns a lightly formatted but equivalent Regexp
+  - this format is used for the repper executable and [vscode-repper](https://github.com/jaynetics/vscode-repper)
 
 You can change the format globally:
 
@@ -50,14 +63,14 @@ Repper.format = :structured
 
 Or pick a format on a case-by-case basis:
 
-<img width="445" alt="screenshot2" src="https://user-images.githubusercontent.com/10758879/167497599-105f39c7-91e0-4954-bce3-d04ad7266695.png">
+<img width="711" alt="screenshot2" src="https://user-images.githubusercontent.com/10758879/167719567-ae8ee42f-839e-4ce4-af56-a139044d3436.png">
 
 Or create your own format:
 
 ```ruby
 require 'csv'
 
-csv_format = ->(elements, _theme) { elements.map(&:text).to_csv }
+csv_format = ->(tokens, _theme) { tokens.map(&:text).to_csv }
 Repper.render(/re[\p{pe}\r]$/, format: csv_format)
 => "/,re,[,\\p{pe},\\r,],$,/\n"
 ```
@@ -69,7 +82,8 @@ The color theme can also be set globally or passed on call:
 ```ruby
 Repper.theme = :monokai # a nicer theme, if the terminal supports it
 ```
-<img width="316" alt="screenshot3" src="https://user-images.githubusercontent.com/10758879/167497895-0cdc017f-5c77-4b15-afaa-207f7eb887cc.png">
+
+<img width="478" alt="screenshot3" src="https://user-images.githubusercontent.com/10758879/167719807-9170ba92-48d1-4669-a05d-a72f962b961d.png">
 
 ```ruby
 Repper.call(/foo/, theme: nil) # render without colors

data/exe/repper

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative "../lib/repper"
+
+Repper::Command.call(ARGV)

data/lib/repper/codemod.rb

@@ -0,0 +1,70 @@
+module Repper
+  # Formatter for Ruby code containing Regexp literals.
+  # Takes Ruby code, finds included Regexps (both // and %r style),
+  # formats them, and returns the updated Ruby code.
+  module Codemod
+    module_function
+
+    def call(code)
+      formatted_code = code.dup
+
+      regexp_locations(code).reverse.each do |loc|
+        beg_idx = code[/\A(.*\n){#{loc.beg_line}}/].size + loc.beg_char
+        end_idx = code[/\A(.*\n){#{loc.end_line}}/].size + loc.end_char
+        range = beg_idx..end_idx
+
+        /\A(?<start>\/|%r.)(?<source>.*)(?<stop>[^a-z])(?<flags>[a-z]*)\z/m =~
+          code[range]
+
+        tokens = Tokenizer.call(source, delimiters: [start, stop], flags: flags)
+        formatted_regexp = Format::Extended.call(tokens, Theme::Plain)
+
+        # indent consistently by applying leading line indentation to all lines
+        lead_indentation = code.lines[loc.beg_line][/^ */]
+        formatted_regexp.gsub!("\n", "\n#{lead_indentation}")
+
+        formatted_code[range] = formatted_regexp
+      end
+
+      formatted_code
+    end
+
+    require 'ripper'
+
+    def regexp_locations(code)
+      embed_level = 0
+      beg_tokens = {}
+
+      Ripper.lex(code).each.with_object([]) do |token, acc|
+        case token[1]
+        when :on_regexp_beg
+          beg_tokens[embed_level] = token
+          # nested regexp literals are not supported a.t.m., so if we're
+          # in an embed, discard the location of the surrounding regexp.
+          beg_tokens[embed_level - 1] = nil
+        when :on_regexp_end
+          next unless beg_token = beg_tokens[embed_level]
+
+          acc << Location.new(
+            beg_line: beg_token[0][0] - 1, # note: using 0-indexed line values
+            beg_char: beg_token[0][1],
+            end_line: token[0][0] - 1,
+            end_char: token[0][1] + (token[2].length - 1), # lex includes flags
+          )
+        when :on_embexpr_beg # embedded expression a.k.a. interpolation (#{...})
+          embed_level += 1
+        when :on_embexpr_end
+          embed_level -= 1
+        when :on_const, :on_ident
+          # OK when embedded - Regexp::Parser will treat them as literals
+        else
+          # other embedded expressions are not supported
+          beg_tokens[embed_level - 1] = nil
+        end
+      end
+    end
+
+    Location = Struct.new(:beg_line, :beg_char, :end_line, :end_char,
+                          keyword_init: true)
+  end
+end

data/lib/repper/command.rb

@@ -0,0 +1,39 @@
+module Repper
+  # Service object for exe/repper. Formats Ruby code with Repper::Codemod.
+  module Command
+    module_function
+
+    PARSE_ERROR_EXIT_STATUS = 1
+
+    def call(argv)
+      if argv.count == 0
+        format_stdio
+      else
+        format_files(argv)
+      end
+    end
+
+    def format_stdio
+      input = STDIN.read
+      output = format(input)
+      print output
+    end
+
+    def format(string)
+      Codemod.call(string)
+    rescue Repper::Error => e
+      warn "Parsing failed: #{e.class} - #{e.message}"
+      exit PARSE_ERROR_EXIT_STATUS
+    end
+
+    def format_files(paths)
+      paths.grep(/\.rb\z/).each { |path| format_file(path) }
+    end
+
+    def format_file(path)
+      code = File.read(path)
+      formatted_code = format(code)
+      File.write(path, formatted_code)
+    end
+  end
+end

data/lib/repper/core_ext/regexp.rb

@@ -1,4 +1,6 @@
 require 'repper'
 require_relative 'regexp_ext'
 
+Regexp.alias_method :original_inspect, :inspect
+
 ::Regexp.prepend(Repper::RegexpExt)

data/lib/repper/core_ext/regexp_ext.rb

@@ -1,4 +1,4 @@
-# This extension does not include itself automatically,
+# This extension does not enable itself automatically,
 # require 'repper/core_ext/regexp' to do so.
 module Repper
   ALREADY_COLORED_MARK = :@__already_colored__

data/lib/repper/format/annotated.rb

@@ -1,7 +1,8 @@
 module Repper
   module Format
-    Annotated = ->(elements, theme) do
-      table = Tabulo::Table.new(elements.reject(&:whitespace?), **TABULO_STYLE)
+    # A structured and colorized format with annotations about token types.
+    Annotated = ->(tokens, theme) do
+      table = Tabulo::Table.new(tokens.reject(&:whitespace?), **TABULO_STYLE)
       table.add_column(
         :indented_text,
         styler: ->(_, string, cell) { theme.colorize(string, cell.source.type) }

data/lib/repper/format/extended.rb

@@ -0,0 +1,41 @@
+module Repper
+  module Format
+    # A lightly structured format that retains parsability
+    # and functional equivalence, for use in code.
+    Extended = ->(tokens, theme) do
+      run_types = %i[escape literal nonposixclass nonproperty
+                     posixclass property set type]
+      forms_run = ->(el){ run_types.include?(el.type) || el.subtype == :dot }
+      prev = nil
+
+      tokens.each.with_object(''.dup) do |tok, acc|
+        # drop existing x-mode whitespace, if any
+        if tok.whitespace?
+          next
+        # keep some tokens in line:
+        # - option switches and conditions for syntactic correctness
+        # - quantifiers and codepoint runs for conciseness
+        elsif tok.type == :quantifier ||
+              tok.subtype == :options_switch && tok.text == ')' ||
+              tok.subtype == :condition ||
+              prev && forms_run.call(prev) && forms_run.call(tok)
+          acc << theme.colorize(tok.inlined_text, tok.type)
+        # keep comments in line, too, but with padding
+        elsif tok.comment?
+          acc << " #{theme.colorize(tok.inlined_text, tok.type)}"
+        # render root start, as well as end of empty root, without linebreak
+        elsif tok.root? && (prev.nil? || prev.root?)
+          acc << theme.colorize(tok.text, tok.type)
+        # else, if root is not empty, ensure x-flag is present at end
+        elsif tok.root?
+          acc << "\n#{theme.colorize(tok.text.sub(/x?\z/, 'x'), tok.type)}"
+        # render other tokens on their own lines for an indented structure,
+        # e.g. groups, alternations, anchors, assertions, ...
+        else
+          acc << "\n#{theme.colorize(tok.indented_text, tok.type)}"
+        end
+        prev = tok
+      end
+    end
+  end
+end

data/lib/repper/format/inline.rb

@@ -1,7 +1,8 @@
 module Repper
   module Format
-    Inline = ->(elements, theme) do
-      elements.map { |el| theme.colorize(el.text, el.type) }.join
+    # A format that only adds color but does not change structure.
+    Inline = ->(tokens, theme) do
+      tokens.map { |tok| theme.colorize(tok.text, tok.type) }.join
     end
   end
 end

data/lib/repper/format/plain.rb

@@ -1,7 +1,8 @@
 module Repper
   module Format
-    Plain = ->(elements, *) do
-      elements.map(&:text).join
+    # A no-op format, equivalent to the original Regexp#inspect.
+    Plain = ->(tokens, *) do
+      tokens.map(&:text).join
     end
   end
 end

data/lib/repper/format/structured.rb

@@ -1,7 +1,8 @@
 module Repper
   module Format
-    Structured = ->(elements, theme) do
-      table = Tabulo::Table.new(elements.reject(&:whitespace?), **TABULO_STYLE)
+    # A structured format with colorization.
+    Structured = ->(tokens, theme) do
+      table = Tabulo::Table.new(tokens.reject(&:whitespace?), **TABULO_STYLE)
       table.add_column(
         :indented_text,
         styler: ->(_, string, cell) { theme.colorize(string, cell.source.type) }

data/lib/repper/format/tabulo_style.rb

@@ -3,8 +3,8 @@ require 'tabulo'
 module Repper
   module Format
     TABULO_STYLE = {
-      border:               :blank,
-      header_frequency:     nil,
+      border:               :blank, # i.e. don't draw borders
+      header_frequency:     nil, # i.e. omit column headers
       truncation_indicator: '…',
       wrap_body_cells_to:   1,
     }

data/lib/repper/format.rb

@@ -3,8 +3,9 @@ module Repper
     def self.cast(arg)
       case arg
       when ::Proc             then arg
+      when :x                 then Format::Extended
       when ::Symbol, ::String then Format.const_get(arg.capitalize) rescue nil
-      when false, nil         then Format::Plain
+      when false, nil         then Format::Inline
       end || raise(Repper::ArgumentError, "unknown format #{arg.inspect}")
     end
   end

data/lib/repper/token.rb

@@ -0,0 +1,43 @@
+module Repper
+  # A part of a Regexp. Generated by Repper::Tokenizer.
+  # `expression:` must be a Regexp::Expression::Base from regexp_parser.
+  Token = Struct.new(:expression, :text) do
+    def indented_text
+      "#{'  ' * expression.nesting_level}#{inlined_text}"
+    end
+
+    def inlined_text
+      if comment?
+        text.strip
+      else
+        text
+          .gsub(/(?<!\\) /, '\\ ')
+          .gsub(/[\n\r\t\v]/) { |ws| ws.inspect.delete(?") }
+      end
+    end
+
+    def comment?
+      subtype == :comment
+    end
+
+    def root?
+      subtype == :root
+    end
+
+    def whitespace?
+      subtype == :whitespace
+    end
+
+    def type
+      expression.type
+    end
+
+    def subtype
+      expression.token
+    end
+
+    def annotation
+      expression.human_name unless root?
+    end
+  end
+end

data/lib/repper/tokenizer.rb

@@ -0,0 +1,44 @@
+require 'regexp_parser'
+
+module Repper
+  # Uses Regexp::Parser to get the AST of a Regexp, and turns that AST
+  # into a flat Array of visual elements that match the Regexp notation.
+  module Tokenizer
+    module_function
+
+    def call(regexp, delimiters: ['/', '/'], flags: nil)
+      tree = Regexp::Parser.parse(regexp, options: flags =~ /x/ && Regexp::EXTENDED)
+      flatten(tree, delimiters: delimiters, flags: flags)
+    rescue ::Regexp::Parser::Error => e
+      raise e.extend(Repper::Error)
+    end
+
+    def flatten(exp, acc = [], delimiters: nil, flags: nil)
+      # Add opening entry.
+      exp.is?(:root) && acc << Token.new(exp, delimiters[0])
+
+      # Ignore nesting of invisible intermediate branches for better visuals.
+      if exp.is?(:sequence)
+        exp.each_expression(true) { |child| child.nesting_level -= 1 }
+      end
+
+      exp.parts.each do |part|
+        if part.instance_of?(::String)
+          acc << Token.new(exp, part)
+        else # part.is_a?(Regexp::Expression::Base)
+          flatten(part, acc)
+        end
+      end
+
+      exp.quantified? && flatten(exp.quantifier, acc)
+
+      # Add closing entry.
+      exp.is?(:root) && begin
+        flags ||= exp.options.keys.join
+        acc << Token.new(exp, "#{delimiters[1]}#{flags.chars.uniq.sort.join}")
+      end
+
+      acc
+    end
+  end
+end

data/lib/repper/version.rb

@@ -1,3 +1,3 @@
 module Repper
-  VERSION = "1.0.0"
+  VERSION = "1.1.1"
 end

data/lib/repper.rb

@@ -1,7 +1,9 @@
-require_relative "repper/element"
+require_relative "repper/codemod"
+require_relative "repper/command"
 require_relative "repper/errors"
 require_relative "repper/format"
-require_relative "repper/parser"
+require_relative "repper/token"
+require_relative "repper/tokenizer"
 require_relative "repper/theme"
 require_relative "repper/version"
 
@@ -14,18 +16,18 @@ module Repper
     end
 
     def render(regexp, format: self.format, theme: self.theme)
-      elements = Parser.call(regexp)
-      format   = Format.cast(format)
-      theme    = Theme.cast(theme)
-      format.call(elements, theme)
+      tokens = Tokenizer.call(regexp)
+      format = Format.cast(format)
+      theme  = Theme.cast(theme)
+      format.call(tokens, theme)
     end
 
-    def theme=(theme)
-      @theme = Theme.cast(theme)
+    def format=(arg)
+      @format = Format.cast(arg)
     end
 
-    def format=(format)
-      @format = Format.cast(format)
+    def theme=(arg)
+      @theme = Theme.cast(arg)
     end
   end
 

data/repper.gemspec

@@ -6,7 +6,7 @@ Gem::Specification.new do |spec|
   spec.authors = ["Janosch Müller"]
   spec.email = ["janosch84@gmail.com"]
 
-  spec.summary = "Regexp pretty printer for Ruby"
+  spec.summary = "Regexp pretty printer and formatter for Ruby"
   spec.homepage = "https://github.com/jaynetics/repper"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 2.7.0"
@@ -25,6 +25,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "rainbow", "~> 3.1"
-  spec.add_dependency "regexp_parser", "~> 2.4"
+  spec.add_dependency "regexp_parser", "~> 2.6"
   spec.add_dependency "tabulo", "~> 2.8"
 end

data/repper.svg

@@ -9,6 +9,8 @@
    id="svg5"
    inkscape:version="1.1.2 (b8e25be8, 2022-02-05)"
    sodipodi:docname="repper.svg"
+   inkscape:export-xdpi="32.537697"
+   inkscape:export-ydpi="32.537697"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns="http://www.w3.org/2000/svg"
@@ -24,16 +26,78 @@
      inkscape:document-units="mm"
      showgrid="false"
      inkscape:zoom="0.3"
-     inkscape:cx="395"
+     inkscape:cx="178.33333"
      inkscape:cy="400"
      inkscape:window-width="1383"
      inkscape:window-height="916"
-     inkscape:window-x="0"
-     inkscape:window-y="38"
+     inkscape:window-x="1512"
+     inkscape:window-y="496"
      inkscape:window-maximized="0"
      inkscape:current-layer="layer1" />
   <defs
      id="defs2">
+    <inkscape:path-effect
+       effect="skeletal"
+       id="path-effect92594"
+       is_visible="true"
+       lpeversion="1"
+       pattern="m 218.50956,-4.9822433 c -1.39261,-1.458531 -5.24307,-0.392108 -8.59476,2.3804213 -3.3517,2.77251917 -4.94168,6.2064186 -3.54907,7.6649479 1.39261,1.4585306 5.24306,0.3921075 8.59476,-2.3804211 3.35169,-2.77251913 4.94168,-6.206419 3.54907,-7.6649481 z"
+       copytype="single_stretched"
+       prop_scale="1"
+       scale_y_rel="false"
+       spacing="0"
+       normal_offset="0"
+       tang_offset="0"
+       prop_units="false"
+       vertical_pattern="false"
+       hide_knot="false"
+       fuse_tolerance="0" />
+    <inkscape:path-effect
+       effect="simplify"
+       id="path-effect92590"
+       is_visible="true"
+       lpeversion="1"
+       steps="1"
+       threshold="0.00221557"
+       smooth_angles="360"
+       helper_size="0"
+       simplify_individual_paths="false"
+       simplify_just_coalesce="false" />
+    <inkscape:path-effect
+       effect="skeletal"
+       id="path-effect92556"
+       is_visible="true"
+       lpeversion="1"
+       pattern="m -6.5579804,-4.9666732 c 1.392609,-1.4585305 5.243064,-0.3921075 8.59476,2.3804215 3.351699,2.77251918 4.941681,6.2064186 3.54907,7.6649479 -1.39261,1.4585306 -5.24306404,0.3921075 -8.594759,-2.3804211 -3.351699,-2.77251912 -4.941682,-6.206419 -3.549071,-7.6649483 z"
+       copytype="single_stretched"
+       prop_scale="1"
+       scale_y_rel="false"
+       spacing="0"
+       normal_offset="0"
+       tang_offset="0"
+       prop_units="false"
+       vertical_pattern="false"
+       hide_knot="false"
+       fuse_tolerance="0" />
+    <inkscape:path-effect
+       effect="simplify"
+       id="path-effect92552"
+       is_visible="true"
+       lpeversion="1"
+       steps="1"
+       threshold="0.00221557"
+       smooth_angles="360"
+       helper_size="0"
+       simplify_individual_paths="false"
+       simplify_just_coalesce="false" />
+    <linearGradient
+       id="linearGradient91990"
+       inkscape:swatch="solid">
+      <stop
+         style="stop-color:#e3cf00;stop-opacity:1;"
+         offset="0"
+         id="stop91988" />
+    </linearGradient>
     <inkscape:path-effect
        effect="skeletal"
        id="path-effect43053"
@@ -304,6 +368,60 @@
        vertical_pattern="false"
        hide_knot="false"
        fuse_tolerance="0" />
+    <inkscape:path-effect
+       effect="simplify"
+       id="path-effect29027-15"
+       is_visible="true"
+       lpeversion="1"
+       steps="1"
+       threshold="0.00221557"
+       smooth_angles="360"
+       helper_size="0"
+       simplify_individual_paths="false"
+       simplify_just_coalesce="false" />
+    <inkscape:path-effect
+       effect="skeletal"
+       id="path-effect29029-2"
+       is_visible="true"
+       lpeversion="1"
+       pattern="m 20.669672,46.003934 c 0.621589,-1.918412 4.553331,-2.628809 8.77621,-1.585706 4.222877,1.043101 7.145659,3.446649 6.524067,5.365061 -0.62159,1.918412 -4.553331,2.628807 -8.776209,1.585705 -4.222877,-1.043101 -7.14566,-3.446649 -6.524068,-5.36506 z"
+       copytype="single_stretched"
+       prop_scale="1"
+       scale_y_rel="false"
+       spacing="0"
+       normal_offset="0"
+       tang_offset="0"
+       prop_units="false"
+       vertical_pattern="false"
+       hide_knot="false"
+       fuse_tolerance="0" />
+    <inkscape:path-effect
+       effect="simplify"
+       id="path-effect92552-3"
+       is_visible="true"
+       lpeversion="1"
+       steps="1"
+       threshold="0.00221557"
+       smooth_angles="360"
+       helper_size="0"
+       simplify_individual_paths="false"
+       simplify_just_coalesce="false" />
+    <inkscape:path-effect
+       effect="skeletal"
+       id="path-effect92556-9"
+       is_visible="true"
+       lpeversion="1"
+       pattern="m -6.5579804,-4.9666732 c 1.392609,-1.4585305 5.243064,-0.3921075 8.59476,2.3804215 3.351699,2.77251918 4.941681,6.2064186 3.54907,7.6649479 -1.39261,1.4585306 -5.24306404,0.3921075 -8.594759,-2.3804211 -3.351699,-2.77251912 -4.941682,-6.206419 -3.549071,-7.6649483 z"
+       copytype="single_stretched"
+       prop_scale="1"
+       scale_y_rel="false"
+       spacing="0"
+       normal_offset="0"
+       tang_offset="0"
+       prop_units="false"
+       vertical_pattern="false"
+       hide_knot="false"
+       fuse_tolerance="0" />
   </defs>
   <g
      inkscape:label="Ebene 1"
@@ -311,136 +429,154 @@
      id="layer1">
     <text
        xml:space="preserve"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.264583"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="88.609558"
        y="142.00261"
-       id="text473"><tspan
+       id="text473"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674"><tspan
          sodipodi:role="line"
          id="tspan471"
-         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.264583"
+         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="88.609558"
          y="142.00261">$</tspan></text>
     <text
        xml:space="preserve"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.264583"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="26.48514"
        y="147.63461"
        id="text473-4"
        inkscape:transform-center-x="2.9956772"
        inkscape:transform-center-y="-2.5677233"><tspan
          id="tspan471-3"
-         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.264583"
+         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.8px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="26.48514"
          y="147.63461"
          sodipodi:role="line" /></text>
     <text
        xml:space="preserve"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.7622px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.222719"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.7622px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="84.480263"
        y="-73.830437"
        id="text473-1"
-       transform="matrix(-0.01039371,0.84174345,-1.1879195,-0.00736484,0,0)"><tspan
+       transform="matrix(-0.01039371,0.84174345,-1.1879195,-0.00736484,0,0)"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674"><tspan
          sodipodi:role="line"
          id="tspan471-8"
-         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.7622px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.222719"
+         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.7622px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="84.480263"
          y="-73.830437">0</tspan></text>
     <text
        xml:space="preserve"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:44.4055px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';white-space:pre;inline-size:40.7295;stroke-width:0.231278"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:44.4055px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';white-space:pre;inline-size:40.7295;fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.53487;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="18.91221"
        y="-47.323662"
        id="text473-1-5"
-       transform="matrix(-0.45969555,0.66650243,-0.97588205,-0.53512053,4.2333335,10.289189)"><tspan
+       transform="matrix(-0.45969555,0.66650243,-0.97588205,-0.53512053,4.2333335,10.289189)"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674"><tspan
          x="18.91221"
          y="-47.323662"
-         id="tspan84688">0</tspan></text>
+         id="tspan93379">0</tspan></text>
     <text
        xml:space="preserve"
-       style="font-size:10.5833px;line-height:1.25;font-family:'System Font';-inkscape-font-specification:'System Font';stroke-width:0.264583"
+       style="font-size:10.5833px;line-height:1.25;font-family:'System Font';-inkscape-font-specification:'System Font';fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="47.930836"
        y="84.734871"
        id="text18132"><tspan
          sodipodi:role="line"
          id="tspan18130"
-         style="stroke-width:0.264583"
+         style="fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="47.930836"
          y="84.734871" /></text>
     <text
        xml:space="preserve"
-       style="font-size:10.5833px;line-height:1.25;font-family:'System Font';-inkscape-font-specification:'System Font';stroke-width:0.264583"
+       style="font-size:10.5833px;line-height:1.25;font-family:'System Font';-inkscape-font-specification:'System Font';fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="35.948128"
        y="33.380402"
        id="text23204"><tspan
          sodipodi:role="line"
          id="tspan23202"
-         style="stroke-width:0.264583"
+         style="fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="35.948128"
          y="33.380402" /></text>
     <path
-       style="fill:#000000;stroke:none;stroke-width:0.284007px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 59.099047,70.776083 c 2.120975,-1.078377 10.77195,1.950654 20.22924,5.094731 -0.147517,-0.0492 1.418427,0.473496 1.27091,0.424299 9.989745,3.340154 17.614113,6.281378 15.582927,8.125798 -1.600508,1.453348 -9.549486,1.32287 -18.585399,-1.349413 0,0 -1e-6,0 -1e-6,0 C 76.147903,82.64138 74.690387,82.144385 73.237982,81.580972 62.456459,77.398636 57.08906,71.798024 59.099047,70.776083 Z"
+       style="fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 59.099139,70.776137 c 2.12787,-1.081793 10.854698,1.976966 20.364006,5.139528 -0.108589,-0.03622 1.244719,0.415606 1.13613,0.379383 9.989564,3.340372 17.61416,6.281333 15.582842,8.12586 -1.591933,1.445551 -9.462126,1.32328 -18.440304,-1.306619 0,-10e-7 -10e-7,-10e-7 -10e-7,-10e-7 C 76.245556,82.674336 74.739206,82.162967 73.238054,81.580609 62.45744,77.398376 57.087976,71.798591 59.099139,70.776137 Z"
        id="path29025"
        inkscape:path-effect="#path-effect29027;#path-effect29029"
        inkscape:original-d="m 58.148912,72.423541 c 13.62864,5.908708 23.245218,8.103634 38.499876,10.153486"
-       sodipodi:nodetypes="cc" />
+       sodipodi:nodetypes="cc"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674" />
     <text
        xml:space="preserve"
-       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.0429px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.218973"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.0429px;line-height:1;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="146.16597"
        y="96.452888"
        id="text473-1-5-0"
-       transform="matrix(0.4855282,0.70395662,1.0307219,-0.5651917,0,0)"><tspan
+       transform="matrix(0.4855282,0.70395662,1.0307219,-0.5651917,0,0)"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674"><tspan
          sodipodi:role="line"
          id="tspan471-8-6-1"
-         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.0429px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';stroke-width:0.218973"
+         style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:42.0429px;font-family:Thonburi;-inkscape-font-specification:'Thonburi Bold';fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="146.16597"
          y="96.452888">0</tspan></text>
     <path
-       style="fill:#000000;stroke:none;stroke-width:0.28963px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 115.94486,85.097149 c 1.62878,1.516174 9.67995,1.368939 18.78066,-1.453697 0,0 0,-10e-7 0,-10e-7 1.41436,-0.440526 2.83487,-0.946725 4.24854,-1.517955 10.78635,-4.358484 16.03105,-10.152634 13.97777,-11.206085 -2.16623,-1.111417 -10.64635,1.973884 -20.10584,5.251398 0.20166,-0.07012 -1.57428,0.547897 -1.37261,0.477773 -9.95865,3.471655 -17.58664,6.532745 -15.52852,8.448567 z"
+       style="fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 115.94486,85.097146 c 1.62012,1.508092 9.59184,1.369553 18.63551,-1.408796 0,0 0,0 0,0 1.46199,-0.451029 2.93133,-0.972313 4.39362,-1.563218 10.78546,-4.358378 16.03219,-10.151702 13.97774,-11.205664 -2.17642,-1.116557 -10.72491,1.99989 -20.23992,5.297849 0.14949,-0.05199 -1.38801,0.483186 -1.23853,0.431194 -9.95842,3.471909 -17.58669,6.532679 -15.52842,8.448635 z"
        id="path29025-0"
        sodipodi:nodetypes="cc"
        inkscape:original-d="m 153.95732,72.621585 c -13.62872,6.144952 -23.24535,8.427629 -38.50001,10.55943"
-       inkscape:path-effect="#path-effect43049;#path-effect43053" />
+       inkscape:path-effect="#path-effect43049;#path-effect43053"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674" />
     <text
        xml:space="preserve"
-       style="font-size:10.5833px;line-height:1.25;font-family:'System Font';-inkscape-font-specification:'System Font';stroke-width:0.264583"
+       style="font-size:10.5833px;line-height:1.25;font-family:'System Font';-inkscape-font-specification:'System Font';fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="67.616714"
        y="123.67867"
        id="text30077"><tspan
          sodipodi:role="line"
          id="tspan30075"
-         style="stroke-width:0.264583"
+         style="fill:#e9c915;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="67.616714"
          y="123.67867" /></text>
     <rect
        id="rect66881"
-       width="6.5312495"
-       height="16.90856"
-       x="102.88905"
-       y="91.982559"
-       style="stroke-width:0.274066" />
+       width="7.2900386"
+       height="11.079004"
+       x="102.50966"
+       y="87.608177"
+       style="fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:#000000;stroke-width:2.05246;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674" />
     <text
        xml:space="preserve"
-       style="font-size:31.75px;line-height:1.25;font-family:Arial;-inkscape-font-specification:Arial;stroke-width:0.264583;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:31.75px;line-height:1.25;font-family:Arial;-inkscape-font-specification:Arial;fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="72.62812"
        y="153.12755"
-       id="text75927"><tspan
+       id="text75927"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674"><tspan
          sodipodi:role="line"
          id="tspan75925"
-         style="font-size:31.75px;stroke-width:0.264583;-inkscape-font-specification:Arial;font-family:Arial;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:31.75px;font-family:Arial;-inkscape-font-specification:Arial;fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="72.62812"
          y="153.12755">*</tspan></text>
     <text
        xml:space="preserve"
-       style="font-size:31.75px;line-height:1.25;font-family:Arial;-inkscape-font-specification:Arial;stroke-width:0.264583;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:31.75px;line-height:1.25;font-family:Arial;-inkscape-font-specification:Arial;fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        x="124.74483"
        y="125.85077"
-       id="text75927-8"><tspan
+       id="text75927-8"
+       inkscape:export-xdpi="32.30674"
+       inkscape:export-ydpi="32.30674"><tspan
          sodipodi:role="line"
          id="tspan75925-9"
-         style="font-size:31.75px;stroke-width:0.264583;-inkscape-font-specification:Arial;font-family:Arial;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:31.75px;font-family:Arial;-inkscape-font-specification:Arial;fill:#efc30f;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2.4;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
          x="124.74483"
          y="125.85077">*</tspan></text>
   </g>

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: repper
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Janosch Müller
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-05-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -30,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '2.6'
 - !ruby/object:Gem::Dependency
   name: tabulo
   requirement: !ruby/object:Gem::Requirement
@@ -52,10 +51,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.8'
-description:
 email:
 - janosch84@gmail.com
-executables: []
+executables:
+- repper
 extensions: []
 extra_rdoc_files: []
 files:
@@ -65,24 +64,28 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- exe/repper
 - lib/repper.rb
+- lib/repper/codemod.rb
+- lib/repper/command.rb
 - lib/repper/core_ext/kernel.rb
 - lib/repper/core_ext/kernel_ext.rb
 - lib/repper/core_ext/regexp.rb
 - lib/repper/core_ext/regexp_ext.rb
-- lib/repper/element.rb
 - lib/repper/errors.rb
 - lib/repper/format.rb
 - lib/repper/format/annotated.rb
+- lib/repper/format/extended.rb
 - lib/repper/format/inline.rb
 - lib/repper/format/plain.rb
 - lib/repper/format/structured.rb
 - lib/repper/format/tabulo_style.rb
-- lib/repper/parser.rb
 - lib/repper/theme.rb
 - lib/repper/theme/default.rb
 - lib/repper/theme/monokai.rb
 - lib/repper/theme/plain.rb
+- lib/repper/token.rb
+- lib/repper/tokenizer.rb
 - lib/repper/version.rb
 - repper.gemspec
 - repper.svg
@@ -94,7 +97,6 @@ metadata:
   homepage_uri: https://github.com/jaynetics/repper
   source_code_uri: https://github.com/jaynetics/repper
   changelog_uri: https://github.com/jaynetics/repper/tree/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -109,8 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.0.dev
-signing_key:
+rubygems_version: 4.0.23
 specification_version: 4
-summary: Regexp pretty printer for Ruby
+summary: Regexp pretty printer and formatter for Ruby
 test_files: []

data/lib/repper/element.rb

@@ -1,31 +0,0 @@
-module Repper
-  Element = Struct.new(:type, :subtype, :level, :text, :id, keyword_init: true) do
-    def indented_text
-      inlined_text = text.gsub(/[\n\r\t\v]/) { |ws| ws.inspect.delete(?") }
-      "#{'  ' * level}#{inlined_text}"
-    end
-
-    def whitespace?
-      subtype == :whitespace
-    end
-
-    def annotation
-      case [type, subtype]
-      in [_, :root]
-        nil
-      in [_, :alternation | :comment | :condition | :intersection | :range => subtype]
-        subtype
-      in [:conditional | :free_space => type, _]
-        type
-      in [:group, :capture | :named]
-        "capture group #{id}"
-      in [:meta, :dot]
-        'match-all'
-      in [:keep, :mark]
-        'keep-mark lookbehind'
-      in [type, subtype]
-        [subtype, type].uniq.join(' ')
-      end.to_s.tr('_', ' ')
-    end
-  end
-end

data/lib/repper/parser.rb

@@ -1,49 +0,0 @@
-require 'regexp_parser'
-
-module Repper
-  module Parser
-    module_function
-
-    def call(regexp)
-      tree = ::Regexp::Parser.parse(regexp)
-      flatten(tree)
-    rescue ::Regexp::Parser::Error => e
-      raise e.extend(Repper::Error)
-    end
-
-    # Turn Regexp::Parser AST back into a flat Array of visual elements
-    # that match the Regexp notation.
-    def flatten(exp, acc = [])
-      # Add opening entry.
-      exp.is?(:root) && acc << make_element(exp, '/')
-
-      # Ignore nesting of invisible intermediate branches for better visuals.
-      exp.is?(:sequence) && exp.nesting_level -= 1
-
-      exp.parts.each do |part|
-        if part.instance_of?(::String)
-          acc << make_element(exp, part)
-        else # part.is_a?(Regexp::Expression::Base)
-          flatten(part, acc)
-        end
-      end
-
-      exp.quantified? && flatten(exp.quantifier, acc)
-
-      # Add closing entry.
-      exp.is?(:root) && acc << make_element(exp, "/#{exp.options.keys.join}")
-
-      acc
-    end
-
-    def make_element(exp, text)
-      Element.new(
-        type:    exp.type,
-        subtype: exp.token,
-        level:   exp.nesting_level,
-        text:    text,
-        id:      exp.respond_to?(:identifier) && exp.identifier,
-      )
-    end
-  end
-end