disability-access-charts 0.0.1__tar.gz

disability_access_charts-0.0.1/.gitignore

@@ -0,0 +1,46 @@
+# --- Restricted zone: licensed microdata must never be committed ---
+data/restricted/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Local databases (public data ships as Parquet, not DuckDB)
+*.duckdb
+*.duckdb.wal
+
+# LLM alt-text cache is local; regenerate from data
+.disability_access_charts_cache/
+
+# dbt
+target/
+dbt_packages/
+logs/
+
+# Node / site
+node_modules/
+site/dist/
+
+# R / renv
+.Rhistory
+.RData
+.Rproj.user/
+
+# Secrets
+.env
+.env.*
+
+# OS / editors
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/

disability_access_charts-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 batestguy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

disability_access_charts-0.0.1/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.5
+Name: disability-access-charts
+Version: 0.0.1
+Summary: Accessible Plotly charts: alt-text checked against the data, a CI-ready audit, and a data-table fallback for every chart
+Project-URL: Homepage, https://github.com/batestguy/curb-cut
+Project-URL: Issues, https://github.com/batestguy/curb-cut/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: a11y,accessibility,charts,disability,plotly,screen-reader,wcag
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# disability-access-charts
+
+Accessible charts for Python, built by and for disabled data users. The goal: every chart ships with alt-text that is checked against its data, an accessibility audit you can run in CI, and a data-table fallback.
+
+**Status: early (0.0.x).** This release contains only the WCAG 2.2 contrast checks; the chart API follows. Part of the [Curb Cut](https://github.com/batestguy/curb-cut) project.
+
+```python
+from disability_access_charts import contrast_ratio, passes_text, passes_non_text
+
+contrast_ratio("#0072b2", "#ffffff")  # 5.19
+passes_text("#767676", "#ffffff")  # True  (SC 1.4.3, 4.5:1)
+passes_non_text("#f0e442", "#ffffff")  # False (SC 1.4.11, 3:1)
+```
+
+MIT licensed.

disability_access_charts-0.0.1/README.md

@@ -0,0 +1,15 @@
+# disability-access-charts
+
+Accessible charts for Python, built by and for disabled data users. The goal: every chart ships with alt-text that is checked against its data, an accessibility audit you can run in CI, and a data-table fallback.
+
+**Status: early (0.0.x).** This release contains only the WCAG 2.2 contrast checks; the chart API follows. Part of the [Curb Cut](https://github.com/batestguy/curb-cut) project.
+
+```python
+from disability_access_charts import contrast_ratio, passes_text, passes_non_text
+
+contrast_ratio("#0072b2", "#ffffff")  # 5.19
+passes_text("#767676", "#ffffff")  # True  (SC 1.4.3, 4.5:1)
+passes_non_text("#f0e442", "#ffffff")  # False (SC 1.4.11, 3:1)
+```
+
+MIT licensed.

disability_access_charts-0.0.1/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "disability-access-charts"
+version = "0.0.1"
+description = "Accessible Plotly charts: alt-text checked against the data, a CI-ready audit, and a data-table fallback for every chart"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["accessibility", "a11y", "disability", "wcag", "charts", "plotly", "screen-reader"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Intended Audience :: Science/Research",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/batestguy/curb-cut"
+Issues = "https://github.com/batestguy/curb-cut/issues"
+
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/disability_access_charts"]

disability_access_charts-0.0.1/src/disability_access_charts/__init__.py

@@ -0,0 +1,16 @@
+"""Accessible charts: alt-text checked against the data, a CI-ready audit,
+and a data-table fallback for every chart.
+
+Early release: only the WCAG contrast checks exist so far.
+"""
+
+from disability_access_charts.contrast import (
+    contrast_ratio,
+    passes_non_text,
+    passes_text,
+    relative_luminance,
+)
+
+__version__ = "0.0.1"
+
+__all__ = ["contrast_ratio", "passes_non_text", "passes_text", "relative_luminance"]

disability_access_charts-0.0.1/src/disability_access_charts/contrast.py

@@ -0,0 +1,54 @@
+"""WCAG 2.2 contrast checks for SC 1.4.3 (text) and SC 1.4.11 (non-text)."""
+
+from __future__ import annotations
+
+import re
+
+_HEX = re.compile(r"^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$")
+
+TEXT_MIN = 4.5
+"""SC 1.4.3 minimum for normal-size text."""
+LARGE_TEXT_MIN = 3.0
+"""SC 1.4.3 minimum for large text (18pt, or 14pt bold)."""
+NON_TEXT_MIN = 3.0
+"""SC 1.4.11 minimum for graphical objects such as chart marks."""
+
+
+def _channels(color: str) -> tuple[int, int, int]:
+    match = _HEX.match(color.strip())
+    if not match:
+        raise ValueError(f"Expected a hex colour like '#1a2b3c' or '#abc', got {color!r}")
+    digits = match.group(1)
+    if len(digits) == 3:
+        digits = "".join(d * 2 for d in digits)
+    return int(digits[0:2], 16), int(digits[2:4], 16), int(digits[4:6], 16)
+
+
+def relative_luminance(color: str) -> float:
+    """Relative luminance of an sRGB hex colour, as defined by WCAG 2.2."""
+
+    def linear(channel: int) -> float:
+        c = channel / 255
+        return c / 12.92 if c <= 0.04045 else ((c + 0.055) / 1.055) ** 2.4
+
+    r, g, b = (linear(c) for c in _channels(color))
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b
+
+
+def contrast_ratio(foreground: str, background: str) -> float:
+    """Contrast ratio between two hex colours, from 1.0 to 21.0."""
+    lighter, darker = sorted(
+        (relative_luminance(foreground), relative_luminance(background)), reverse=True
+    )
+    return (lighter + 0.05) / (darker + 0.05)
+
+
+def passes_text(foreground: str, background: str, *, large: bool = False) -> bool:
+    """Whether text in ``foreground`` on ``background`` meets SC 1.4.3 (AA)."""
+    minimum = LARGE_TEXT_MIN if large else TEXT_MIN
+    return contrast_ratio(foreground, background) >= minimum
+
+
+def passes_non_text(foreground: str, background: str) -> bool:
+    """Whether a chart mark in ``foreground`` on ``background`` meets SC 1.4.11."""
+    return contrast_ratio(foreground, background) >= NON_TEXT_MIN

disability_access_charts-0.0.1/tests/test_contrast.py

@@ -0,0 +1,46 @@
+import pytest
+from disability_access_charts import (
+    contrast_ratio,
+    passes_non_text,
+    passes_text,
+    relative_luminance,
+)
+
+
+def test_black_on_white_is_maximum() -> None:
+    assert contrast_ratio("#000000", "#ffffff") == pytest.approx(21.0)
+
+
+def test_identical_colours_are_minimum() -> None:
+    assert contrast_ratio("#777777", "#777777") == pytest.approx(1.0)
+
+
+def test_order_does_not_matter() -> None:
+    assert contrast_ratio("#0072b2", "#ffffff") == contrast_ratio("#ffffff", "#0072b2")
+
+
+def test_shorthand_hex_matches_full() -> None:
+    assert relative_luminance("#fff") == relative_luminance("#ffffff")
+
+
+def test_text_threshold_boundary() -> None:
+    # #767676 on white is the well-known lightest grey that passes 4.5:1 (about 4.54).
+    assert passes_text("#767676", "#ffffff")
+    assert not passes_text("#777777", "#ffffff")
+
+
+def test_large_text_uses_lower_threshold() -> None:
+    # #949494 on white is about 3.03:1: fails normal text, passes large text.
+    assert not passes_text("#949494", "#ffffff")
+    assert passes_text("#949494", "#ffffff", large=True)
+
+
+def test_okabe_ito_yellow_fails_non_text_on_white() -> None:
+    assert not passes_non_text("#f0e442", "#ffffff")
+    assert passes_non_text("#0072b2", "#ffffff")
+
+
+@pytest.mark.parametrize("bad", ["red", "#12345", "#ggg", ""])
+def test_rejects_invalid_colours(bad: str) -> None:
+    with pytest.raises(ValueError):
+        contrast_ratio(bad, "#ffffff")

disability_access_charts-0.0.1/tests/test_smoke.py

@@ -0,0 +1,5 @@
+import disability_access_charts
+
+
+def test_version() -> None:
+    assert disability_access_charts.__version__ == "0.0.1"