record more SimpleTable tests in reference.md

Author: bishabosha

docs/reference.md

@@ -11211,6 +11211,235 @@ db.run(OptDataTypes.select) ==> Seq(rowSome, rowNone)
 
 
 
+### Optional.filter - with SimpleTable
+
+`.filter` follows normal Scala semantics, and translates to a `CASE`/`WHEN (foo)`/`ELSE NULL`
+
+```scala
+OptCols.select.map(d => d.updates(_.myInt(_.filter(_ < 2))))
+```
+
+
+*
+    ```sql
+    SELECT
+      CASE
+        WHEN (opt_cols0.my_int < ?) THEN opt_cols0.my_int
+        ELSE NULL
+      END AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(None, None),
+      OptCols(Some(1), Some(2)),
+      OptCols(None, None),
+      OptCols(None, Some(4))
+    )
+    ```
+
+
+
+### Optional.getOrElse - with SimpleTable
+
+
+
+```scala
+OptCols.select.map(d => d.updates(_.myInt(_.getOrElse(-1))))
+```
+
+
+*
+    ```sql
+    SELECT
+      COALESCE(opt_cols0.my_int, ?) AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(Some(-1), None),
+      OptCols(Some(1), Some(2)),
+      OptCols(Some(3), None),
+      OptCols(Some(-1), Some(4))
+    )
+    ```
+
+
+
+### Optional.rawGet - with SimpleTable
+
+
+
+```scala
+OptCols.select.map(d => d.updates(_.myInt(_.get + d.myInt2.get + 1)))
+```
+
+
+*
+    ```sql
+    SELECT
+      ((opt_cols0.my_int + opt_cols0.my_int2) + ?) AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(None, None),
+      OptCols(Some(4), Some(2)),
+      // because my_int2 is added to my_int, and my_int2 is null, my_int becomes null too
+      OptCols(None, None),
+      OptCols(None, Some(4))
+    )
+    ```
+
+
+
+### Optional.orElse - with SimpleTable
+
+
+
+```scala
+OptCols.select.map(d => d.updates(_.myInt(_.orElse(d.myInt2))))
+```
+
+
+*
+    ```sql
+    SELECT
+      COALESCE(opt_cols0.my_int, opt_cols0.my_int2) AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(None, None),
+      OptCols(Some(1), Some(2)),
+      OptCols(Some(3), None),
+      OptCols(Some(4), Some(4))
+    )
+    ```
+
+
+
+### Optional.mapGet - with SimpleTable
+
+You can use `.get` to turn an `Expr[Option[V]]` into an `Expr[V]`. This follows
+SQL semantics, such that `NULL`s anywhere in that selected column automatically
+will turn the whole column `None` (if it's an `Expr[Option[V]]` column) or `null`
+(if it's not an optional column)
+
+```scala
+OptCols.select.map(d => d.updates(_.myInt(_.map(_ + d.myInt2.get + 1))))
+```
+
+
+*
+    ```sql
+    SELECT
+      ((opt_cols0.my_int + opt_cols0.my_int2) + ?) AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(None, None),
+      OptCols(Some(4), Some(2)),
+      // because my_int2 is added to my_int, and my_int2 is null, my_int becomes null too
+      OptCols(None, None),
+      OptCols(None, Some(4))
+    )
+    ```
+
+
+
+### Optional.flatMap - with SimpleTable
+
+
+
+```scala
+OptCols.select
+  .map(d => d.updates(_.myInt(_.flatMap(v => d.myInt2.map(v2 => v + v2 + 10)))))
+```
+
+
+*
+    ```sql
+    SELECT
+      ((opt_cols0.my_int + opt_cols0.my_int2) + ?) AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(None, None),
+      OptCols(Some(13), Some(2)),
+      // because my_int2 is added to my_int, and my_int2 is null, my_int becomes null too
+      OptCols(None, None),
+      OptCols(None, Some(4))
+    )
+    ```
+
+
+
+### Optional.map - with SimpleTable
+
+You can use operators like `.map` and `.flatMap` to work with
+your `Expr[Option[V]]` values. These roughly follow the semantics
+that you would be familiar with from Scala.
+
+```scala
+OptCols.select.map(d => d.updates(_.myInt(_.map(_ + 10))))
+```
+
+
+*
+    ```sql
+    SELECT
+      (opt_cols0.my_int + ?) AS my_int,
+      opt_cols0.my_int2 AS my_int2
+    FROM opt_cols opt_cols0
+    ```
+
+
+
+*
+    ```scala
+    Seq(
+      OptCols(None, None),
+      OptCols(Some(11), Some(2)),
+      OptCols(Some(13), None),
+      OptCols(None, Some(4))
+    )
+    ```
+
+
+
 ## PostgresDialect
 Operations specific to working with Postgres Databases
 ### PostgresDialect.distinctOn

scalasql/namedtuples/test/src/datatypes/SimpleTableOptionalTests.scala

@@ -255,7 +255,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
 
     }
 
-    test("map") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("map - with SimpleTable") - checker(
       query = Text { OptCols.select.map(d => d.updates(_.myInt(_.map(_ + 10)))) },
       sql = """
       SELECT
@@ -282,7 +283,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
       value = Seq(None, Some(11), Some(13), None)
     )
 
-    test("flatMap") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("flatMap - with SimpleTable") - checker(
       query = Text {
         OptCols.select
           .map(d => d.updates(_.myInt(_.flatMap(v => d.myInt2.map(v2 => v + v2 + 10)))))
@@ -302,7 +304,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
       )
     )
 
-    test("mapGet") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("mapGet - with SimpleTable") - checker(
       query = Text {
         OptCols.select.map(d => d.updates(_.myInt(_.map(_ + d.myInt2.get + 1))))
       },
@@ -327,7 +330,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
       """
     )
 
-    test("rawGet") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("rawGet - with SimpleTable") - checker(
       query = Text {
         OptCols.select.map(d => d.updates(_.myInt(_.get + d.myInt2.get + 1)))
       },
@@ -346,7 +350,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
       )
     )
 
-    test("getOrElse") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("getOrElse - with SimpleTable") - checker(
       query = Text { OptCols.select.map(d => d.updates(_.myInt(_.getOrElse(-1)))) },
       sql = """
         SELECT
@@ -362,7 +367,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
       )
     )
 
-    test("orElse") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("orElse - with SimpleTable") - checker(
       query = Text { OptCols.select.map(d => d.updates(_.myInt(_.orElse(d.myInt2)))) },
       sql = """
         SELECT
@@ -378,7 +384,8 @@ trait SimpleTableOptionalTests extends ScalaSqlSuite {
       )
     )
 
-    test("filter") - checker(
+    // !! Important: '- with SimpleTable' so it will be detected by generateDocs.mill
+    test("filter - with SimpleTable") - checker(
       query = Text { OptCols.select.map(d => d.updates(_.myInt(_.filter(_ < 2)))) },
       sql = """
         SELECT