From a7c3507b94161b2c5f86fbcd158766b692cd16d6 Mon Sep 17 00:00:00 2001 From: jcamiel Date: Mon, 14 Nov 2022 13:07:52 +0100 Subject: [PATCH] Update grammar doc. --- docs/grammar.md | 47 +++++++++++++++++++++++------------------------ 1 file changed, 23 insertions(+), 24 deletions(-) diff --git a/docs/grammar.md b/docs/grammar.md index 07ed5bdbc..b0bb8f625 100644 --- a/docs/grammar.md +++ b/docs/grammar.md @@ -77,9 +77,9 @@ Short description:
file-value(used by file-param)
file, filename ; (file-contenttype)?
file-contenttype(used by file-value)
[a-zA-Z0-9/+-]+
capture(used by captures-section)
lt*
-key-string : query lt
+key-string : query (sp filter)* lt
assert(used by asserts-section)
lt*
-query sp predicate lt
+query (sp filter)* sp predicate lt
option(used by options-section)
lt*
(ca-certificate-option|follow-redirect-option|insecure-option|max-redirs-option|retry-option|retry-interval-option|retry-max-count-option|variable-option|verbose-option|very-verbose-option)
ca-certificate-option(used by option)
cacert : filename lt
@@ -99,8 +99,7 @@ Short description: |float
|key-string
|quoted-string -

Query

query(used by capture, assert)
main-query (sp filter)*
-
main-query(used by query)
 status-query
+

Query

query(used by capture, assert)
 status-query
|url-query
|header-query
|cookie-query
@@ -113,19 +112,19 @@ Short description: |bytes-query
|sha256-query
|md5-query
-
status-query(used by main-query)
status
-
url-query(used by main-query)
url
-
header-query(used by main-query)
header sp quoted-string
-
cookie-query(used by main-query)
cookie sp quoted-string
-
body-query(used by main-query)
body
-
xpath-query(used by main-query)
xpath sp quoted-string
-
jsonpath-query(used by main-query)
jsonpath sp quoted-string
-
regex-query(used by main-query)
regex sp (quoted-string|regex)
-
variable-query(used by main-query)
variable sp quoted-string
-
duration-query(used by main-query)
duration
-
sha256-query(used by main-query)
sha256
-
md5-query(used by main-query)
md5
-
bytes-query(used by main-query)
bytes
+
status-query(used by query)
status
+
url-query(used by query)
url
+
header-query(used by query)
header sp quoted-string
+
cookie-query(used by query)
cookie sp quoted-string
+
body-query(used by query)
body
+
xpath-query(used by query)
xpath sp quoted-string
+
jsonpath-query(used by query)
jsonpath sp quoted-string
+
regex-query(used by query)
regex sp (quoted-string|regex)
+
variable-query(used by query)
variable sp quoted-string
+
duration-query(used by query)
duration
+
sha256-query(used by query)
sha256
+
md5-query(used by query)
md5
+
bytes-query(used by query)
bytes

Predicates

predicate(used by assert)
(not sp)? predicate-func
predicate-func(used by predicate)
 equal-predicate
|not-equal-predicate
@@ -229,17 +228,17 @@ Short description:
json-string-text(used by json-string-content)
~["\\]
json-string-escaped-char(used by json-string-content)
\ ("|\|b|f|n|r|t|u hexdigit hexdigit hexdigit hexdigit)
json-number(used by json-value)
integer fraction? exponent?
-

Template / Expression

template(used by predicate-value, quoted-string, key-string, value-string, oneline-string, multiline-string, filename, json-value, json-string)
{{ expr }}
+

Template / Expression

template(used by predicate-value, quoted-string, key-string, value-string, oneline-string, multiline-string, filename, json-value, json-string)
{{ expr }}
expr(used by template)
variable-name (sp filter)*
variable-name(used by variable-definition, expr)
[A-Za-z] [A-Za-z_-0-9]*
-

Filter

filter(used by query, expr)
 regex-filter
+

Filter

filter(used by capture, assert, expr)
 regex-filter
|count-filter
-|escapeurl-filter
-|unescapeurl-filter
+|url-encode-filter
+|url-decode-filter
regex-filter(used by filter)
regex sp (quoted-string|regex)
count-filter(used by filter)
count
-
escapeurl-filter(used by filter)
escapeUrl
-
unescapeurl-filter(used by filter)
unescapeUrl
+
url-encode-filter(used by filter)
urlEncode
+
url-decode-filter(used by filter)
urlDecode

Lexical Grammar

boolean(used by follow-redirect-option, insecure-option, retry-option, verbose-option, very-verbose-option, variable-value, predicate-value, json-value)
true|false
null(used by variable-value, predicate-value, json-value)
null
integer(used by max-redirs-option, retry-interval-option, retry-max-count-option, variable-value, greater-predicate, greater-or-equal-predicate, less-predicate, less-or-equal-predicate, predicate-value, json-number, float)
digit+
@@ -248,7 +247,7 @@ Short description:
hexdigit(used by oneline-hex, unicode-char, json-string-escaped-char)
[0-9A-Fa-f]
fraction(used by json-number, float)
. digit+
exponent(used by json-number)
(e|E) (+|-)? digit+
-
sp(used by request, response, assert, query, header-query, cookie-query, xpath-query, jsonpath-query, regex-query, variable-query, predicate, equal-predicate, not-equal-predicate, greater-predicate, greater-or-equal-predicate, less-predicate, less-or-equal-predicate, start-with-predicate, end-with-predicate, contain-predicate, match-predicate, include-predicate, expr, regex-filter, lt)
[ \t]
+
sp(used by request, response, capture, assert, header-query, cookie-query, xpath-query, jsonpath-query, regex-query, variable-query, predicate, equal-predicate, not-equal-predicate, greater-predicate, greater-or-equal-predicate, less-predicate, less-or-equal-predicate, start-with-predicate, end-with-predicate, contain-predicate, match-predicate, include-predicate, expr, regex-filter, lt)
[ \t]
lt(used by hurl-file, request, response, header, body, query-string-params-section, form-params-section, multipart-form-data-section, cookies-section, captures-section, asserts-section, options-section, file-param, capture, assert, option, ca-certificate-option, follow-redirect-option, insecure-option, max-redirs-option, retry-option, retry-interval-option, retry-max-count-option, variable-option, verbose-option, very-verbose-option, multiline-string)
sp* comment? [\n]?
comment(used by lt)
# ~[\n]*
regex(used by regex-query, match-predicate, regex-filter)
/ regex-content /