gtviz 0.3.3__tar.gz

gtviz-0.3.3/.github/workflows/bless_basslines.yml

@@ -0,0 +1,23 @@
+name: Bless baselines
+on: workflow_dispatch   # manual button in the Actions tab
+
+permissions:
+  contents: write
+
+jobs:
+  bless:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install -e .[dev]
+      - run: pytest -q
+      - run: python tools/compare_images.py --update
+      - name: Commit refreshed baselines
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add tests/baseline
+          git commit -m "Re-bless baselines on CI runner" || echo "no changes"
+          git push

gtviz-0.3.3/.github/workflows/ci.yml

@@ -0,0 +1,148 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install ruff
+      - name: Ruff (human-readable, fails the job)
+        run: ruff check src tests tools examples
+      - name: Ruff (JSON for the report; never fails)
+        if: always()
+        run: ruff check src tests tools examples --output-format=json > ruff.json || true
+      - name: Upload lint report input
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: report-lint
+          path: ruff.json
+          retention-days: 30
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e .[dev]
+      - name: Run tests (JUnit + coverage XML for the report)
+        run: >
+          pytest
+          --junitxml=junit-${{ matrix.python-version }}.xml
+          --cov=gtviz --cov-report=xml:coverage-${{ matrix.python-version }}.xml
+          --cov-report=term-missing
+      - name: Upload test + coverage report inputs
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: report-test-${{ matrix.python-version }}
+          path: |
+            junit-${{ matrix.python-version }}.xml
+            coverage-${{ matrix.python-version }}.xml
+          retention-days: 30
+      - name: Upload rendered chart images for HUMAN review
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-images
+          path: tests/output/
+          retention-days: 30
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage-3.12.xml
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  visual-regression:
+    # HEADLESS image check: compares freshly rendered charts against
+    # committed baselines in tests/baseline/. To accept intentional visual
+    # changes, re-bless via the "Bless baselines" workflow.
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install -e .[dev]
+      - run: pytest -q
+      - name: Compare images against baselines
+        run: python tools/compare_images.py --threshold 3.0 | tee visual.txt
+      - name: Upload visual report input
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: report-visual
+          path: visual.txt
+          retention-days: 30
+      - name: Upload diff images on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: image-diffs
+          path: tests/output/*_diff.png
+
+  gallery:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install -e .[dev,waffle]
+      - name: Generate full gallery (PNG + SVG + HTML report + PDF)
+        run: python examples/generate_gallery.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: gallery
+          path: docs/_static/gallery/
+
+  report:
+    # Aggregates every job's machine-readable output into one Markdown report.
+    # Runs last, always (even if tests failed), so you always get a summary.
+    runs-on: ubuntu-latest
+    needs: [lint, test, visual-regression]
+    if: always()
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - name: Download all report inputs
+        uses: actions/download-artifact@v4
+        with:
+          path: report-inputs
+          pattern: report-*
+          merge-multiple: true
+      - name: Generate quality report
+        run: >
+          python tools/generate_report.py
+          --junit 'report-inputs/junit-*.xml'
+          --coverage report-inputs/coverage-3.12.xml
+          --ruff report-inputs/ruff.json
+          --visual report-inputs/visual.txt
+          --out quality-report.md
+      - name: Publish report to the run summary
+        if: always()
+        run: cat quality-report.md >> "$GITHUB_STEP_SUMMARY"
+      - name: Upload report as artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: quality-report
+          path: quality-report.md
+          retention-days: 90

gtviz-0.3.3/.github/workflows/docs.yml

@@ -0,0 +1,25 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build-docs:
+    # Read the Docs builds the published site; this job catches Sphinx
+    # errors in PRs before they land.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install -e .[docs]
+      - name: Regenerate gallery images for docs
+        run: python examples/generate_gallery.py
+      - name: Build Sphinx docs (warnings are errors)
+        run: sphinx-build -W -b html docs docs/_build/html
+      - uses: actions/upload-artifact@v4
+        with:
+          name: docs-html
+          path: docs/_build/html

gtviz-0.3.3/.github/workflows/pipeline.yml

@@ -0,0 +1,89 @@
+name: Pipeline
+
+# Dedicated CI for the dataset-specific processing pipeline
+# (gtviz.pipeline). Runs only when pipeline code changes, on its own cadence
+# from the viz CI — pipeline steps encode survey-version logic that changes
+# with each questionnaire wave, not with chart code.
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "src/gtviz/pipeline/**"
+      - "tests/test_pipeline.py"
+      - ".github/workflows/pipeline.yml"
+  pull_request:
+    paths:
+      - "src/gtviz/pipeline/**"
+      - "tests/test_pipeline.py"
+      - ".github/workflows/pipeline.yml"
+  schedule:
+    # weekly regression run against latest deps (survey pipeline must not
+    # silently break between quarterly report cycles)
+    - cron: "0 6 * * 1"
+
+jobs:
+  pipeline-tests:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+        pandas: ["pandas>=2.0,<3", "pandas>=3"]
+        exclude:
+          - python-version: "3.10"
+            pandas: "pandas>=3"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e .[dev] "${{ matrix.pandas }}" scikit-learn openpyxl
+      - name: Pipeline unit tests
+        run: pytest tests/test_pipeline.py -v --cov=gtviz.pipeline --cov-report=term-missing
+      - name: sklearn interoperability check
+        run: |
+          python - << 'PY'
+          import pandas as pd, numpy as np
+          from sklearn.pipeline import Pipeline as SkPipeline
+          from gtviz.pipeline import ScoreBelonging, CivicQuartile
+          rng = np.random.default_rng(0)
+          df = pd.DataFrame({q: rng.integers(0, 4, 50)
+                             for q in ["Q31_r6_scale","Q31_r7_scale","Q31_r8_scale","Q31_r9_scale"]})
+          out = SkPipeline([("b", ScoreBelonging(answer_map=None)),
+                            ("q", CivicQuartile(source_col="belonging", out_col="bq"))]).fit_transform(df)
+          assert "bq" in out.columns
+          print("sklearn interop OK")
+          PY
+
+  batch-smoke:
+    # Headless batch run of the full default pipeline over synthetic data —
+    # proves `gtviz.pipeline.process()` end-to-end without production access.
+    runs-on: ubuntu-latest
+    needs: pipeline-tests
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install -e .[dev]
+      - name: Full default_pipeline batch over synthetic frame
+        run: |
+          python - << 'PY'
+          import sys; sys.path.insert(0, "tests")
+          import pandas as pd
+          from test_pipeline import gp_frame, typology_ref, pew_ref  # fixture fns
+          import gtviz.pipeline as pl
+          import numpy as np
+          # rebuild fixture data without pytest
+          import test_pipeline as tp
+          df = tp.gp_frame.__wrapped__()
+          out = pl.process(df,
+                           typology=tp.typology_ref.__wrapped__(),
+                           pew_decoder=tp.pew_ref.__wrapped__(),
+                           verbose=True)
+          expected = {"activism_any","county_type","belonging","civic_intent",
+                      "best_pew","civic_quartile"}
+          missing = expected - set(out.columns)
+          assert not missing, f"missing: {missing}"
+          print(f"batch OK: {len(out)} rows, {len(out.columns)} columns")
+          PY

gtviz-0.3.3/.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Publish target"
+        type: choice
+        options: [testpypi, pypi]
+        default: testpypi
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.12" }
+      - run: pip install build twine
+      - name: Verify tag matches package version
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          echo "tag=$TAG package=$PKG"
+          test "$TAG" = "$PKG" || { echo "::error::Tag v$TAG != package version $PKG"; exit 1; }
+      - run: python -m build
+      - run: twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  testpypi:
+    # Manual dry-run publish to Test PyPI (workflow_dispatch, target=testpypi).
+    needs: build
+    if: github.event_name == 'workflow_dispatch' && inputs.target == 'testpypi'
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with: { name: dist, path: dist }
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  pypi:
+    # Real publish: on a v* tag, or manual dispatch with target=pypi.
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.target == 'pypi')
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # PyPI trusted publishing (OIDC), no API token needed
+    steps:
+      - uses: actions/download-artifact@v4
+        with: { name: dist, path: dist }
+      - uses: pypa/gh-action-pypi-publish@release/v1

gtviz-0.3.3/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.egg-info/
+dist/
+build/
+.coverage
+tests/output/
+docs/_build/
+docs/_static/gallery/
+gpviz_output/
+._*
+.DS_Store

gtviz-0.3.3/.readthedocs.yaml

@@ -0,0 +1,20 @@
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+  jobs:
+    pre_build:
+      # regenerate gallery images so docs always show current output
+      - python examples/generate_gallery.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements: [docs]
+
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: false

gtviz-0.3.3/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+## 0.3.3 (2026-07-23)
+- Fixed CI/CD and prepared for pypi
+
+## 0.3.0 (2026-07-22)
+
+- **Renamed package `gpviz` → `gtviz`** (imports, env var `GTVIZ_OUTPUT_DIR`,
+  docs URLs, `ax._gtviz_data`).
+- **Brand-default restoration**: all chart styling audited line-by-line
+  against the production `gp_reports` code and ported verbatim as defaults
+  (dot marker/error/grid style, gray-first series palette, frameless
+  outside legends, no-box grouped dot plots, n= legend counts, 25-char
+  label wrapping, rolling-trend plain lines + (1,1) legend + optional gray
+  period shading, split-line palette, 4-point Likert palette + outside
+  legend + zero-width label suppression, venn 20pt/pad-30 titles, funnel
+  band geometry, donut without autopct, figure.dpi 300).
+- `theme.use(profile, font=...)` for the brand font (Neutraface Text);
+  new palette tokens `split_series`, `likert4`, `stacked3`.
+- New guide: *Design defaults & override policy* documenting every default,
+  its override kwarg, and the open default-vs-override decisions.
+
+## 0.2.0 (2026-07-22)
+
+- New `gtviz.pipeline` subpackage: sklearn-style dataset processing for the
+  GivingPulse survey. `read_pipeline()` (Delta/Spark loader with
+  year/quarter/week filters), `process()` / `default_pipeline()` batch
+  runner, and steps `AssignActivism`, `AssignCountyTypes`, `ScoreBelonging`,
+  `ScoreCivicIntent`, `AssignPew` (vectorized), `CivicQuartile`.
+  Steps implement the sklearn transformer contract (`get_params`,
+  `set_params`, `step__param` addressing, usable in `sklearn.pipeline`).
+- Reference files (county typology, Pew decoder) are parameters accepting a
+  path or DataFrame — no hard-coded `/Volumes/...` paths.
+- Dedicated `pipeline.yml` CI: path-filtered triggers, python x pandas
+  matrix, sklearn interop check, headless batch smoke run, weekly schedule.
+
+## 0.1.0 (2026-07-22)
+
+Initial public release: full refactor of the `gp_reports` visualization code.
+
+- `charts`: dot_plot, grouped_dot_plot, trend_dot_plot, parallel_bars,
+  rolling_trend, split_line_plot, annotated_event_plot, venn,
+  venn_from_counts, weighted_heatmap, funnel, funnel_from_columns, donut,
+  likert_bars, waffle (extra).
+- `tables`: HtmlTable (publication CSS table), compare_periods,
+  pivot_change_table.
+- `maps`: choropleth_table (absolute/relative), scale_bar.
+- `stats`: rolling_summary, period_change, compare_crosstab,
+  subgroup_summary, build_filter, chi_squared_matrix, normalize_likert,
+  decode_likert, named aggregators, time utilities.
+- `io`: multi-format save (png/svg/pdf/jpg/webp/eps), HTML embedding,
+  ReportBuilder (standalone HTML + multi-page PDF).
+- `theme`: "report" and "publication" profiles, palette tokens.
+- CI: lint, test matrix (3.10–3.13) with image artifacts (human review),
+  baseline visual regression (headless), gallery build, docs build,
+  PyPI trusted-publishing release.

gtviz-0.3.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GivingPulse Analytics
+
+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.

gtviz-0.3.3/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: gtviz
+Version: 0.3.3
+Summary: Publication-quality survey data visualization: dot plots, comparison tables, venn diagrams, choropleth color tables, HTML/PDF/PNG/SVG export.
+Project-URL: Homepage, https://github.com/Giving-Tuesday/gtviz
+Project-URL: Documentation, https://gtviz.readthedocs.io
+Project-URL: Source, https://github.com/Giving-Tuesday/gtviz
+Project-URL: Changelog, https://github.com/Giving-Tuesday/gtviz/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/Giving-Tuesday/gtviz/issues
+Author: GivingPulse Analytics
+License: MIT
+License-File: LICENSE
+Keywords: matplotlib,reporting,survey,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.0
+Requires-Dist: matplotlib-venn>=0.11
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: scipy>=1.10
+Provides-Extra: dev
+Requires-Dist: pillow; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: furo; extra == 'docs'
+Requires-Dist: myst-parser; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints; extra == 'docs'
+Requires-Dist: sphinx-copybutton; extra == 'docs'
+Requires-Dist: sphinx>=7; extra == 'docs'
+Provides-Extra: waffle
+Requires-Dist: pywaffle>=1.1; extra == 'waffle'
+Description-Content-Type: text/markdown
+
+# gtviz
+
+[![PyPI version](https://img.shields.io/pypi/v/gtviz.svg)](https://pypi.org/project/gtviz/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gtviz.svg)](https://pypi.org/project/gtviz/)
+[![CI](https://github.com/Giving-Tuesday/gtviz/actions/workflows/ci.yml/badge.svg)](https://github.com/Giving-Tuesday/gtviz/actions/workflows/ci.yml)
+[![Docs](https://readthedocs.org/projects/gtviz/badge/?version=latest)](https://gtviz.readthedocs.io/en/latest/)
+[![codecov](https://codecov.io/gh/Giving-Tuesday/gtviz/branch/main/graph/badge.svg)](https://codecov.io/gh/Giving-Tuesday/gtviz)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Publication-quality survey data visualization, refactored from the GivingPulse
+quarterly-report codebase into a clean, survey-agnostic library.
+
+**Charts:** dot plots (single, grouped, trend), parallel bar panels, rolling trend
+lines, venn diagrams (2/3 set, filtered or from pre-aggregated counts), weighted
+heatmaps, funnels, donuts, diverging Likert bars.
+**Tables:** publication CSS/HTML tables with zebra striping, high/low cell shading,
+multi-index rollups; period-over-period comparison tables.
+**Maps:** county/FIPS choropleth color tables (for SVG map filling) + scale-bar legends.
+**Export:** PNG, SVG, PDF, standalone HTML reports (figures embedded as SVG),
+suitable for websites or print reports.
+
+```python
+import gtviz
+gtviz.theme.use("report")
+
+fig, ax = gtviz.dot_plot([62, 48, 31], ["Gave money", "Volunteered", "Gave items"],
+                         error=[3, 3, 2], title="Generosity in Q2")
+gtviz.io.save(fig, "generosity_q2", formats=("png", "svg", "pdf"))
+```
+
+## Install
+
+```
+pip install gtviz            # core
+pip install gtviz[waffle]    # + waffle charts
+```
+
+## Docs
+
+Full documentation, gallery, and migration guide from the original `gp_reports`
+repo: https://gtviz.readthedocs.io
+
+## Development
+
+```
+pip install -e .[dev,docs]
+pytest                                  # unit tests; writes chart images to tests/output/
+python examples/generate_gallery.py    # regenerate gallery images
+```
+
+CI runs lint + tests on every push and uploads rendered chart images as build
+artifacts for **human review**; a **headless** job compares rendered images
+against committed baselines in `tests/baseline/`. See `.github/workflows/`.

gtviz-0.3.3/README.md

@@ -0,0 +1,54 @@
+# gtviz
+
+[![PyPI version](https://img.shields.io/pypi/v/gtviz.svg)](https://pypi.org/project/gtviz/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gtviz.svg)](https://pypi.org/project/gtviz/)
+[![CI](https://github.com/Giving-Tuesday/gtviz/actions/workflows/ci.yml/badge.svg)](https://github.com/Giving-Tuesday/gtviz/actions/workflows/ci.yml)
+[![Docs](https://readthedocs.org/projects/gtviz/badge/?version=latest)](https://gtviz.readthedocs.io/en/latest/)
+[![codecov](https://codecov.io/gh/Giving-Tuesday/gtviz/branch/main/graph/badge.svg)](https://codecov.io/gh/Giving-Tuesday/gtviz)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Publication-quality survey data visualization, refactored from the GivingPulse
+quarterly-report codebase into a clean, survey-agnostic library.
+
+**Charts:** dot plots (single, grouped, trend), parallel bar panels, rolling trend
+lines, venn diagrams (2/3 set, filtered or from pre-aggregated counts), weighted
+heatmaps, funnels, donuts, diverging Likert bars.
+**Tables:** publication CSS/HTML tables with zebra striping, high/low cell shading,
+multi-index rollups; period-over-period comparison tables.
+**Maps:** county/FIPS choropleth color tables (for SVG map filling) + scale-bar legends.
+**Export:** PNG, SVG, PDF, standalone HTML reports (figures embedded as SVG),
+suitable for websites or print reports.
+
+```python
+import gtviz
+gtviz.theme.use("report")
+
+fig, ax = gtviz.dot_plot([62, 48, 31], ["Gave money", "Volunteered", "Gave items"],
+                         error=[3, 3, 2], title="Generosity in Q2")
+gtviz.io.save(fig, "generosity_q2", formats=("png", "svg", "pdf"))
+```
+
+## Install
+
+```
+pip install gtviz            # core
+pip install gtviz[waffle]    # + waffle charts
+```
+
+## Docs
+
+Full documentation, gallery, and migration guide from the original `gp_reports`
+repo: https://gtviz.readthedocs.io
+
+## Development
+
+```
+pip install -e .[dev,docs]
+pytest                                  # unit tests; writes chart images to tests/output/
+python examples/generate_gallery.py    # regenerate gallery images
+```
+
+CI runs lint + tests on every push and uploads rendered chart images as build
+artifacts for **human review**; a **headless** job compares rendered images
+against committed baselines in `tests/baseline/`. See `.github/workflows/`.

gtviz-0.3.3/docs/api/charts.md

@@ -0,0 +1,55 @@
+# gtviz.charts
+
+All chart functions return `(fig, ax)`, accept an optional `ax=` for
+composition, and never call `plt.show()`.
+
+## Dot plots
+
+```{eval-rst}
+.. automodule:: gtviz.charts.dots
+   :members:
+```
+
+## Bar panels
+
+```{eval-rst}
+.. automodule:: gtviz.charts.bars
+   :members:
+```
+
+## Trend lines
+
+```{eval-rst}
+.. automodule:: gtviz.charts.lines
+   :members:
+```
+
+## Venn diagrams
+
+```{eval-rst}
+.. automodule:: gtviz.charts.venn
+   :members:
+```
+
+## Heatmaps
+
+```{eval-rst}
+.. automodule:: gtviz.charts.heatmap
+   :members:
+```
+
+## Funnel, donut, waffle, Likert
+
+```{eval-rst}
+.. automodule:: gtviz.charts.funnel
+   :members:
+
+.. automodule:: gtviz.charts.donut
+   :members:
+
+.. automodule:: gtviz.charts.likert
+   :members:
+
+.. automodule:: gtviz.charts.waffle
+   :members:
+```

gtviz-0.3.3/docs/api/io.md

@@ -0,0 +1,6 @@
+# gtviz.io
+
+```{eval-rst}
+.. automodule:: gtviz.io
+   :members:
+```