[v1] Replace sprout-generated AST with hand-written AST

[alancai98]

Tracking issue for replacing the sprout-generated AST with the hand-written AST. The following will need to be completed to mark this issue as completed:

• [v1] Add simplified AST classes and visitors #1579
• Add builders - [v1] Add Lombok Builders to classes; make every field final #1616
• Make fields/properties final - [v1] Add Lombok Builders to classes; make every field final #1616
• Add factory methods for AST classes - [v1] Add AST factory methods; some fixes to AST classes #1622
  • Rewrite factory methods in Kotlin for better usability from Kotlin - [v1] Make Kotlin AST factory methods #1623
• Create AstBaseVisitor and AstRewriter equivalents - [v1] Adds AstVisitor and AstRewriter; port partiql-ast normalization passes to partiql-planner #1629
• Switchover existing sprout-generated AST code w/ the new Java AST definitions
  • partiql-ast: SqlDialect - [v1] Port SqlDialect to v1 AST #1638
  • partiql-parser: ANTLR visitor -> partiql-ast - [v1] Migrate parser to new AST #1626
  • partiql-planner: visitor to convert AST -> partiql-plan - [v1] Add v1 ast -> plan conversion; hook up w/ existing code #1631
  • migrate v1 names to existing names (parser) - [v1] Rename V1Parser to Parser; move parser builder within the interface #1637
• Add docs
• Delete sprout-generated AST code - [v1] Delete sprout-generated AST; remove v1 from AST package path #1639
• Misc other tasks
  • Add equals and hashcode for AST nodes (does not use the AstNode tag) - [v1] Add equals and hashcode for AST classes #1627
  • Add .valueOf and .values methods for AST enums - [v1] Add .valueOf and .values methods for enums #1628
  • Add .name method to AST enum interface - [v1] Add name method to AstEnum #1630
  • Create .codes() -> int[], .names() -> strings[], code(string) -> int, name(int) -> string methods for AstEnums
  • From [v1] Remove PartiQLValue from AST; refactor AST literals #1650 (comment), change children function to different signature public List<AstNode> getChildren() - [v1] Refactor AstNode getChildren() method; change tag to be mutable int #1674
  • [V1] Add nullable default fields to AST node factories #1640
  • Add null defaults to AST factory methods - [v1] Add null defaults to AST factory methods #1675
  • Apply plan memoization pattern for AstNode's getChildren. E.g. in RelBase --

    partiql-lang-kotlin/partiql-plan/src/main/java/org/partiql/plan/rel/RelBase.java

    Lines 50 to 57 in 158b814

    	@NotNull
    	@Override
    	public final List<Operand> getOperands() {
    	if (operands == null) {
    	operands = operands();
    	}
    	return operands;
    	}

  • Use getters - [v1] Change public fields to Lombok getters; make concrete classes final #1685
  • Make concrete classes final - [v1] Change public fields to Lombok getters; make concrete classes final #1685
  • Remove UNKNOWN AST enum variant - [v1] Remove UNKNOWN AST enum variant #1688

Out of scope for this issue (will be addressed in subsequent PRs)

• Get rid of usage of PartiQLValue [V1] Remove PartiQLValue from the AST #1589
  • Use separate AST representation of PartiQL literals
• Delete sprout?