Documentation
¶
Overview ¶
Package parse provides readers for parsing Asciidoc
Index ¶
- func Bytes(path string, b []byte, opts ...Option) (*asciidoc.Document, error)
- func Dump(els ...asciidoc.Element)
- func Elements(path string, reader io.Reader, opts ...Option) (elements asciidoc.Elements, err error)
- func File(path string, opts ...Option) (*asciidoc.Document, error)
- func Filter(parent asciidoc.Parent, ...) (shortCircuit bool)
- func FindAll[T any](reader asciidoc.Reader, parent asciidoc.ParentElement) iter.Seq[T]
- func FindFirst[T any](reader asciidoc.Reader, parent asciidoc.ParentElement) T
- func Parse(filename string, b []byte, opts ...Option) (any, error)
- func ParseFile(filename string, opts ...Option) (i any, err error)
- func ParseReader(filename string, r io.Reader, opts ...Option) (any, error)
- func Reader(path string, reader io.Reader, opts ...Option) (*asciidoc.Document, error)
- func ReparseTable(table *asciidoc.Table, elements asciidoc.Elements) (err error)
- func Search[T any](reader asciidoc.Reader, parent asciidoc.Parent, els asciidoc.Elements, ...)
- func Skim[T any](reader asciidoc.Reader, parent asciidoc.ParentElement, ...) iter.Seq[T]
- func SkimFunc[T any](reader asciidoc.Reader, parent asciidoc.ParentElement, ...) bool
- func SkimList[T any](reader asciidoc.Reader, parent asciidoc.ParentElement, ...) []T
- func String(path string, s string) (*asciidoc.Document, error)
- func Traverse[T any](reader asciidoc.Reader, parent asciidoc.Parent, els asciidoc.Elements, ...)
- type ElementSearchCallback
- type ElementsReader
- type Option
- type PreParseContext
- type SearchShould
- type Stats
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func FindFirst ¶ added in v1.5.42
func FindFirst[T any](reader asciidoc.Reader, parent asciidoc.ParentElement) T
func ParseReader ¶
ParseReader parses the data from r using filename as information in the error messages.
func ReparseTable ¶ added in v1.5.42
Types ¶
type ElementSearchCallback ¶ added in v1.5.42
type ElementSearchCallback[T any] func(el T, parent asciidoc.Parent, index int) SearchShould
type ElementsReader ¶ added in v1.5.42
type ElementsReader struct {
Root string
// contains filtered or unexported fields
}
func NewElementsReader ¶ added in v1.5.42
func NewElementsReader(name string, rootPath string) (ElementsReader, error)
func (ElementsReader) Name ¶ added in v1.5.42
func (r ElementsReader) Name() string
type Option ¶
type Option func(*parser) Option
Option is a function that can set an option on the parser. It returns the previous setting as an Option.
func AllowInvalidUTF8 ¶
AllowInvalidUTF8 creates an Option to allow invalid UTF-8 bytes. Every invalid UTF-8 byte is treated as a utf8.RuneError (U+FFFD) by character class matchers and is matched by the any matcher. The returned matched value, c.text and c.offset are NOT affected.
The default is false.
func Entrypoint ¶
Entrypoint creates an Option to set the rule name to use as entrypoint. The rule name must have been specified in the -alternate-entrypoints if generating the parser with the -optimize-grammar flag, otherwise it may have been optimized out. Passing an empty string sets the entrypoint to the first rule in the grammar.
The default is to start parsing at the first rule in the grammar.
func GlobalStore ¶
GlobalStore creates an Option to set a key to a certain value in the globalStore.
func MaxExpressions ¶
MaxExpressions creates an Option to stop parsing after the provided number of expressions have been parsed, if the value is 0 then the parser will parse for as many steps as needed (possibly an infinite number).
The default for maxExprCnt is 0.
type PreParseContext ¶
type PreParseContext interface {
IsSet(name string) bool
Get(name string) any
Set(name string, value any)
Unset(name string)
GetCounterState(name string, initialValue string) (*asciidoc.CounterState, error)
ResolvePath(root string, path string) (asciidoc.Path, error)
ShouldIncludeFile(path asciidoc.Path) bool
}
type SearchShould ¶ added in v1.5.42
type SearchShould uint8
const ( SearchShouldContinue SearchShould = iota SearchShouldStop SearchShouldSkip )
type Stats ¶
type Stats struct {
// ExprCnt counts the number of expressions processed during parsing
// This value is compared to the maximum number of expressions allowed
// (set by the MaxExpressions option).
ExprCnt uint64
// ChoiceAltCnt is used to count for each ordered choice expression,
// which alternative is used how may times.
// These numbers allow to optimize the order of the ordered choice expression
// to increase the performance of the parser
//
// The outer key of ChoiceAltCnt is composed of the name of the rule as well
// as the line and the column of the ordered choice.
// The inner key of ChoiceAltCnt is the number (one-based) of the matching alternative.
// For each alternative the number of matches are counted. If an ordered choice does not
// match, a special counter is incremented. The name of this counter is set with
// the parser option Statistics.
// For an alternative to be included in ChoiceAltCnt, it has to match at least once.
ChoiceAltCnt map[string]map[string]int
}
Stats stores some statistics, gathered during parsing
Source Files