@appthreat/atom-parsetools 1.3.0 → 1.4.0

package/plugins/rubyastgen/bundle/ruby/4.0.0/gems/racc-1.8.1/README.ja.rdoc

@@ -1,58 +0,0 @@
-= Racc
-
-* https://github.com/ruby/racc
-
-== DESCRIPTION:
-
-  Racc は LALR(1) パーサジェネレータです。
-  yacc の Ruby 版に相当します。
-
-== 必要環境
-
-  *  Ruby 2.5 以降
-
-== インストール
-
-  gem インストール:
-
-    $ gem install racc
-
-== テスト
-
-  sample/ 以下にいくつか Racc の文法ファイルのサンプルが用意
-  してあります。動くのも動かないのもありますが、少なくとも
-  calc-ja.y は動くのでこれを処理してみましょう。Racc をインス
-  トールしたあと
-
-      $ racc -ocalc.rb calc-ja.y
-
-  として下さい。処理は一瞬から数秒で終わるので、
-
-      $ ruby calc.rb
-
-  を実行してください。ちゃんと動いてますか？
-
-  Racc の文法など詳しいことは doc.ja/ ディレクトリ以下の HTML を
-  見てください。
-
-
-== ライセンス
-
-  このパッケージに付属するファイルの著作権は青木峰郎が保持します。
-  ライセンスは Ruby ライセンスです。ただしユーザが書いた規則
-  ファイルや、Racc がそこから生成した Ruby スクリプトはその対象
-  外です。好きなライセンスで配布してください。
-
-
-== バグなど
-
-  Racc を使っていてバグらしき現象に遭遇したら、下記のアドレスまで
-  メールをください。作者にはバグを修正する義務はありませんがその
-  意思はあります。また、そのときはできるだけバグを再現できる文法
-  ファイルを付けてください。
-
-
-                                         青木峰郎(あおきみねろう)
-                                              aamine@loveruby.net
-                                            http://i.loveruby.net
-

package/plugins/rubyastgen/bundle/ruby/4.0.0/gems/racc-1.8.1/README.rdoc

@@ -1,60 +0,0 @@
-= Racc
-
-* https://github.com/ruby/racc
-
-== DESCRIPTION:
-
-  Racc is an LALR(1) parser generator.
-  It is written in Ruby itself, and generates Ruby program.
-
-== Requirement
-
-  *  Ruby 2.5 or later.
-
-== Installation
-
-  gem install:
-
-    $ gem install racc
-
-== Testing Racc
-
-  Racc comes with simple calculator. To compile this, on shell:
-
-      $ racc -o calc calc.y
-
-  This process costs few seconds (or less). Then type:
-
-      $ ruby calc
-
-  ... Does it work?
-  For details of Racc, see HTML documents placed under 'doc/en/'
-  and sample grammar files under 'sample/'.
-
-== Release flow
-
-* Update VERSION number of these files
-  * <code>RACC_VERSION</code> in "ext/racc/com/headius/racc/Cparse.java"
-  * <code>VERSION</code> in "lib/racc/info.rb"
-* Release as a gem by <code>rake release</code> with CRuby and JRuby because Racc gem provides 2 packages
-* Create new release on {GitHub}[https://github.com/ruby/racc/releases]
-
-== License
-
-  Racc is distributed under the same terms of ruby.
-  (see the file COPYING). Note that you do NOT need to follow
-  ruby license for your own parser (racc outputs).
-  You can distribute those files under any licenses you want.
-
-
-== Bug Reports
-
-  Any kind of bug report is welcome.
-  If you find a bug of Racc, please report an issue at 
-  https://github.com/ruby/racc/issues. Your grammar file,
-  debug output generated by "racc -g", are helpful.
-
-
-                                                      Minero Aoki
-                                              aamine@loveruby.net
-                                            http://i.loveruby.net

package/plugins/rubyastgen/bundle/ruby/4.0.0/gems/racc-1.8.1/TODO

@@ -1,5 +0,0 @@
-* check 'error' token handling.
-* interactive transition table monitor.
-* support backtracking.
-* output Ruby extension library?
-* LL(k)? (But it should not be called Racc)

package/plugins/rubyastgen/bundle/ruby/4.0.0/gems/racc-1.8.1/bin/racc

@@ -1,320 +0,0 @@
-#!/usr/bin/env ruby
-#
-#
-#
-# Copyright (c) 1999-2006 Minero Aoki
-#
-# This program is free software.
-# You can distribute/modify this program under the same terms of ruby.
-# see the file "COPYING".
-
-require 'racc/static'
-require 'optparse'
-
-def main
-  output = nil
-  debug_parser = false
-  make_logfile = false
-  logfilename = nil
-  make_executable = false
-  rubypath = nil
-  embed_runtime = false
-  frozen_strings = false
-  debug_flags = Racc::DebugFlags.new
-  line_convert = true
-  line_convert_all = false
-  omit_action_call = true
-  superclass = nil
-  check_only = false
-  verbose = false
-  profiler = RaccProfiler.new(false)
-
-  parser = OptionParser.new
-  parser.banner = "Usage: #{File.basename($0)} [options] [input]"
-  parser.on('-o', '--output-file=PATH',
-            'output file name [<input>.tab.rb]') {|name|
-    output = name
-  }
-  parser.on('-t', '--debug', 'Outputs debugging parser.') {|fl|
-    debug_parser = fl
-  }
-  parser.on('-g', 'Equivalent to -t (obsolete).') {|fl|
-    $stderr.puts "racc -g is obsolete.  Use racc -t instead." if $VERBOSE
-    debug_parser = fl
-  }
-  parser.on('-v', '--verbose',
-            'Creates <filename>.output log file.') {|fl|
-    make_logfile = fl
-  }
-  parser.on('-O', '--log-file=PATH',
-            'Log file name [<input>.output]') {|path|
-    make_logfile = true
-    logfilename = path
-  }
-  parser.on('-e', '--executable [RUBYPATH]', 'Makes executable parser.') {|path|
-    make_executable = true
-    rubypath = (path == 'ruby' ? nil : path)
-  }
-  parser.on('-E', '--embedded', "Embeds Racc runtime in output.") {
-    embed_runtime = true
-  }
-  parser.on('-F', '--frozen', "Add frozen_string_literals: true.") {
-    frozen_strings = true
-  }
-  parser.on('--line-convert-all', 'Converts line numbers of user codes.') {
-    line_convert_all = true
-  }
-  parser.on('-l', '--no-line-convert', 'Never convert line numbers.') {
-    line_convert = false
-    line_convert_all = false
-  }
-  parser.on('-a', '--no-omit-actions', 'Never omit actions.') {
-    omit_action_call = false
-  }
-  parser.on('--superclass=CLASSNAME',
-            'Uses CLASSNAME instead of Racc::Parser.') {|name|
-    superclass = name
-  }
-  parser.on('-C', '--check-only', 'Checks syntax and quit immediately.') {|fl|
-    check_only = fl
-  }
-  parser.on('-S', '--output-status', 'Outputs internal status time to time.') {
-    verbose = true
-  }
-  parser.on('-P', 'Enables generator profile') {
-    profiler = RaccProfiler.new(true)
-  }
-  parser.on('-D flags', "Flags for Racc debugging (do not use).") {|flags|
-    debug_flags = Racc::DebugFlags.parse_option_string(flags)
-  }
-  #parser.on('--no-extensions', 'Run Racc without any Ruby extension.') {
-  #  Racc.const_set :Racc_No_Extensions, true
-  #}
-  parser.on('--version', 'Prints version and quit.') {
-    puts "racc version #{Racc::Version}"
-    exit
-  }
-  parser.on('--runtime-version', 'Prints runtime version and quit.') {
-    printf "racc runtime version %s; %s core version %s\n",
-           Racc::Parser::Racc_Runtime_Version,
-           Racc::Parser.racc_runtime_type,
-           if Racc::Parser.racc_runtime_type == 'ruby'
-             Racc::Parser::Racc_Runtime_Core_Version_R
-           else
-             Racc::Parser::Racc_Runtime_Core_Version_C
-           end
-    exit
-  }
-  parser.on('--copyright', 'Prints copyright and quit.') {
-    puts Racc::Copyright
-    exit
-  }
-  parser.on('--help', 'Prints this message and quit.') {
-    puts parser.help
-    exit
-  }
-  begin
-    parser.parse!
-  rescue OptionParser::ParseError => err
-    abort [err.message, parser.help].join("\n")
-  end
-  if ARGV.size > 1
-    abort 'too many input'
-  end
-
-  input = ARGV[0] || "stdin"
-
-  if input == "stdin" && !output then
-    abort 'You must specify a path to read or use -o <path> for output.'
-  end
-
-  begin
-    $stderr.puts 'Parsing grammar file...' if verbose
-    result = profiler.section('parse') {
-      parser = Racc::GrammarFileParser.new(debug_flags)
-      content = input == "stdin" ? ARGF.read : File.read(input)
-      parser.parse(content, File.basename(input))
-    }
-    if check_only
-      $stderr.puts 'syntax ok'
-      exit
-    end
-
-    $stderr.puts 'Generating LALR states...' if verbose
-    states = profiler.section('nfa') {
-      Racc::States.new(result.grammar).nfa
-    }
-
-    $stderr.puts "Resolving #{states.size} states..." if verbose
-    profiler.section('dfa') {
-      states.dfa
-    }
-
-    $stderr.puts 'Creating parser file...' if verbose
-    params = result.params.dup
-    params.filename = File.basename(input)
-    # Overwrites parameters given by a grammar file with command line options.
-    params.superclass = superclass if superclass
-    params.omit_action_call = true if omit_action_call
-    # From command line option
-    if make_executable
-      params.make_executable = true
-      params.interpreter = rubypath
-    end
-    params.debug_parser = debug_parser
-    params.convert_line = line_convert
-    params.convert_line_all = line_convert_all
-    params.embed_runtime = embed_runtime
-    params.frozen_strings = frozen_strings
-    profiler.section('generation') {
-      generator = Racc::ParserFileGenerator.new(states, params)
-      generator.generate_parser_file(output || make_filename(input, '.tab.rb'))
-    }
-
-    if make_logfile
-      profiler.section('logging') {
-        $stderr.puts 'Creating log file...' if verbose
-        logfilename ||= make_filename(output || File.basename(input), '.output')
-        File.open(logfilename, 'w') {|f|
-          Racc::LogFileGenerator.new(states, debug_flags).output f
-        }
-      }
-    end
-    if debug_flags.status_logging
-      log_useless states.grammar
-      log_conflict states
-    else
-      has_useless = report_useless states.grammar
-      has_conflicts = report_conflict states
-      if has_useless || has_conflicts
-        preamble = make_logfile ? 'C' : 'Turn on logging with "-v" and c'
-        $stderr.puts %Q{#{preamble}heck ".output" file for details}
-      end
-    end
-
-    profiler.report
-    if states.should_error_on_expect_mismatch?
-      raise Racc::CompileError, "#{states.grammar.n_expected_srconflicts} shift/reduce conflicts are expected but #{states.n_srconflicts} shift/reduce conflicts exist"
-    end
-  rescue Racc::Error, Errno::ENOENT, Errno::EPERM => err
-    raise if $DEBUG or debug_flags.any?
-    lineno = err.message.slice(/\A\d+:/).to_s
-    abort "#{File.basename $0}: #{input}:#{lineno} #{err.message.strip}"
-  end
-end
-
-def make_filename(path, suffix)
-  path.sub(/(?:\..*?)?\z/, suffix)
-end
-
-LIST_LIMIT = 10
-def report_list(enum, label)
-  c = enum.count
-  if c > 0
-    $stderr.puts "#{c} #{label}:"
-    enum.first(LIST_LIMIT).each do |item|
-      $stderr.puts "  #{yield item}"
-    end
-    $stderr.puts "  ..." if c > LIST_LIMIT
-  end
-end
-
-# @return [Boolean] if anything was reported
-def report_conflict(states)
-  if states.should_report_srconflict?
-    reported = true
-    $stderr.puts "#{states.n_srconflicts} shift/reduce conflicts"
-  end
-  if states.rrconflict_exist?
-    reported = true
-    $stderr.puts "#{states.n_rrconflicts} reduce/reduce conflicts"
-  end
-  reported
-end
-
-def log_conflict(states)
-  logging('w') {|f|
-    f.puts "ex#{states.grammar.n_expected_srconflicts}"
-    if states.should_report_srconflict?
-      f.puts "sr#{states.n_srconflicts}"
-    end
-    if states.rrconflict_exist?
-      f.puts "rr#{states.n_rrconflicts}"
-    end
-  }
-end
-
-# @return [Boolean] if anything was reported
-def report_useless(grammar)
-  reported = report_list(grammar.each_useless_nonterminal, 'useless nonterminals', &:to_s)
-
-  reported ||= report_list(grammar.each_useless_rule, 'useless rules') { |r| "##{r.ident} (#{r.target})" }
-
-  if grammar.start.useless?
-    $stderr.puts 'fatal: start symbol does not derive any sentence'
-    reported = true
-  end
-  reported
-end
-
-def log_useless(grammar)
-  logging('a') {|f|
-    if grammar.useless_nonterminal_exist?
-      f.puts "un#{grammar.n_useless_nonterminals}"
-    end
-    if grammar.useless_rule_exist?
-      f.puts "ur#{grammar.n_useless_rules}"
-    end
-  }
-end
-
-def logging(mode, &block)
-  File.open("log/#{File.basename(ARGV[0])}", mode, &block)
-end
-
-class RaccProfiler
-  def initialize(really)
-    @really = really
-    @log = []
-  end
-
-  def section(name)
-    if @really
-      t1 = ::Process.times.utime
-      result = yield
-      t2 = ::Process.times.utime
-      @log.push [name, t2 - t1]
-      result
-    else
-      yield
-    end
-  end
-
-  def report
-    return unless @really
-    f = $stderr
-    total = cumulative_time()
-    f.puts '--task-----------+--sec------+---%-'
-    @log.each do |name, time|
-      f.printf "%-19s %s %3d%%\n", name, pjust(time,4,4), (time/total*100).to_i
-    end
-    f.puts '-----------------+-----------+-----'
-    f.printf "%-20s%s\n", 'total', pjust(total,4,4)
-  end
-
-  private
-
-  def cumulative_time
-    t = @log.inject(0) {|sum, (name, time)| sum + time }
-    t == 0 ? 0.01 : t
-  end
-
-  def pjust(num, i, j)
-    m = /(\d+)(\.\d+)?/.match(num.to_s)
-    str = m[1].rjust(i)
-    str.concat m[2].ljust(j+1)[0,j+1] if m[2]
-    str
-  end
-end
-
-main