pointblank 0.8.7__tar.gz → 0.9.0__tar.gz

{pointblank-0.8.7 → 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.7 → 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.7 → pointblank-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pointblank
-Version: 0.8.7
+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)
@@ -108,7 +109,10 @@ _Data validation made beautiful and powerful_
    <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.zh-CN.md">简体中文</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-0.8.7 → 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)
@@ -26,7 +27,10 @@ _Data validation made beautiful and powerful_
    <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.zh-CN.md">简体中文</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-0.8.7 → 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.7 → 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.7 → 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.7 → 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.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]