Initialize partiql-parser package with partiql-ast IR

.github/workflows/build.yml

@@ -6,11 +6,13 @@ on:
       - '**'
       - '!docs/**'
       - '!**/*.md'
+      - '!**/*.adoc'
   pull_request:
     paths:
       - '**'
       - '!docs/**'
-      - '!**.*.md'
+      - '!**/*.md'
+      - '!**/*.adoc'
 
 jobs:
   test:

CHANGELOG.md

@@ -31,6 +31,8 @@ Thank you to all who have contributed!
 ### Added
 - Adds `org.partiql.value` (experimental) package for reading/writing PartiQL
   values
+- Adds `org.partiql.ast` package and usage documentation
+- Adds `org.partiql.parser` package and usage documentation
 
 ### Changed
 

lib/sprout/src/main/kotlin/org/partiql/sprout/generator/target/kotlin/poems/KotlinUtilsPoem.kt

@@ -39,6 +39,7 @@ class KotlinUtilsPoem(symbols: KotlinSymbols) : KotlinPoem(symbols) {
     private val suppressUnused = AnnotationSpec.builder(Suppress::class)
         .useSiteTarget(AnnotationSpec.UseSiteTarget.FILE)
         .addMember("%S", "UNUSED_PARAMETER")
+        .addMember("%S", "UNUSED_VARIABLE")
         .build()
 
     // Not taking a dep on builder or visitor poems, as this is temporary
@@ -107,8 +108,8 @@ class KotlinUtilsPoem(symbols: KotlinSymbols) : KotlinPoem(symbols) {
     // Node N           -> visitN(node.n, ctx) as N
     // Node N?          -> node.n?.let { visitN(it, ctx) as N }
     // Collection<N>    -> rewrite(node, ctx, ::method)
-    // Collection?<N>   -> node.n?.let { rewrite(it, ctx, ::method) }
-    // Collection?<N?>  -> node.n?.let { rewrite(it, ctx, ::method) }
+    // Collection<N>?   -> node.n?.let { rewrite(it, ctx, ::method) }
+    // Collection<N?>?  -> node.n?.let { rewrite(it, ctx, ::method) }
     // Collection<N?>   -> rewrite(node, ctx, ::method)
 
     private fun KotlinNodeSpec.Product.rewriter(): FunSpec {
@@ -139,17 +140,25 @@ class KotlinUtilsPoem(symbols: KotlinSymbols) : KotlinPoem(symbols) {
                         (ref is TypeRef.List && isNode(ref.type)) -> {
                             // Collections
                             val method = (ref.type as TypeRef.Path).visitMethodName()
+                            val helper = when (ref.type.nullable) {
+                                true -> "_visitListNull"
+                                else -> "_visitList"
+                            }
                             when (ref.nullable) {
-                                true -> addStatement("val $name = $child?.let { _visitListNull(it, ctx, ::$method) }")
-                                false -> addStatement("val $name = _visitList($child, ctx, ::$method)")
+                                true -> addStatement("val $name = $child?.let { $helper(it, ctx, ::$method) }")
+                                false -> addStatement("val $name = $helper($child, ctx, ::$method)")
                             }
                         }
                         (ref is TypeRef.Set && isNode(ref.type)) -> {
                             // Collections
                             val method = (ref.type as TypeRef.Path).visitMethodName()
+                            val helper = when (ref.type.nullable) {
+                                true -> "_visitSetNull"
+                                else -> "_visitSet"
+                            }
                             when (ref.nullable) {
-                                true -> addStatement("val $name = $child?.let { _visitSetNull(it, ctx, ::$method) }")
-                                false -> addStatement("val $name = _visitSet($child, ctx, ::$method)")
+                                true -> addStatement("val $name = $child?.let { $helper(it, ctx, ::$method) }")
+                                false -> addStatement("val $name = $helper($child, ctx, ::$method)")
                             }
                         }
                         else -> {