Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Formal grammar for EQL #2178

Closed
homedirectory opened this issue Feb 7, 2024 · 0 comments
Closed

Formal grammar for EQL #2178

homedirectory opened this issue Feb 7, 2024 · 0 comments
Assignees
@homedirectory
Labels
EQL Major Indicates a major versioning impact. P3 - normal Technology upgrade
Milestone
2.0.0

Comments

@homedirectory
Copy link
Contributor

homedirectory commented Feb 7, 2024 •
edited
Loading

Description

It is proposed to describe a formal grammar for EQL to gain the following benefits:

  • Facilitation of informal reasoning during development of the parser. As of now the only reference point is the fluent API itself, which is difficult to view as the grammar's representation since it is, in fact, its product.
  • A better understanding of the state of EQL's fluent API can be gained by reverse engineering it into a formal grammar.

The Extended Backus-Naur form (EBNF) is a suitable notation candidate.

Fling is a fluent API generator that provides means of expressing a grammar in EBNF using Java. Fling can be used to write down the grammar of EQL. The resulting grammar will be represented as a Java object, meaning that it can be transformed into arbitraty other formats if necessary.

Expected outcome

A formal grammar for EQL expressed in a suitable notation.
@homedirectory homedirectory self-assigned this Feb 7, 2024
homedirectory added a commit that referenced this issue Feb 7, 2024
@homedirectory
#2178 Initial spike: grammar specification via Fling
5996f6b
homedirectory added a commit that referenced this issue Feb 12, 2024
@homedirectory
#2178 Give AND precedence over OR in condition combinations
1c2ffc4
homedirectory added a commit that referenced this issue Feb 12, 2024
@homedirectory
#2178 Add grammar rules for beginExpr()/endExpr()
22267d0
homedirectory added a commit that referenced this issue Feb 12, 2024
@homedirectory
#2178 Rewrite rules for logical conditions to support begin/end grouping
e636417
homedirectory added a commit that referenced this issue Feb 12, 2024
@homedirectory
#2178 Implement translation from Fling BNF to human-readable represen…
a18488e 
…tation
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Add a canonical representation of EQL's grammar
02a4217 
A canonical representation serves as a reference, thus it is written in
a human-readable form.
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Extract BNF-to-text transformation into a reusable component
edd4a01
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Add rules for all single operands
4b2302e 
This also includes complex ones, such as caseWhen.
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Rules for all possible "like" operators
537ad8e
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Rules for membership predicates
f87e1fb
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Split operands and operators into 2 categories: regular compari…
c19b4ba 
…son and quantified
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Rules for single-condition, subchaining predicates
f9b6f47
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Rule for an optional alias after select
229f61e
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Rules for Joins
a86cf27
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 A rule for "group by"
ffad729
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 A proper rule for model variants
c16f05b
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Rules for yielding
2554ae2
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Simplify the Join rule
32f38cc
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Complete parameterisation of tokens corresponding to EQL method…
80e63d0 
…s declaring multiple parameters
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Improve readability of the translated BNF
c0f5d98
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Correct the rule for date diff interval function
b2e0fe3
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Implement an HTML generator for the BNF
f10a6bd
homedirectory added a commit that referenced this issue Feb 15, 2024
@homedirectory
#2178 Styling adjustments for generated HTML
3946040
homedirectory added a commit that referenced this issue Feb 16, 2024
@homedirectory
#2178 More styling adjustments for generated HTML
383ee28
homedirectory added a commit that referenced this issue Feb 16, 2024
@homedirectory
#2178 Correct the Predicate rule
769a847
homedirectory added a commit that referenced this issue Feb 28, 2024
@homedirectory
#2178 Enhance the BNF abstraction with the Alternation type
51fa045
homedirectory added a commit that referenced this issue Feb 28, 2024
@homedirectory
#2178 #2196 Eliminate redundant SingleOperandOrExpr rule
4433838
homedirectory added a commit that referenced this issue Feb 28, 2024
@homedirectory
#2178 Allow zero repetitions of yield after yieldAll
05f1c44
homedirectory added a commit that referenced this issue Mar 1, 2024
@homedirectory
#2196 #2178 Eliminate recursion from the groupBy rule
2b4c3ce
homedirectory added a commit that referenced this issue Mar 4, 2024
@homedirectory
#2196 #2178 Extend the yield operand rule with expressions involving …
b2d8e9a 
…yield operands

This allows the body of expressions to use yield operands, not just
single operands.
This was referenced Mar 27, 2024
Closed
Merged
@01es 01es added this to the 2.0.0 milestone Jul 18, 2024
@01es 01es added the Major Indicates a major versioning impact. label Aug 7, 2024
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: swap startDate & endDate labels in DateD…
5f19e06 
…iffInterval

Follow-up on 5227200
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: remove redundant labels
4ea3018 
Follow-up on dc70454
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: optimise yield rules
7f8d39d 
Follow-up on e1a88c6
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 Extend BNF metadata with list labels (ANTLR-specific)
4f7bfc6
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: use list labels to match the ANTLR grammar
85f769e
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: remove labels that cause errors in ANTLR…
9a68970 
… grammar

Can't apply the same label to elements of different types.
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 Introduce interface GrammarTransformer
5d7d21a 
This will make it easier to compose transformations.
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 Rewrite the Condition rule to facilitate automatic inlining
0de9608
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: align comparisonOperand rule with ANTLR …
1e721a7 
…grammar

Follow-up on 4433838
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 EQL BNF grammar: align exprBody rule with ANTLR grammar
9612154
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 Avoid redundant wrapping of terms in Sequence
f47e7e0 
1. Hide constructors of Sequence and use efficient static methods.
2. Modify the structure of Alternation to use a list of Term instead of
   a list of Sequence.
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 Rewrite the StandaloneCondition rule to facilitate automa…
6fe8e35 
…tic inlining
homedirectory added a commit that referenced this issue Aug 8, 2024
@homedirectory
#2196 #2178 Define the map operation for all BNF terms
6350895
homedirectory added a commit that referenced this issue Aug 9, 2024
@homedirectory
#2196 #2178 Rename TermMetadata to Metadata
21562c1 
Generalise the concept of metadata, which can be applied to any part of
BNF, not limited to terms.
homedirectory added a commit that referenced this issue Aug 9, 2024
@homedirectory
#2196 #2178 Enable BNF rules to be annotated
baf818a
homedirectory added a commit that referenced this issue Aug 9, 2024
@homedirectory
#2196 #2178 Ability to annotate rules with BNF fluent API
616f810
homedirectory added a commit that referenced this issue Aug 9, 2024
@homedirectory
#2196 #2178 Refactor metadata representation from key-value pairs to …
092ec83 
…annotation types
@01es 01es removed the pull request label Aug 15, 2024
@01es 01es closed this as completed Aug 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@homedirectory homedirectory

Labels
EQL Major Indicates a major versioning impact. P3 - normal Technology upgrade
Projects
None yet
Milestone
2.0.0
Development

Successfully merging a pull request may close this issue.

Issue #2178 fieldenms/tg
2 participants
@01es @homedirectory