pointblank 0.11.6__py3-none-any.whl → 0.12.0__py3-none-any.whl

{pointblank-0.11.6.dist-info → pointblank-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pointblank
-Version: 0.11.6
+Version: 0.12.0
 Summary: Find out if your data is what you think it is.
 Author-email: Richard Iannone <riannone@me.com>
 License: MIT License
@@ -43,7 +43,7 @@ License-File: LICENSE
 Requires-Dist: commonmark>=0.9.1
 Requires-Dist: importlib-metadata
 Requires-Dist: great_tables>=0.17.0
-Requires-Dist: narwhals>=1.45.0
+Requires-Dist: narwhals>=2.0.1
 Requires-Dist: typing_extensions>=3.10.0.0
 Requires-Dist: requests>=2.31.0
 Requires-Dist: click>=8.0.0
@@ -53,6 +53,8 @@ Provides-Extra: pd
 Requires-Dist: pandas>=2.2.3; extra == "pd"
 Provides-Extra: pl
 Requires-Dist: polars>=1.24.0; extra == "pl"
+Provides-Extra: pyspark
+Requires-Dist: pyspark==3.5.6; extra == "pyspark"
 Provides-Extra: generate
 Requires-Dist: chatlas>=0.3.0; extra == "generate"
 Requires-Dist: anthropic[bedrock]>=0.45.2; extra == "generate"
@@ -70,8 +72,6 @@ Provides-Extra: mssql
 Requires-Dist: ibis-framework[mssql]>=9.5.0; extra == "mssql"
 Provides-Extra: postgres
 Requires-Dist: ibis-framework[postgres]>=9.5.0; extra == "postgres"
-Provides-Extra: pyspark
-Requires-Dist: ibis-framework[pyspark]>=9.5.0; extra == "pyspark"
 Provides-Extra: snowflake
 Requires-Dist: ibis-framework[snowflake]>=9.5.0; extra == "snowflake"
 Provides-Extra: sqlite
@@ -83,6 +83,7 @@ Requires-Dist: nbformat>=5.10.4; extra == "docs"
 Requires-Dist: quartodoc>=0.8.1; python_version >= "3.9" and extra == "docs"
 Requires-Dist: pandas>=2.2.3; extra == "docs"
 Requires-Dist: polars>=1.17.1; extra == "docs"
+Requires-Dist: pyspark==3.5.6; extra == "docs"
 Dynamic: license-file
 
 <div align="center">
@@ -236,6 +237,48 @@ validation.get_step_report(i=3).show("browser")  # Get failing records from step
 
 <br>
 
+## YAML Configuration
+
+For teams that need portable, version-controlled validation workflows, Pointblank supports YAML configuration files. This makes it easy to share validation logic across different environments and team members, ensuring everyone is on the same page.
+
+**validation.yaml**
+
+```yaml
+validate:
+  data: small_table
+  tbl_name: "small_table"
+  label: "Getting started validation"
+
+steps:
+  - col_vals_gt:
+      columns: "d"
+      value: 100
+  - col_vals_le:
+      columns: "c"
+      value: 5
+  - col_exists:
+      columns: ["date", "date_time"]
+```
+
+**Execute the YAML validation**
+
+```python
+import pointblank as pb
+
+# Run validation from YAML configuration
+validation = pb.yaml_interrogate("validation.yaml")
+
+# Get the results just like any other validation
+validation.get_tabular_report().show()
+```
+
+This approach is perfect for:
+
+- **CI/CD pipelines**: Store validation rules alongside your code
+- **Team collaboration**: Share validation logic in a readable format
+- **Environment consistency**: Use the same validation across dev, staging, and production
+- **Documentation**: YAML files serve as living documentation of your data quality requirements
+
 ## Command Line Interface (CLI)
 
 Pointblank includes a powerful CLI utility called `pb` that lets you run data validation workflows directly from the command line. Perfect for CI/CD pipelines, scheduled data quality checks, or quick validation tasks.
@@ -263,6 +306,12 @@ pb scan "duckdb:///data/sales.ddb::customers"
 **Run Essential Validations**
 
 ```bash
+# Run validation from YAML configuration file
+pb run validation.yaml
+
+# Run validation from Python file
+pb run validation.py
+
 # Check for duplicate rows
 pb validate small_table --check rows-distinct
 
@@ -279,8 +328,12 @@ pb validate small_table --check col-vals-gt --column a --value 5 --show-extract
 **Integrate with CI/CD**
 
 ```bash
-# Use exit codes for automation (0 = pass, 1 = fail)
+# Use exit codes for automation in one-liner validations (0 = pass, 1 = fail)
 pb validate small_table --check rows-distinct --exit-code
+
+# Run validation workflows with exit codes
+pb run validation.yaml --exit-code
+pb run validation.py --exit-code
 ```
 
 Click the following headings to see some video demonstrations of the CLI:

{pointblank-0.11.6.dist-info → pointblank-0.12.0.dist-info}/RECORD

@@ -1,28 +1,29 @@
-pointblank/__init__.py,sha256=g7KAdNKGj2fPXey_nIev90riUEOSxmqxD2KLXD2IkZY,1856
-pointblank/_constants.py,sha256=xJ4hqLeoTsu07PFGnaSRhS6S5UOGyBg1yKF4_x_Gbtk,81527
+pointblank/__init__.py,sha256=Qt6HEcSoduSkphatxf2Bqy4KNP-wXssRv9zlEslhTJk,1915
+pointblank/_constants.py,sha256=rB8qTnhabwmSQURevHqokC1pp5lfaWMCzhmbMZ0CP8A,81512
 pointblank/_constants_docs.py,sha256=JBmtt16zTYQ-zaM4ElLExtKs-dKlnN553Ys2ML1Y1C8,2099
 pointblank/_constants_translations.py,sha256=HXcCYmKoMjoaFv-Ym4UWv3AsIVXik2zDyAy7xvTvv0Y,186710
 pointblank/_datascan_utils.py,sha256=EMfeabXm_ZsCUKPROB7rFhyOpjtRs8jcnZ_9nBtMyws,1750
-pointblank/_interrogation.py,sha256=U4GQ8Ik5rP75BYBkmunBvHKwf3XvLPHcUx18JwiBQZI,89422
+pointblank/_interrogation.py,sha256=hTC8G0f_FBzEua_u1ZaDZAtbyf4cuJp2B7ss8TDwz-s,95498
 pointblank/_typing.py,sha256=aItbCbzhbzqjK3lCbL27ltRyXoAH1c3-U6xQdRzg-lU,1594
-pointblank/_utils.py,sha256=ttgYKKfufsUAiEBFfmWcejLz8hm6ff88DK_rDzk7VtE,28430
+pointblank/_utils.py,sha256=0UuwPJCJCeo09k9IqZ-oncXAyFvI_1Ntc76CtwbyZYo,29466
 pointblank/_utils_check_args.py,sha256=rFEc1nbCN8ftsQQWVjCNWmQ2QmUDxkfgmoJclrZeTLs,5489
 pointblank/_utils_html.py,sha256=uJWvS9JwQVEZgwsGmScA_u_EBRND75rzUvnJPalbRVs,3731
 pointblank/actions.py,sha256=D6o9B2_ES9PNQg9HZwREacrrt-3A5bhdrBkL1UXz__s,18281
-pointblank/assistant.py,sha256=YsQ9U1wacVIuYFRIJ4maBbBDTzEQPzirhUUPgySosM4,15428
-pointblank/cli.py,sha256=EfmRG9pQMltubcCprIXIbrVLXYWzbS1fQiJIWzLeKVE,228496
+pointblank/assistant.py,sha256=vcdFgXmdVSiylQgTW3e62c13X3vAicBPjyG8OTZXmGM,15902
+pointblank/cli.py,sha256=p2cO-NKInQ41hqRMy6TNmxOj48pR5vq8s7JTLXfcP4M,228188
 pointblank/column.py,sha256=_FJjpjv760D1p6YGgqbwmKYktouG7AJ2A9uIMYQBTYA,76560
 pointblank/compare.py,sha256=kFd18CehHz7g-2MF1kSmJSdOoAP80q_9PaF6QzHC1ds,866
 pointblank/datascan.py,sha256=nmTcRLW8nAZfvRS_Nf00Wgx4oUX-o6WFOZqLDbedbu8,24563
 pointblank/draft.py,sha256=cusr4fBiNncCKIOU8UwvJcvkBeBuUnqH_UfYp9dtNss,15777
 pointblank/scan_profile.py,sha256=lZU5hlnzznDATNn9W3gNdyuFm05WDP8y1RjDJEcE5zg,10426
 pointblank/scan_profile_stats.py,sha256=qdzoGXB-zi2hmpA4mTz6LLTqMnb-NRG9ndxU9cxS72w,4461
-pointblank/schema.py,sha256=d93omncsV2lVbatM_QUFeCfCFA42WPZcgO_kE-ktjfU,45107
+pointblank/schema.py,sha256=vwGF8UKy2riRSQzcwatcI6L0t_6ccdbOayrKonvyodE,45777
+pointblank/segments.py,sha256=RXp3lPr3FboVseadNqLgIeoMBh_mykrQSFp1WtV41Yg,5570
 pointblank/tf.py,sha256=8o_8m4i01teulEe3-YYMotSNf3tImjBMInsvdjSAO5Q,8844
 pointblank/thresholds.py,sha256=mybeLzTVdmN04NLKoV-jiSBXsWknwHO0Gox0ttVN_MU,25766
-pointblank/validate.py,sha256=CelY6wwB1JRyii-KWEyKfiazd7mToxAegHG1GMtKIm4,680332
+pointblank/validate.py,sha256=0AP7Dm9HH0i-gnlZ_d9Wg1abovpO6tPLE3Sn1z7ju0Y,693119
 pointblank/yaml.py,sha256=4DrkOJwCQ3CaXQ7ESNIW72pp-dL1ctlX6ONU30Vh1Fs,57901
-pointblank/data/api-docs.txt,sha256=_mKEb3zuI6TR0bPNkpr5Y-GUtbB3Qv5WESR7MFuL06I,506515
+pointblank/data/api-docs.txt,sha256=0wXk__xYwgKeS24ZjbaTPFeJ3ZO7AIyMQoFClCcvPTc,529897
 pointblank/data/game_revenue-duckdb.zip,sha256=tKIVx48OGLYGsQPS3h5AjA2Nyq_rfEpLCjBiFUWhagU,35880
 pointblank/data/game_revenue.zip,sha256=7c9EvHLyi93CHUd4p3dM4CZ-GucFCtXKSPxgLojL32U,33749
 pointblank/data/global_sales-duckdb.zip,sha256=2ok_cvJ1ZuSkXnw0R6_OkKYRTWhJ-jJEMq2VYsv5fqY,1336390
@@ -32,9 +33,9 @@ pointblank/data/nycflights.zip,sha256=yVjbUaKUz2LydSdF9cABuir0VReHBBgV7shiNWSd0m
 pointblank/data/polars-api-docs.txt,sha256=KGcS-BOtUs9zgpkWfXD-GFdFh4O_zjdkpX7msHjztLg,198045
 pointblank/data/small_table-duckdb.zip,sha256=BhTaZ2CRS4-9Z1uVhOU6HggvW3XCar7etMznfENIcOc,2028
 pointblank/data/small_table.zip,sha256=lmFb90Nb-v5X559Ikjg31YLAXuRyMkD9yLRElkXPMzQ,472
-pointblank-0.11.6.dist-info/licenses/LICENSE,sha256=apLF-HWPNU7pT5bmf5KmZpD5Cklpy2u-BN_0xBoRMLY,1081
-pointblank-0.11.6.dist-info/METADATA,sha256=ni-fTo_hxUkYWEsW2qmncCPnpeyfh6me5aqexPcxXSA,17777
-pointblank-0.11.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pointblank-0.11.6.dist-info/entry_points.txt,sha256=GqqqOTOH8uZe22wLcvYjzpizqk_j4MNcUo2YM14ryCw,42
-pointblank-0.11.6.dist-info/top_level.txt,sha256=-wHrS1SvV8-nhvc3w-PPYs1C1WtEc1pK-eGjubbCCKc,11
-pointblank-0.11.6.dist-info/RECORD,,
+pointblank-0.12.0.dist-info/licenses/LICENSE,sha256=apLF-HWPNU7pT5bmf5KmZpD5Cklpy2u-BN_0xBoRMLY,1081
+pointblank-0.12.0.dist-info/METADATA,sha256=eKVOvRdSQMDFuvOKyMjHZ4s5P3vsVmQaqO7lZCR7P3g,19246
+pointblank-0.12.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pointblank-0.12.0.dist-info/entry_points.txt,sha256=GqqqOTOH8uZe22wLcvYjzpizqk_j4MNcUo2YM14ryCw,42
+pointblank-0.12.0.dist-info/top_level.txt,sha256=-wHrS1SvV8-nhvc3w-PPYs1C1WtEc1pK-eGjubbCCKc,11
+pointblank-0.12.0.dist-info/RECORD,,