pointblank 0.8.6__tar.gz → 0.9.0__tar.gz

{pointblank-0.8.6 → pointblank-0.9.0}/.github/workflows/ci-tests.yaml

@@ -29,7 +29,7 @@ jobs:
           pip install -e '.[dev]'
       - name: Install test dependencies
         run: |
-          pip install pytest pytest-cov pytest-snapshot pandas polars ibis-framework[duckdb,mysql,postgres,sqlite]>=9.5.0 chatlas requests shiny
+          pip install pytest pytest-rerunfailures pytest-randomly pytest-xdist pytest-cov pytest-snapshot pandas polars ibis-framework[duckdb,mysql,postgres,sqlite]>=9.5.0 chatlas requests shiny
       - name: pytest unit tests
         run: |
           make test

{pointblank-0.8.6 → pointblank-0.9.0}/Makefile

@@ -1,13 +1,18 @@
 .PHONY: check
 
+.PHONY: test
 test:
-	pytest --cov=pointblank --cov-report=xml
+	@pytest \
+		--cov=pointblank \
+		--cov-report=term-missing \
+		--randomly-seed 123 \
+		-n auto \
+		--reruns 3 \
+		--reruns-delay 1
 
 test-update:
 	pytest --snapshot-update
 
-test-coverage:
-	pytest --cov=pointblank --cov-report=term-missing
 
 lint: ## Run ruff formatter and linter
 	@uv run ruff format

{pointblank-0.8.6 → pointblank-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pointblank
-Version: 0.8.6
+Version: 0.9.0
 Summary: Find out if your data is what you think it is.
 Author-email: Richard Iannone <riannone@me.com>
 License: MIT License
@@ -89,6 +89,7 @@ _Data validation made beautiful and powerful_
 [![Python Versions](https://img.shields.io/pypi/pyversions/pointblank.svg)](https://pypi.python.org/pypi/pointblank)
 [![PyPI](https://img.shields.io/pypi/v/pointblank)](https://pypi.org/project/pointblank/#history)
 [![PyPI Downloads](https://img.shields.io/pypi/dm/pointblank)](https://pypistats.org/packages/pointblank)
+[![Conda Version](https://img.shields.io/conda/vn/conda-forge/pointblank.svg)](https://anaconda.org/conda-forge/pointblank)
 [![License](https://img.shields.io/github/license/posit-dev/pointblank)](https://img.shields.io/github/license/posit-dev/pointblank)
 
 [![CI Build](https://github.com/posit-dev/pointblank/actions/workflows/ci-tests.yaml/badge.svg)](https://github.com/posit-dev/pointblank/actions/workflows/ci-tests.yaml)
@@ -102,9 +103,21 @@ _Data validation made beautiful and powerful_
 
 </div>
 
+<div align="right">
+   <a href="translations/README.fr.md">Français</a> |
+   <a href="translations/README.de.md">Deutsch</a> |
+   <a href="translations/README.it.md">Italiano</a> |
+   <a href="translations/README.es.md">Español</a> |
+   <a href="translations/README.pt-BR.md">Português</a> |
+   <a href="translations/README.nl.md">Nederlands</a> |
+   <a href="translations/README.zh-CN.md">简体中文</a> |
+   <a href="translations/README.ja.md">日本語</a> |
+   <a href="translations/README.ko.md">한국어</a>
+</div>
+
 ## What is Pointblank?
 
-Pointblank is a modern data validation framework for Python that helps you trust your data with confidence. It provides a fluent, expressive API to validate your data against a wide range of constraints and presents results in beautiful, interactive reports.
+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.
 
 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.
 
@@ -134,9 +147,9 @@ validation
 
 <br>
 
-Why Choose Pointblank?
+## Why Choose Pointblank?
 
-- **Works with your existing stack** - Seamlessly integrates with Polars, Pandas, DuckDB, MySQL, PostgreSQL, SQLite, Parquet, and more!
+- **Works with your existing stack** - Seamlessly integrates with Polars, Pandas, DuckDB, MySQL, PostgreSQL, SQLite, Parquet, PySpark, Snowflake, and more!
 - **Beautiful, interactive reports** - Crystal-clear validation results that highlight issues and help communicate data quality
 - **Composable validation pipeline** - Chain validation steps into a complete data quality workflow
 - **Threshold-based alerts** - Set 'warning', 'error', and 'critical' thresholds with custom actions
@@ -213,6 +226,8 @@ validation.get_step_report(i=3).show("browser")  # Get failing records from step
 <img src="https://posit-dev.github.io/pointblank/assets/pointblank-step-report.png" width="800px">
 </div>
 
+<br>
+
 ## Features That Set Pointblank Apart
 
 - **Complete validation workflow** - From data access to validation to reporting in a single pipeline

{pointblank-0.8.6 → pointblank-0.9.0}/README.md

@@ -7,6 +7,7 @@ _Data validation made beautiful and powerful_
 [![Python Versions](https://img.shields.io/pypi/pyversions/pointblank.svg)](https://pypi.python.org/pypi/pointblank)
 [![PyPI](https://img.shields.io/pypi/v/pointblank)](https://pypi.org/project/pointblank/#history)
 [![PyPI Downloads](https://img.shields.io/pypi/dm/pointblank)](https://pypistats.org/packages/pointblank)
+[![Conda Version](https://img.shields.io/conda/vn/conda-forge/pointblank.svg)](https://anaconda.org/conda-forge/pointblank)
 [![License](https://img.shields.io/github/license/posit-dev/pointblank)](https://img.shields.io/github/license/posit-dev/pointblank)
 
 [![CI Build](https://github.com/posit-dev/pointblank/actions/workflows/ci-tests.yaml/badge.svg)](https://github.com/posit-dev/pointblank/actions/workflows/ci-tests.yaml)
@@ -20,9 +21,21 @@ _Data validation made beautiful and powerful_
 
 </div>
 
+<div align="right">
+   <a href="translations/README.fr.md">Français</a> |
+   <a href="translations/README.de.md">Deutsch</a> |
+   <a href="translations/README.it.md">Italiano</a> |
+   <a href="translations/README.es.md">Español</a> |
+   <a href="translations/README.pt-BR.md">Português</a> |
+   <a href="translations/README.nl.md">Nederlands</a> |
+   <a href="translations/README.zh-CN.md">简体中文</a> |
+   <a href="translations/README.ja.md">日本語</a> |
+   <a href="translations/README.ko.md">한국어</a>
+</div>
+
 ## What is Pointblank?
 
-Pointblank is a modern data validation framework for Python that helps you trust your data with confidence. It provides a fluent, expressive API to validate your data against a wide range of constraints and presents results in beautiful, interactive reports.
+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.
 
 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.
 
@@ -52,9 +65,9 @@ validation
 
 <br>
 
-Why Choose Pointblank?
+## Why Choose Pointblank?
 
-- **Works with your existing stack** - Seamlessly integrates with Polars, Pandas, DuckDB, MySQL, PostgreSQL, SQLite, Parquet, and more!
+- **Works with your existing stack** - Seamlessly integrates with Polars, Pandas, DuckDB, MySQL, PostgreSQL, SQLite, Parquet, PySpark, Snowflake, and more!
 - **Beautiful, interactive reports** - Crystal-clear validation results that highlight issues and help communicate data quality
 - **Composable validation pipeline** - Chain validation steps into a complete data quality workflow
 - **Threshold-based alerts** - Set 'warning', 'error', and 'critical' thresholds with custom actions
@@ -131,6 +144,8 @@ validation.get_step_report(i=3).show("browser")  # Get failing records from step
 <img src="https://posit-dev.github.io/pointblank/assets/pointblank-step-report.png" width="800px">
 </div>
 
+<br>
+
 ## Features That Set Pointblank Apart
 
 - **Complete validation workflow** - From data access to validation to reporting in a single pipeline

{pointblank-0.8.6 → pointblank-0.9.0}/docs/blog/intro-pointblank/index.qmd

@@ -3,7 +3,7 @@ jupyter: python3
 html-table-processing: none
 title: "Introducing Pointblank"
 author: Rich Iannone
-date: 2024-04-04
+date: 2025-04-04
 freeze: true
 ---
 

{pointblank-0.8.6 → pointblank-0.9.0}/docs/demos/02-advanced/index.qmd

@@ -15,7 +15,6 @@ A validation with a comprehensive set of rules.
 
 import pointblank as pb
 import polars as pl
-import narwhals as nw
 
 validation = (
     pb.Validate(
@@ -52,7 +51,6 @@ validation
 ```python
 import pointblank as pb
 import polars as pl
-import narwhals as nw
 
 validation = (
     pb.Validate(

{pointblank-0.8.6 → pointblank-0.9.0}/docs/index.qmd

@@ -11,7 +11,7 @@ _Data validation made beautiful and powerful_
 
 </div>
 
-Pointblank is a modern data validation framework for Python that helps you trust your data with confidence. It provides a fluent, expressive API to validate your data against a wide range of constraints and presents results in beautiful, interactive reports.
+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.
 
 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.
 

{pointblank-0.8.6 → pointblank-0.9.0}/docs/styles.css

@@ -17,6 +17,17 @@ p a {
     text-underline-offset: 4px;
 }
 
+li a {
+    color: black;
+    text-underline-offset: 4px;
+}
+
+dt {
+    height: 32px;
+    overflow-x: scroll;
+    margin-left: -4px;
+}
+
 .table td {
     padding-left: 0px;
 }

{pointblank-0.8.6 → pointblank-0.9.0}/docs/user-guide/actions.qmd

@@ -222,3 +222,172 @@ The metadata dictionary contains the following fields for a given validation ste
 - `level_num`: The severity level as a numeric value (`30`, `40`, or `50`).
 - `autobrief`: A localized and brief statement of the expectation for the step.
 - `failure_text`: Localized text that explains how the validation step failed.
+
+## Final Actions with `FinalActions`
+
+When you need to execute actions after all validation steps are complete, Pointblank provides the
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html) class. Unlike
+[`Actions`](https://posit-dev.github.io/pointblank/reference/Actions.html) which triggers on a
+per-step basis during the validation process,
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html) executes after
+the entire validation is complete, giving you a way to respond to the overall validation results.
+
+Here's how to use
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html):
+
+```{python}
+import pointblank as pb
+
+def send_alert():
+    summary = pb.get_validation_summary()
+    if summary["highest_severity"] == "critical":
+        print(f"ALERT: Critical validation failures found in `{summary['tbl_name']}`")
+
+validation_with_final = (
+    pb.Validate(
+        data=pb.load_dataset(dataset="game_revenue", tbl_type="duckdb"),
+        tbl_name="game_revenue",
+        thresholds=pb.Thresholds(warning=0.05, error=0.10, critical=0.15),
+        final_actions=pb.FinalActions(
+            "Validation complete.",  # a string message
+            send_alert               # a callable function
+        )
+    )
+    .col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}\d{3}")
+    .col_vals_gt(columns="item_revenue", value=0.10)
+    .interrogate()
+)
+
+validation_with_final
+```
+
+In this example:
+
+- We define the function `send_alert()` that checks the validation summary for critical failures
+- We provide a simple string message `"Validation complete."` that will print to the console
+- Both actions will execute in order after all validation steps have completed
+
+Because the 'critical' threshold was exceeded in Step 2, we see the printed alert of `send_alert()`
+after the simple string message.
+
+### Creating Final Actions
+
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html) accepts any
+number of actions as positional arguments. Each argument can be:
+
+1. **String**: A message to be displayed in the console
+2. **Callable**: A function to be called with no arguments
+3. **List of Strings/Callables**: Multiple actions to execute in sequence
+
+All actions will be executed in the order they are provided after all validation steps have
+completed.
+
+### Using `get_validation_summary()` in Final Actions
+
+When creating a callable function to use with
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html), you can access
+information about the overall validation results using the
+[`get_validation_summary()`](https://posit-dev.github.io/pointblank/reference/get_validation_summary.html)
+function. This gives you a dictionary with comprehensive information about the validation:
+
+```python
+def comprehensive_report():
+    summary = pb.get_validation_summary()
+    print(f"Validation Report for {summary['tbl_name']}:")
+    print(f"- Steps: {summary['n_steps']}")
+    print(f"- Passing steps: {summary['n_passing_steps']}")
+    print(f"- Failing steps: {summary['n_failing_steps']}")
+
+    # Take additional actions based on results
+    if summary["n_failing_steps"] > 0:
+        # Create and execute a Slack notification
+        notify = pb.send_slack_notification(
+            webhook_url="https://hooks.slack.com/services/your/webhook/url",
+            summary_msg="""
+            🚨 *Validation Failure Alert*
+            • Table: {tbl_name}
+            • Failed Steps: {n_failing_steps} of {n_steps}
+            • Highest Severity: {highest_severity}
+            • Time: {time}
+            """,
+        )
+        notify()  # Execute the notification function
+
+
+validation = (
+    pb.Validate(
+        data=pb.load_dataset(dataset="game_revenue", tbl_type="duckdb"),
+        tbl_name="game_revenue",
+        final_actions=pb.FinalActions(comprehensive_report),
+    )
+    .col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}\d{3}")
+    .col_vals_gt(columns="item_revenue", value=0.05)
+    .interrogate()
+)
+
+validation
+```
+
+```{python}
+# | echo: false
+
+validation = (
+    pb.Validate(
+        data=pb.load_dataset(dataset="game_revenue", tbl_type="duckdb"),
+        tbl_name="game_revenue",
+    )
+    .col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}\d{3}")
+    .col_vals_gt(columns="item_revenue", value=0.05)
+    .interrogate()
+)
+
+validation
+```
+
+Here we used the [`send_slack_notification()`](https://posit-dev.github.io/pointblank/reference/send_slack_notification.html)
+function, which is available in Pointblank as a pre-built action. It can be used by itself in
+`final_actions=` but here it's integrated into the user's `comprehensive_report()` function.
+
+### Combining the Two Types of Actions
+
+You can use both [`Actions`](https://posit-dev.github.io/pointblank/reference/Actions.html) and
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html) together for
+comprehensive validation control:
+
+```{python}
+def log_step_failure():
+    m = pb.get_action_metadata()
+    print(f"Step {m['step']} failed with {m['level']}")
+
+
+def generate_summary():
+    summary = pb.get_validation_summary()
+    # Sum up total failed test units across all steps
+    total_failed = sum(summary["dict_n_failed"].values())
+    # Sum up total test units across all steps
+    total_units = sum(summary["dict_n"].values())
+    print(f"Validation complete: {total_failed} failures out of {total_units} tests")
+
+
+validation_combined = (
+    pb.Validate(
+        data=pb.load_dataset(dataset="game_revenue", tbl_type="duckdb"),
+        thresholds=pb.Thresholds(warning=0.05, error=0.10),
+        actions=pb.Actions(default=log_step_failure),
+        final_actions=pb.FinalActions(generate_summary),
+    )
+    .col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}\d{3}")
+    .col_vals_gt(columns="item_revenue", value=0.05)
+    .interrogate()
+)
+```
+
+This approach allows you to:
+
+1. Log individual step failures during the validation process using
+[`Actions`](https://posit-dev.github.io/pointblank/reference/Actions.html)
+2. Generate a comprehensive report after all validation steps are complete using
+[`FinalActions`](https://posit-dev.github.io/pointblank/reference/FinalActions.html)
+
+Using both action types gives you fine-grained control over when and how notifications and other
+actions are triggered in your validation workflow.

{pointblank-0.8.6 → pointblank-0.9.0}/pointblank/_constants.py

@@ -126,6 +126,7 @@ VALIDATION_REPORT_FIELDS = [
     "inclusive",
     "na_pass",
     "pre",
+    "segments",
     "thresholds",
     "label",
     "brief",
@@ -231,9 +232,9 @@ SVG_ICONS_FOR_ASSERTION_TYPES = {
 </svg>""",
     "col_vals_eq": """<?xml version="1.0" encoding="UTF-8"?>
 <svg width="67px" height="67px" viewBox="0 0 67 67" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-    <title>col_vals_equal</title>
+    <title>col_vals_eq</title>
     <g id="All-Icons" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g id="col_vals_equal" transform="translate(0.000000, 0.275862)">
+        <g id="col_vals_eq" transform="translate(0.000000, 0.275862)">
             <path d="M56.712234,1 C59.1975153,1 61.4475153,2.00735931 63.076195,3.63603897 C64.7048747,5.26471863 65.712234,7.51471863 65.712234,10 L65.712234,10 L65.712234,65 L10.712234,65 C8.22695259,65 5.97695259,63.9926407 4.34827294,62.363961 C2.71959328,60.7352814 1.71223397,58.4852814 1.71223397,56 L1.71223397,56 L1.71223397,10 C1.71223397,7.51471863 2.71959328,5.26471863 4.34827294,3.63603897 C5.97695259,2.00735931 8.22695259,1 10.712234,1 L10.712234,1 Z" id="rectangle" stroke="#000000" stroke-width="2" fill="#FFFFFF"></path>
             <path d="M52.712234,11 L14.712234,11 C13.05989,11 11.712234,12.347656 11.712234,14 L11.712234,52 C11.712234,53.652344 13.05989,55 14.712234,55 L52.712234,55 C54.364578,55 55.712234,53.652344 55.712234,52 L55.712234,14 C55.712234,12.347656 54.364578,11 52.712234,11 Z M46.712234,38 L20.712234,38 L20.712234,36 L46.712234,36 L46.712234,38 Z M46.712234,30 L20.712234,30 L20.712234,28 L46.712234,28 L46.712234,30 Z" id="equals" fill="#000000" fill-rule="nonzero"></path>
         </g>
@@ -241,9 +242,9 @@ SVG_ICONS_FOR_ASSERTION_TYPES = {
 </svg>""",
     "col_vals_ne": """<?xml version="1.0" encoding="UTF-8"?>
 <svg width="67px" height="67px" viewBox="0 0 67 67" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-    <title>col_vals_not_equal</title>
+    <title>col_vals_ne</title>
     <g id="All-Icons" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g id="col_vals_not_equal" transform="translate(0.000000, 0.758621)">
+        <g id="col_vals_ne" transform="translate(0.000000, 0.758621)">
             <path d="M56.712234,1 C59.1975153,1 61.4475153,2.00735931 63.076195,3.63603897 C64.7048747,5.26471863 65.712234,7.51471863 65.712234,10 L65.712234,10 L65.712234,65 L10.712234,65 C8.22695259,65 5.97695259,63.9926407 4.34827294,62.363961 C2.71959328,60.7352814 1.71223397,58.4852814 1.71223397,56 L1.71223397,56 L1.71223397,10 C1.71223397,7.51471863 2.71959328,5.26471863 4.34827294,3.63603897 C5.97695259,2.00735931 8.22695259,1 10.712234,1 L10.712234,1 Z" id="rectangle" stroke="#000000" stroke-width="2" fill="#FFFFFF"></path>
             <path d="M53.712234,12 L13.712234,12 C13.161453,12 12.712234,12.449219 12.712234,13 L12.712234,53 C12.712234,53.550781 13.161453,54 13.712234,54 L53.712234,54 C54.263015,54 54.712234,53.550781 54.712234,53 L54.712234,13 C54.712234,12.449219 54.263015,12 53.712234,12 Z M46.712234,30 L32.989578,30 L36.805984,36 L46.712234,36 L46.712234,38 L38.079422,38 L43.169265,46 L40.798172,46 L35.708328,38 L20.712234,38 L20.712234,36 L34.43489,36 L30.618484,30 L20.712234,30 L20.712234,28 L29.345047,28 L24.251297,20 L26.62239,20 L31.71614,28 L46.712234,28 L46.712234,30 Z" id="not_equal" fill="#000000" fill-rule="nonzero"></path>
         </g>
@@ -251,9 +252,9 @@ SVG_ICONS_FOR_ASSERTION_TYPES = {
 </svg>""",
     "col_vals_ge": """<?xml version="1.0" encoding="UTF-8"?>
 <svg width="67px" height="67px" viewBox="0 0 67 67" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-    <title>col_vals_gte</title>
+    <title>col_vals_ge</title>
     <g id="All-Icons" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g id="col_vals_gte" transform="translate(0.000000, 0.241379)">
+        <g id="col_vals_ge" transform="translate(0.000000, 0.241379)">
             <path d="M56.712234,1 C59.1975153,1 61.4475153,2.00735931 63.076195,3.63603897 C64.7048747,5.26471863 65.712234,7.51471863 65.712234,10 L65.712234,10 L65.712234,65 L10.712234,65 C8.22695259,65 5.97695259,63.9926407 4.34827294,62.363961 C2.71959328,60.7352814 1.71223397,58.4852814 1.71223397,56 L1.71223397,56 L1.71223397,10 C1.71223397,7.51471863 2.71959328,5.26471863 4.34827294,3.63603897 C5.97695259,2.00735931 8.22695259,1 10.712234,1 L10.712234,1 Z" id="rectangle" stroke="#000000" stroke-width="2" fill="#FFFFFF"></path>
             <path d="M49.712234,12 L17.712234,12 C14.952234,12 12.712234,14.24 12.712234,17 L12.712234,49 C12.712234,51.76 14.952234,54 17.712234,54 L49.712234,54 C52.472234,54 54.712234,51.76 54.712234,49 L54.712234,17 C54.712234,14.24 52.472234,12 49.712234,12 Z M44.712234,47 L22.712234,47 L22.712234,45 L44.712234,45 L44.712234,47 Z M24.182234,40.88 L23.242234,39.12 L40.562234,30 L23.242234,20.88 L24.182234,19.12 L44.862234,30 L24.182234,40.88 Z" id="greater_than_equal" fill="#000000" fill-rule="nonzero"></path>
         </g>
@@ -261,9 +262,9 @@ SVG_ICONS_FOR_ASSERTION_TYPES = {
 </svg>""",
     "col_vals_le": """<?xml version="1.0" encoding="UTF-8"?>
 <svg width="67px" height="67px" viewBox="0 0 67 67" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-    <title>col_vals_lte</title>
+    <title>col_vals_le</title>
     <g id="All-Icons" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g id="col_vals_lte" transform="translate(0.000000, 0.793103)">
+        <g id="col_vals_le" transform="translate(0.000000, 0.793103)">
             <path d="M56.712234,1 C59.1975153,1 61.4475153,2.00735931 63.076195,3.63603897 C64.7048747,5.26471863 65.712234,7.51471863 65.712234,10 L65.712234,10 L65.712234,65 L10.712234,65 C8.22695259,65 5.97695259,63.9926407 4.34827294,62.363961 C2.71959328,60.7352814 1.71223397,58.4852814 1.71223397,56 L1.71223397,56 L1.71223397,10 C1.71223397,7.51471863 2.71959328,5.26471863 4.34827294,3.63603897 C5.97695259,2.00735931 8.22695259,1 10.712234,1 L10.712234,1 Z" id="rectangle" stroke="#000000" stroke-width="2" fill="#FFFFFF"></path>
             <path d="M53.712234,12 L13.712234,12 C13.157547,12 12.712234,12.449219 12.712234,13 L12.712234,53 C12.712234,53.550781 13.157547,54 13.712234,54 L53.712234,54 C54.266922,54 54.712234,53.550781 54.712234,53 L54.712234,13 C54.712234,12.449219 54.266922,12 53.712234,12 Z M42.227859,19.125 L43.196609,20.875 L26.770828,30 L43.196609,39.125 L42.227859,40.875 L22.65364,30 L42.227859,19.125 Z M44.712234,47 L22.712234,47 L22.712234,45 L44.712234,45 L44.712234,47 Z" id="less_than_equal" fill="#000000" fill-rule="nonzero"></path>
         </g>
@@ -281,9 +282,9 @@ SVG_ICONS_FOR_ASSERTION_TYPES = {
 </svg>""",
     "col_vals_outside": """<?xml version="1.0" encoding="UTF-8"?>
 <svg width="67px" height="67px" viewBox="0 0 67 67" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-    <title>col_vals_not_between</title>
+    <title>col_vals_outside</title>
     <g id="All-Icons" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g id="col_vals_not_between" transform="translate(0.000000, 0.689655)">
+        <g id="col_vals_outside" transform="translate(0.000000, 0.689655)">
             <path d="M56.712234,1 C59.1975153,1 61.4475153,2.00735931 63.076195,3.63603897 C64.7048747,5.26471863 65.712234,7.51471863 65.712234,10 L65.712234,10 L65.712234,65 L10.712234,65 C8.22695259,65 5.97695259,63.9926407 4.34827294,62.363961 C2.71959328,60.7352814 1.71223397,58.4852814 1.71223397,56 L1.71223397,56 L1.71223397,10 C1.71223397,7.51471863 2.71959328,5.26471863 4.34827294,3.63603897 C5.97695259,2.00735931 8.22695259,1 10.712234,1 L10.712234,1 Z" id="rectangle" stroke="#000000" stroke-width="2" fill="#FFFFFF"></path>
             <g id="outside_range" transform="translate(11.000000, 21.000000)" fill="#000000">
                 <path d="M12.993484,0.96875 C11.962234,1.082031 11.188797,1.964844 11.212234,3 L11.212234,21 C11.200515,21.722656 11.579422,22.390625 12.204422,22.753906 C12.825515,23.121094 13.598953,23.121094 14.220047,22.753906 C14.845047,22.390625 15.223953,21.722656 15.212234,21 L15.212234,3 C15.220047,2.457031 15.009109,1.9375 14.626297,1.554688 C14.243484,1.171875 13.723953,0.960938 13.180984,0.96875 C13.118484,0.964844 13.055984,0.964844 12.993484,0.96875 Z M32.993484,0.96875 C31.962234,1.082031 31.188797,1.964844 31.212234,3 L31.212234,21 C31.200515,21.722656 31.579422,22.390625 32.204422,22.753906 C32.825515,23.121094 33.598953,23.121094 34.220047,22.753906 C34.845047,22.390625 35.223953,21.722656 35.212234,21 L35.212234,3 C35.220047,2.457031 35.009109,1.9375 34.626297,1.554688 C34.243484,1.171875 33.723953,0.960938 33.180984,0.96875 C33.118484,0.964844 33.055984,0.964844 32.993484,0.96875 Z M17.212234,1 C16.661453,1 16.212234,1.449219 16.212234,2 C16.212234,2.550781 16.661453,3 17.212234,3 C17.763015,3 18.212234,2.550781 18.212234,2 C18.212234,1.449219 17.763015,1 17.212234,1 Z M21.212234,1 C20.661453,1 20.212234,1.449219 20.212234,2 C20.212234,2.550781 20.661453,3 21.212234,3 C21.763015,3 22.212234,2.550781 22.212234,2 C22.212234,1.449219 21.763015,1 21.212234,1 Z M25.212234,1 C24.661453,1 24.212234,1.449219 24.212234,2 C24.212234,2.550781 24.661453,3 25.212234,3 C25.763015,3 26.212234,2.550781 26.212234,2 C26.212234,1.449219 25.763015,1 25.212234,1 Z M29.212234,1 C28.661453,1 28.212234,1.449219 28.212234,2 C28.212234,2.550781 28.661453,3 29.212234,3 C29.763015,3 30.212234,2.550781 30.212234,2 C30.212234,1.449219 29.763015,1 29.212234,1 Z M17.212234,21 C16.661453,21 16.212234,21.449219 16.212234,22 C16.212234,22.550781 16.661453,23 17.212234,23 C17.763015,23 18.212234,22.550781 18.212234,22 C18.212234,21.449219 17.763015,21 17.212234,21 Z M21.212234,21 C20.661453,21 20.212234,21.449219 20.212234,22 C20.212234,22.550781 20.661453,23 21.212234,23 C21.763015,23 22.212234,22.550781 22.212234,22 C22.212234,21.449219 21.763015,21 21.212234,21 Z M25.212234,21 C24.661453,21 24.212234,21.449219 24.212234,22 C24.212234,22.550781 24.661453,23 25.212234,23 C25.763015,23 26.212234,22.550781 26.212234,22 C26.212234,21.449219 25.763015,21 25.212234,21 Z M29.212234,21 C28.661453,21 28.212234,21.449219 28.212234,22 C28.212234,22.550781 28.661453,23 29.212234,23 C29.763015,23 30.212234,22.550781 30.212234,22 C30.212234,21.449219 29.763015,21 29.212234,21 Z" id="small_range" fill-rule="nonzero"></path>

{pointblank-0.8.6 → pointblank-0.9.0}/pointblank/_interrogation.py

@@ -1089,14 +1089,20 @@ class Interrogator:
     def isin(self) -> FrameT | Any:
         # Ibis backends ---------------------------------------------
 
+        can_be_null: bool = None in self.set
+
         if self.tbl_type in IBIS_BACKENDS:
-            return self.x.mutate(pb_is_good_=self.x[self.column].isin(self.set))
+            base_expr = self.x[self.column].isin(self.set)
+            if can_be_null:
+                base_expr = base_expr | self.x[self.column].isnull()
+            return self.x.mutate(pb_is_good_=base_expr)
 
         # Local backends (Narwhals) ---------------------------------
+        base_expr: nw.Expr = nw.col(self.column).is_in(self.set)
+        if can_be_null:
+            base_expr = base_expr | nw.col(self.column).is_null()
 
-        return self.x.with_columns(
-            pb_is_good_=nw.col(self.column).is_in(self.set),
-        ).to_native()
+        return self.x.with_columns(pb_is_good_=base_expr).to_native()
 
     def notin(self) -> FrameT | Any:
         # Ibis backends ---------------------------------------------

pointblank-0.9.0/pointblank/_typing.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from typing import TypeAlias
+
+## Absolute bounds, ie. plus or minus
+AbsoluteBounds: TypeAlias = tuple[int, int]
+
+## Relative bounds, ie. plus or minus some percent
+RelativeBounds: TypeAlias = tuple[float, float]
+
+## Tolerance afforded to some check
+Tolerance: TypeAlias = int | float | AbsoluteBounds | RelativeBounds
+
+## Types for data segmentation
+
+## Value(s) that can be used in a segment tuple
+SegmentValue: TypeAlias = str | list[str]
+
+## (column, value(s)) format for segments
+SegmentTuple: TypeAlias = tuple[str, SegmentValue]
+
+## Individual segment item (string or tuple)
+SegmentItem: TypeAlias = str | SegmentTuple
+
+## Full segment specification options
+SegmentSpec: TypeAlias = str | SegmentTuple | list[SegmentItem]