pointblank 0.13.3__py3-none-any.whl → 0.14.0__py3-none-any.whl

{pointblank-0.13.3.dist-info → pointblank-0.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pointblank
-Version: 0.13.3
+Version: 0.14.0
 Summary: Find out if your data is what you think it is.
 Author-email: Richard Iannone <riannone@me.com>
 License: MIT License
@@ -42,7 +42,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: commonmark>=0.9.1
 Requires-Dist: importlib-metadata
-Requires-Dist: great_tables>=0.17.0
+Requires-Dist: great_tables>=0.19.0
 Requires-Dist: narwhals>=2.0.1
 Requires-Dist: typing_extensions>=3.10.0.0
 Requires-Dist: requests>=2.31.0
@@ -132,13 +132,63 @@ _Data validation made beautiful and powerful_
    <a href="translations/README.ar.md">العربية</a>
 </div>
 
-## What is Pointblank?
+<br>
+
+Pointblank takes a different approach to data quality. It doesn't have to be a tedious technical task. Rather, it can become a process focused on clear communication between team members. While other validation libraries focus solely on catching errors, Pointblank is great at both **finding issues and sharing insights**. Our beautiful, customizable reports turn validation results into conversations with stakeholders, making data quality issues immediately understandable and actionable for everyone on your team.
+
+**Get started in minutes, not hours.** Pointblank's AI-powered [`DraftValidation`](https://posit-dev.github.io/pointblank/user-guide/draft-validation.html) feature analyzes your data and suggests intelligent validation rules automatically. So there's no need to stare at an empty validation script wondering where to begin. Pointblank can kickstart your data quality journey so you can focus on what matters most.
+
+Whether you're a data scientist who needs to quickly communicate data quality findings, a data engineer building robust pipelines, or an analyst presenting data quality results to business stakeholders, Pointblank helps you to turn data quality from an afterthought into a competitive advantage.
+
+## Getting Started with AI-Powered Validation Drafting
+
+The `DraftValidation` class uses LLMs to analyze your data and generate a complete validation plan with intelligent suggestions. This helps you quickly get started with data validation or jumpstart a new project.
+
+```python
+import pointblank as pb
 
-Pointblank is a powerful, yet elegant data validation framework for Python that transforms how you ensure data quality. With its intuitive, chainable API, you can quickly validate your data against comprehensive quality checks and visualize results through stunning, interactive reports that make data issues immediately actionable.
+# Load your data
+data = pb.load_dataset("game_revenue")              # A sample dataset
 
-Whether you're a data scientist, data engineer, or analyst, Pointblank helps you catch data quality issues before they impact your analyses or downstream systems.
+# Use DraftValidation to generate a validation plan
+pb.DraftValidation(data=data, model="anthropic:claude-sonnet-4-5")
+```
 
-## Getting Started in 30 Seconds
+The output is a complete validation plan with intelligent suggestions based on your data:
+
+```python
+import pointblank as pb
+
+# The validation plan
+validation = (
+    pb.Validate(
+        data=data,
+        label="Draft Validation",
+        thresholds=pb.Thresholds(warning=0.10, error=0.25, critical=0.35)
+    )
+    .col_vals_in_set(columns="item_type", set=["iap", "ad"])
+    .col_vals_gt(columns="item_revenue", value=0)
+    .col_vals_between(columns="session_duration", left=3.2, right=41.0)
+    .col_count_match(count=11)
+    .row_count_match(count=2000)
+    .rows_distinct()
+    .interrogate()
+)
+
+validation
+```
+
+<div align="center">
+<img src="https://posit-dev.github.io/pointblank/assets/pointblank-draft-validation-report.png" width="800px">
+</div>
+
+<br>
+
+Copy, paste, and customize the generated validation plan for your needs.
+
+## Chainable Validation API
+
+Pointblank's chainable API makes validation simple and readable. The same pattern always applies: (1) start with `Validate`, (2) add validation steps, and (3) finish with `interrogate()`.
 
 ```python
 import pointblank as pb
@@ -164,6 +214,12 @@ validation
 
 <br>
 
+Once you have an interrogated `validation` object, you can leverage a variety of methods to extract insights like:
+
+- getting detailed reports for single steps to see what went wrong
+- filtering tables based on validation results
+- extracting problematic data for debugging
+
 ## Why Choose Pointblank?
 
 - **Works with your existing stack**: Seamlessly integrates with Polars, Pandas, DuckDB, MySQL, PostgreSQL, SQLite, Parquet, PySpark, Snowflake, and more!
@@ -172,7 +228,9 @@ validation
 - **Threshold-based alerts**: Set 'warning', 'error', and 'critical' thresholds with custom actions
 - **Practical outputs**: Use validation results to filter tables, extract problematic data, or trigger downstream processes
 
-## Real-World Example
+## Production-Ready Validation Pipeline
+
+Here's how Pointblank handles complex, real-world scenarios with advanced features like threshold management, automated alerts, and comprehensive business rule validation:
 
 ```python
 import pointblank as pb
@@ -280,7 +338,7 @@ validation = pb.yaml_interrogate("validation.yaml")
 validation.get_tabular_report().show()
 ```
 
-This approach is perfect for:
+This approach is suitable for:
 
 - **CI/CD pipelines**: Store validation rules alongside your code
 - **Team collaboration**: Share validation logic in a readable format

pointblank-0.14.0.dist-info/RECORD

@@ -0,0 +1,55 @@
+pointblank/__init__.py,sha256=Nspcpnj_w940huEDBNcS5_lHpWsQif8t0gLst4dmZTs,1942
+pointblank/_constants.py,sha256=HR1V-A-flMY17qlBQQf7SbCxBtbCugQUlh3WHzwuqys,84010
+pointblank/_constants_translations.py,sha256=2ux_qFW7JZ65-0VOjlhlTQ7Ts8FlCNYqp3SneuTOCmk,242476
+pointblank/_datascan_utils.py,sha256=EMfeabXm_ZsCUKPROB7rFhyOpjtRs8jcnZ_9nBtMyws,1750
+pointblank/_interrogation.py,sha256=wNCBRGwYUdk64OC56juM_Kx2fW2Z5wIK-oamnSyT20c,83655
+pointblank/_typing.py,sha256=aItbCbzhbzqjK3lCbL27ltRyXoAH1c3-U6xQdRzg-lU,1594
+pointblank/_utils.py,sha256=NFQsIrW3dZ7IzCloiwgVblr0-7eg-OigLEq7W1lUuyo,31948
+pointblank/_utils_ai.py,sha256=I7Oe3Ojm1t_haBii17v6s4IemkBDWvKFMVxX8UCY67Q,30228
+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=vcdFgXmdVSiylQgTW3e62c13X3vAicBPjyG8OTZXmGM,15902
+pointblank/cli.py,sha256=hRVPdjU4dxZZ4XdWN2A7OEnsvWB15dXFPn-Chhi7tNs,229394
+pointblank/column.py,sha256=943ADTk8rCAs0KEihVYONgJqXUP5uwKx5oMEJnpG4VU,76801
+pointblank/compare.py,sha256=kFd18CehHz7g-2MF1kSmJSdOoAP80q_9PaF6QzHC1ds,866
+pointblank/datascan.py,sha256=xFhpcoLD16mJH_yhMm0NbCa5VUk5cz3iazn5RfNXlao,24710
+pointblank/draft.py,sha256=cusr4fBiNncCKIOU8UwvJcvkBeBuUnqH_UfYp9dtNss,15777
+pointblank/scan_profile.py,sha256=Zy-qyqggod0mP1PcES6qTxIaENkxT-FTNM8LWFVhRD0,10546
+pointblank/scan_profile_stats.py,sha256=qdzoGXB-zi2hmpA4mTz6LLTqMnb-NRG9ndxU9cxS72w,4461
+pointblank/schema.py,sha256=yir-2VNmHyNdH1vGpx3adqOXdvspJlMKhJmJQz4egqU,48794
+pointblank/segments.py,sha256=RXp3lPr3FboVseadNqLgIeoMBh_mykrQSFp1WtV41Yg,5570
+pointblank/thresholds.py,sha256=KhvCCB_rlUHq1RjZ6SxXZLVrolOn_D2Ppxb0ABnwCRw,25764
+pointblank/validate.py,sha256=EDCGjKTX8BNuODY-yAGYzbFtHb_d9bf5m_2PXv9koTg,772558
+pointblank/yaml.py,sha256=cHwDvybhp_oLOGR1rA83trEDQWYuRGhT4iEa6FMXi6w,63074
+pointblank/data/api-docs.txt,sha256=p1OdPXjlVUz5XnWyjqB3I-jXRh1hWo96qJYBGhDOYwU,537590
+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
+pointblank/data/global_sales.zip,sha256=JeUnR1apKQ35PPwEcvTKCEIEiYeYQtoGmYjmzbz99DM,2138604
+pointblank/data/nycflights-duckdb.zip,sha256=GQrHO9tp7d9cNGFNSbA9EKF19MLf6t2wZE0U9-hIKow,5293077
+pointblank/data/nycflights.zip,sha256=yVjbUaKUz2LydSdF9cABuir0VReHBBgV7shiNWSd0mU,7828965
+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/data/validations/README.md,sha256=K_krlaGTBgE-NrdfHCvUJqaP40Wnb9gNGAh5tM53e9o,4292
+pointblank/data/validations/complex_preprocessing.json,sha256=oqGk38WUze8qJsUTUx6_bD6VaOvOFTwJq1J3-gdHzE0,2040
+pointblank/data/validations/complex_preprocessing.pkl,sha256=gyP87mnTL2POrZy1iM0AzvsozRwgh24VzVRpBy_knsM,7836
+pointblank/data/validations/generate_test_files.py,sha256=roJo9Su16ix_oV44V_s5ucIZKqdTJMckslecKWOUvDc,4203
+pointblank/data/validations/multiple_steps.json,sha256=ijbQfUThuovZVl4FJ9hzSiCvrb_A5N1bIDqf_D-E_gA,2544
+pointblank/data/validations/multiple_steps.pkl,sha256=GfnvQQQlaSE3SsI8uDQ3oMI4ugVyAqRFIdDdJI3BeqQ,10415
+pointblank/data/validations/narwhals_function.json,sha256=3V3lxipH1R1Gfmodd26EdILc69Hql4Nr3M99JqecyAg,872
+pointblank/data/validations/narwhals_function.pkl,sha256=KU0UjbTv75JaF2tWXe6OpIyd0Dnv17TFmXPoBxvqdF4,3478
+pointblank/data/validations/no_preprocessing.json,sha256=njU41sUbMUWm05FXgj_o2NBzBmgrvYp00Sz9qFGgTbA,2120
+pointblank/data/validations/no_preprocessing.pkl,sha256=VmoEsS7dO_1VHfseJaRyXJu552xhKpOIqqd7BWIPoLI,9124
+pointblank/data/validations/pandas_compatible.json,sha256=fduquqJCUyLKlTpZM7amgkmEiB9j14FdU4k4kson3Qk,1019
+pointblank/data/validations/pandas_compatible.pkl,sha256=-85iBWKH_SYu8oq1752pAMKyHqJ7VHvvz0etXfoUUjg,4743
+pointblank/data/validations/preprocessing_functions.py,sha256=DudTuQVGzEnZb0UYBaPou08ad3dmdxfcOZuPMkdM6A0,1422
+pointblank/data/validations/simple_preprocessing.json,sha256=2aBnY2fmrIwlIbEprzqxYoZtsJbQ8o0VBjnuDo_dTqo,1546
+pointblank/data/validations/simple_preprocessing.pkl,sha256=Arp9DHWbZVYbaLR7Xg-poZyvOgplYaqAQoWD1DohiZw,6785
+pointblank-0.14.0.dist-info/licenses/LICENSE,sha256=apLF-HWPNU7pT5bmf5KmZpD5Cklpy2u-BN_0xBoRMLY,1081
+pointblank-0.14.0.dist-info/METADATA,sha256=YD28gD8Nqk-2fwqTidW5DzP6TeK61KC1QGtitUgD9To,22304
+pointblank-0.14.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pointblank-0.14.0.dist-info/entry_points.txt,sha256=GqqqOTOH8uZe22wLcvYjzpizqk_j4MNcUo2YM14ryCw,42
+pointblank-0.14.0.dist-info/top_level.txt,sha256=-wHrS1SvV8-nhvc3w-PPYs1C1WtEc1pK-eGjubbCCKc,11
+pointblank-0.14.0.dist-info/RECORD,,

pointblank/_constants_docs.py

@@ -1,40 +0,0 @@
-ARG_DOCSTRINGS = {
-    "column": """column
-        The column to validate.""",
-    "columns": """columns
-        A single column or a list of columns to validate. If multiple columns are supplied, there
-        will be a separate validation step generated for each column.""",
-    "value": """value
-        The value to compare against.""",
-    "left": """left
-        The lower bound of the range.""",
-    "right": """right
-        The upper bound of the range.""",
-    "set": """set
-        A list of values to compare against.""",
-    "pattern": """pattern
-        A regular expression pattern to compare against.""",
-    "inclusive": """inclusive
-        A tuple of two boolean values indicating whether the comparison should be inclusive. The
-        position of the boolean values correspond to the `left=` and `right=` values, respectively.
-        By default, both values are `True`.""",
-    "na_pass": """na_pass
-        Should any encountered None, NA, or Null values be considered as passing test units? By
-        default, this is `False`. Set to `True` to pass test units with missing values.""",
-    "pre": """pre
-        A preprocessing function or lambda to apply to the data table for the validation step.""",
-    "thresholds": """thresholds
-        Failure threshold levels so that the validation step can react accordingly when exceeding
-        the set levels for different states ('warning', 'error', and 'critical'). This can be
-        created simply as an integer or float denoting the absolute number or fraction of failing
-        test units for the 'warning' level. Otherwise, you can use a tuple of 1-3 values, a
-        dictionary of 1-3 entries, or a Thresholds object.""",
-    "active": """active
-        A boolean value indicating whether the validation step should be active. Using `False` will
-        make the validation step inactive (still reporting its presence and keeping indexes for the
-        steps unchanged).""",
-    "data": """data
-        A data table.""",
-    "threshold": """threshold
-        The maximum number of failing test units to allow.""",
-}

pointblank-0.13.3.dist-info/RECORD

@@ -1,40 +0,0 @@
-pointblank/__init__.py,sha256=IZ-JwGWr2DOFBfq4XvE0SzceWMkFewtBN10V4F9pIGg,1876
-pointblank/_constants.py,sha256=HHiGuso_To-PsKQLxVDYa_Iczy92iPoIYurTy6BAtL4,80778
-pointblank/_constants_docs.py,sha256=JBmtt16zTYQ-zaM4ElLExtKs-dKlnN553Ys2ML1Y1C8,2099
-pointblank/_constants_translations.py,sha256=NBVGX9veULXMwEHwSrlzpCpM9hcFeyS1xBmyBt_8_mU,190053
-pointblank/_datascan_utils.py,sha256=EMfeabXm_ZsCUKPROB7rFhyOpjtRs8jcnZ_9nBtMyws,1750
-pointblank/_interrogation.py,sha256=FbzFa_QJIYQjH0l4D6XaMW73r71gwMrfA8lXiF4r2a4,76540
-pointblank/_typing.py,sha256=aItbCbzhbzqjK3lCbL27ltRyXoAH1c3-U6xQdRzg-lU,1594
-pointblank/_utils.py,sha256=ikgkFomoAEOxaiItHZUo3NTHu0MJHWfKAF_fnX9rRnA,30685
-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=vcdFgXmdVSiylQgTW3e62c13X3vAicBPjyG8OTZXmGM,15902
-pointblank/cli.py,sha256=p2cO-NKInQ41hqRMy6TNmxOj48pR5vq8s7JTLXfcP4M,228188
-pointblank/column.py,sha256=w41CBg3lt3ZzKS_j-SYdkRmnOWcP5xXa0rRjsPVRE_M,76781
-pointblank/compare.py,sha256=kFd18CehHz7g-2MF1kSmJSdOoAP80q_9PaF6QzHC1ds,866
-pointblank/datascan.py,sha256=tQiwe9x0jAbK9OJLQe53R_qRl2uBKireaWsMlM8K1sw,24630
-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=hjALMuYppNfELC_nAqfM9fLjPdN1w2M3rDMusrPqFYA,50757
-pointblank/segments.py,sha256=RXp3lPr3FboVseadNqLgIeoMBh_mykrQSFp1WtV41Yg,5570
-pointblank/thresholds.py,sha256=mybeLzTVdmN04NLKoV-jiSBXsWknwHO0Gox0ttVN_MU,25766
-pointblank/validate.py,sha256=v4jzFOYufrck_3CPIz4Jo53Y_5VYYTTFcqMq6B4LttY,713196
-pointblank/yaml.py,sha256=cHwDvybhp_oLOGR1rA83trEDQWYuRGhT4iEa6FMXi6w,63074
-pointblank/data/api-docs.txt,sha256=w2nIkIL_fJpXlPR9clogqcgdiv-uHvdSDI8gjkP_mCQ,531711
-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
-pointblank/data/global_sales.zip,sha256=JeUnR1apKQ35PPwEcvTKCEIEiYeYQtoGmYjmzbz99DM,2138604
-pointblank/data/nycflights-duckdb.zip,sha256=GQrHO9tp7d9cNGFNSbA9EKF19MLf6t2wZE0U9-hIKow,5293077
-pointblank/data/nycflights.zip,sha256=yVjbUaKUz2LydSdF9cABuir0VReHBBgV7shiNWSd0mU,7828965
-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.13.3.dist-info/licenses/LICENSE,sha256=apLF-HWPNU7pT5bmf5KmZpD5Cklpy2u-BN_0xBoRMLY,1081
-pointblank-0.13.3.dist-info/METADATA,sha256=jXGDWi-DW5kAdRyUTjgVfRTB-6tMgyYd-uqeeyCvvKk,19582
-pointblank-0.13.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pointblank-0.13.3.dist-info/entry_points.txt,sha256=GqqqOTOH8uZe22wLcvYjzpizqk_j4MNcUo2YM14ryCw,42
-pointblank-0.13.3.dist-info/top_level.txt,sha256=-wHrS1SvV8-nhvc3w-PPYs1C1WtEc1pK-eGjubbCCKc,11
-pointblank-0.13.3.dist-info/RECORD,,