@appthreat/atom 2.1.19 → 2.2.0

package/plugins/rubyastgen/bundle/ruby/3.4.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/3.4.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/3.4.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/3.4.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

package/plugins/rubyastgen/bundle/ruby/3.4.0/gems/racc-1.8.1/doc/en/grammar.en.rdoc

@@ -1,218 +0,0 @@
-= Racc Grammar File Reference
-
-== Global Structure
-
-== Class Block and User Code Block
-
-There are two top-level blocks: the 'class' block, and the 'user code'
-block. The 'user code' block MUST be after the 'class' block.
-
-== Comment
-
-Comments can be added about everywhere.  Two comment styles are
-supported: Ruby style (`# ...`) and C style (`/* ... */`).
-
-== Class Block
-
-The class block is formed like this:
-
-  class CLASS_NAME
-    [precedence table]
-    [token declarations]
-    [expected number of S/R conflict]
-    [options]
-    [semantic value conversion]
-    [start rule]
-  rule
-    GRAMMARS
-
-CLASS_NAME is a name of parser class.
-This is the name of generating parser class.
-
-If CLASS_NAME includes '::', Racc outputs module clause.
-For example, writing "class M::C" causes creating the code below:
-
-  module M
-    class C
-      :
-      :
-    end
-  end
-
-== Grammar Block
-
-The grammar block describes the grammar
-to be understood by parser.  Syntax is:
-
-  (token): (token) (token) (token).... (action)
-
-  (token): (token) (token) (token).... (action)
-         | (token) (token) (token).... (action)
-         | (token) (token) (token).... (action)
-
-(action) is an action which is executed when its (token)s are found.
-(action) is a ruby code block, which is surrounded by braces:
-
-  { print val[0]
-    puts val[1] }
-
-Note that you cannot use '%' string, here document, '%r' regexp in action.
-
-Actions can be omitted.
-When it is omitted, '' (empty string) is used.
-
-A return value of action is a value of left side value ($$).
-It is value of result, or returned value by "return" statement.
-
-Here is an example of whole grammar block.
-
-  rule
-    goal: definition rules source { result = val }
-
-    definition: /* none */   { result = [] }
-      | definition startdesig  { result[0] = val[1] }
-      | definition
-               precrule   # this line continue from upper line
-        {
-          result[1] = val[1]
-        }
-
-    startdesig: START TOKEN
-
-You can use following special local variables in action.
-
-  * result ($$)
-
-The value of left-hand side (lhs). A default value is val[0].
-
-  * val ($1,$2,$3...)
-
-An array of value of right-hand side (rhs).
-
-  * _values (...$-2,$-1,$0)
-
-A stack of values.
-DO NOT MODIFY this stack unless you know what you are doing.
-
-== Operator Precedence
-
-This function is equal to '%prec' in yacc.
-To designate this block:
-
-  prechigh
-    nonassoc '++'
-    left     '*' '/'
-    left     '+' '-'
-    right    '='
-  preclow
-
-`right' is yacc's %right, `left' is yacc's %left.
-
-`=' + (symbol) means yacc's %prec:
-
-  prechigh
-    nonassoc UMINUS
-    left '*' '/'
-    left '+' '-'
-  preclow
-
-  rule
-    exp: exp '*' exp
-       | exp '-' exp
-       | '-' exp       =UMINUS   # equals to "%prec UMINUS"
-           :
-           :
-
-== expect
-
-Racc supports Bison's "expect" directive to declare the expected
-number of shift/reduce conflicts.
-
-  class MyParser
-    expect 3
-  rule
-      :
-      :
-
-Then warnings are issued only when the effective number of conflicts differs.
-
-== Declaring Tokens
-
-Declaring tokens avoids many bugs.
-
-Racc outputs warnings for declared tokens that do not exist, or existing tokens not declared.
-The syntax is:
-
-  token TOKEN_NAME AND_IS_THIS
-        ALSO_THIS_IS AGAIN_AND_AGAIN THIS_IS_LAST
-
-== Options
-
-You can write options for racc command in your racc file.
-
-  options OPTION OPTION ...
-
-Options are:
-
-  * omit_action_call
-
-omit empty action call or not.
-
-  * result_var
-
-use/does not use local variable "result"
-
-You can use 'no_' prefix to invert its meanings.
-
-== Converting Token Symbol
-
-Token symbols are, as default,
-
-  * naked token strings in racc file (TOK, XFILE, this_is_token, ...)
-    --> symbol (:TOK, :XFILE, :this_is_token, ...)
-  * quoted strings (':', '.', '(', ...)
-    --> same string (':', '.', '(', ...)
-
-You can change this default using a "convert" block.
-Here is an example:
-
-  convert
-    PLUS 'PlusClass'      # We use PlusClass for symbol of `PLUS'
-    MIN  'MinusClass'     # We use MinusClass for symbol of `MIN'
-  end
-
-We can use almost all ruby value can be used by token symbol,
-except 'false' and 'nil'.  These are causes unexpected parse error.
-
-If you want to use String as token symbol, special care is required.
-For example:
-
-  convert
-    class '"cls"'            # in code, "cls"
-    PLUS '"plus\n"'          # in code, "plus\n"
-    MIN  "\"minus#{val}\""   # in code, \"minus#{val}\"
-  end
-
-== Start Rule
-
-'%start' in yacc. This changes the start symbol.
-
-  start real_target
-
-== User Code Block
-
-A "User Code Block" is a piece of Ruby source code copied in the output.
-There are three user code blocks, "header" "inner" and "footer".
-
-User code blocks are introduced by four '-' at the beginning of a line,
-followed by a single-word name:
-
-  ---- header
-    ruby statement
-    ruby statement
-    ruby statement
-
-  ---- inner
-    ruby statement
-       :
-       :