ex-xparse
Parses text into syntax trees based using a parser selected from a set of built-in parsers.
The REx parser generator was used to generate the parsers.
This release uses the -basex option of REx to generate Java for BaseX.
It can be used to implement the EXPath xparse proposal .
Requirements
This release requires BaseX 8.6+. This is a result of XQuery spec changes to map:merge
Usage
import module namespace xp="expkg-zone58:text.parse";
xp:parse("2+3",map{"lang":"xquery","version":"3.1 basex"})
xp:parse("2+3",map{"lang":"xquery","version":"3.1 basex"})
The second argument provides options to control the parsing of the text from the first argument.
Options
| Option | Type--- | Values | Default | Notes |
|---|---|---|---|---|
| lang | xs:string | XPath, XQuery | XPath | The language to be parsed |
| version | xs:string | "" | ||
| flatten | xs:boolean | true() | Flatten the parse tree |
The selected parser is chosen from the list in parser.xml. where the lang matches and version starts-with. see xp:parser($opts)
flatten skips elements with only one child element and no text.
Available parsers
<parsers xmlns="expkg-zone58:text.parse">
<parser lang="xpath">
<version version="3.0" ebnf="xpath-30" sym="XPath" />
<version version="3.1" ebnf="xpath-31" sym="XPath" />
parser>
<parser lang="xquery">
<version version="3.1 basex-2022-10-06" ebnf="BaseX" sym="XQuery"
options="-ll 2 -backtrack " >For BaseX 9 includes XQuery update and full-text. Does not include http://docs.basex.org/wiki/XQuery_Extensions#Expressionsversion>
<version version="3.1" ebnf="xquery-31" sym="XQuery" />
<version version="3.0" ebnf="xquery-30" sym="XQuery" />
<version version="1.0" ebnf="xquery-10" sym="XQuery" />
<version version="3.0 ML" ebnf="XQueryML30" sym="XQuery"
options="-backtrack" />
parser>
<parser lang="xqdoc-comments">
<version version="20160405" ebnf="XQDocComments" sym="Comments" />
parser>
<parser lang="ecmascript">
<version version="5" ebnf="EcmaScript" sym="Program"
options="-ll 1 -backtrack -asi" />
parser>
<parser lang="rex">
<version version="5.49" ebnf="REx" sym="Grammar" />
parser>
parsers>
<parser lang="xpath">
<version version="3.0" ebnf="xpath-30" sym="XPath" />
<version version="3.1" ebnf="xpath-31" sym="XPath" />
parser>
<parser lang="xquery">
<version version="3.1 basex-2022-10-06" ebnf="BaseX" sym="XQuery"
options="-ll 2 -backtrack " >For BaseX 9 includes XQuery update and full-text. Does not include http://docs.basex.org/wiki/XQuery_Extensions#Expressionsversion>
<version version="3.1" ebnf="xquery-31" sym="XQuery" />
<version version="3.0" ebnf="xquery-30" sym="XQuery" />
<version version="1.0" ebnf="xquery-10" sym="XQuery" />
<version version="3.0 ML" ebnf="XQueryML30" sym="XQuery"
options="-backtrack" />
parser>
<parser lang="xqdoc-comments">
<version version="20160405" ebnf="XQDocComments" sym="Comments" />
parser>
<parser lang="ecmascript">
<version version="5" ebnf="EcmaScript" sym="Program"
options="-ll 1 -backtrack -asi" />
parser>
<parser lang="rex">
<version version="5.49" ebnf="REx" sym="Grammar" />
parser>
parsers>
Examples
import module namespace xp="expkg-zone58:text.parse";
xp:parse("2+3",map{"lang":"xquery"})
xp:parse("2+3",map{"lang":"xquery"})
result
2
+
3
With options
import module namespace xp="expkg-zone58:text.parse";
xp:parse("1+2",map{"lang":"xpath","flatten":false()})
xp:parse("1+2",map{"lang":"xpath","flatten":false()})
Result:
1
+
2
Versions
import module namespace xp="expkg-zone58:text.parse";
xp:parse("map{'a':42}",map{"lang":"xquery"})