Add Parquet demo

Author: rich-iannone

data_raw/x-01-parquet.qmd

@@ -4,6 +4,7 @@ html-table-processing: none
 ---
 
 ```{python}
+import pointblank as pb
 import polars as pl
 
 tbl_xyz = pl.DataFrame({"x": [1, 2, 3, 4], "y": [4, 5, 6, 7], "z": [8, 8, 8, 8]})
@@ -17,6 +18,7 @@ tbl_dates_times_text = pl.DataFrame(
         "text": [None, "5-egh-163", "8-kdg-938"],
     }
 )
+tbl_game_revenue = pb.load_dataset(dataset="game_revenue", tbl_type="polars")
 ```
 
 
@@ -32,3 +34,7 @@ tbl_xyz_missing.write_parquet("tbl_xyz_missing.parquet")
 ```{python}
 tbl_dates_times_text.write_parquet("tbl_dates_times_text.parquet")
 ```
+
+```{python}
+tbl_game_revenue.write_parquet("game_revenue.parquet")
+```

docs/demos/data/game_revenue.parquet

@@ -142,4 +142,7 @@ Use column selector functions in the `columns=` argument to conveniently choose
 [Check the Schema of a Table](./schema-check/index.qmd)<br>
 The schema of a table can be flexibly defined with `Schema` and verified with `col_schema_match()`.
 
+[Using Parquet Data](./using-parquet-data/index.qmd)<br>
+A Parquet dataset can be used for data validation, thanks to Ibis.
+
 </div>

docs/demos/index.qmd

@@ -0,0 +1,61 @@
+---
+pagetitle: "Examples: Using Parquet Data"
+notebook-links: false
+page-navigation: false
+toc: false
+html-table-processing: none
+---
+
+### Using Parquet Data
+
+A Parquet dataset can be used for data validation, thanks to Ibis.
+
+```{python}
+# | echo: false
+
+import pointblank as pb
+import ibis
+
+game_revenue = ibis.read_parquet("../data/game_revenue.parquet")
+
+validation = (
+    pb.Validate(data=game_revenue, label="Example using a Parquet dataset.")
+    .col_vals_lt(columns="item_revenue", value=200)
+    .col_vals_gt(columns="item_revenue", value=0)
+    .col_vals_gt(columns="session_duration", value=5)
+    .col_vals_in_set(columns="item_type", set=["iap", "ad"])
+    .col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}\d{3}")
+    .interrogate()
+)
+
+validation
+```
+
+```python
+import pointblank as pb
+import ibis
+
+game_revenue = ibis.read_parquet("data/game_revenue.parquet")
+
+validation = (
+    pb.Validate(data=game_revenue, label="Example using a Parquet dataset.")
+    .col_vals_lt(columns="item_revenue", value=200)
+    .col_vals_gt(columns="item_revenue", value=0)
+    .col_vals_gt(columns="session_duration", value=5)
+    .col_vals_in_set(columns="item_type", set=["iap", "ad"])
+    .col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}\d{3}")
+    .interrogate()
+)
+
+validation
+```
+
+<details>
+<summary>Preview of Input Table</summary>
+
+```{python}
+# | echo: false
+pb.preview(game_revenue)
+```
+
+</details>