File: INTERNALS.md

package info (click to toggle)
ruby-whitequark-parser 3.3.4.2-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,828 kB
  • sloc: yacc: 40,699; ruby: 20,395; makefile: 12; sh: 8
file content (21 lines) | stat: -rw-r--r-- 947 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
Entry points
------------

Parser should be kept as slim as possible. This includes not loading
any potentially large files when they are likely to be unused in practice.

Parser has five main (classes of) `require` entry points:

 * `require 'parser'`. Main entry point, requires all classes which
   are used across the entire library.
 * `require 'parser/rubyXX'`. Version-specific entry point. Can raise
   a NotImplementedError if current Ruby runtime is unable to parse the
   requested Ruby version.
 * `require 'parser/all'`. Requires all available parsers for released
   versions of Ruby. Can raise NotImplementedError.
 * `require 'parser/runner'`. Requires all the stuff which is useful for
   command-line tools but not otherwise.
 * `require 'parser/runner/X'`. Runner-specific entry point.

All non-main entry points internally `require 'parser'`. Additionally, all
runner-specific entry points internally `requre 'parser/runner'`.