pyd3js-selection

Python port of d3-selection.

Tracked version: see upstream_lock.json.

What you get

• 100% upstream export parity for the pinned d3-selection@3.0.0 (see matrix below).
• 100% Python test coverage for pyd3js_selection.
• Upstream d3-selection JS tests vendored and passing via a pytest gate (-m upstream).

Install

From PyPI:

pip install pyd3js-selection

For local development (uv workspace):

uv sync --group dev

Usage

import pyd3js_selection as d3

root = d3.create("div")
root.append("span").text("hi")

print(root.node().innerHTML)

<span>hi</span>

Stability & intentional deviations

• Minimal DOM: this package includes a tiny DOM shim sufficient for upstream d3-selection semantics and tests; it is not a full browser DOM implementation.
• Callback “this”: D3’s this binding is represented explicitly (callbacks receive this as their first argument).

Compatibility matrix

Pinned upstream inventory: docs/UPSTREAM_API.md.

Legend:

• [ported]: implemented and covered by ported upstream tests.
• [missing]: reserved for future upstream drift.

Upstream exports (d3-selection@3.0.0)

• create — [ported]
• creator — [ported]
• local — [ported]
• matcher — [ported]
• namespace — [ported]
• namespaces — [ported]
• pointer — [ported]
• pointers — [ported]
• select — [ported]
• selectAll — [ported]
• selection — [ported]
• selector — [ported]
• selectorAll — [ported]
• style — [ported]
• window — [ported]

Testing

Run the package tests:

uv run pytest packages/pyd3js-selection/package_tests

Coverage (Python)

uv run pytest packages/pyd3js-selection/package_tests --cov=pyd3js_selection --cov-report=term-missing

Upstream d3-selection test suite (vendored)

We vendor the pinned upstream d3-selection repo (including its Mocha test suite) and run it via pytest:

uv run python scripts/vendor_upstream.py
cd packages/pyd3js-selection/upstream/d3-selection && npm install --legacy-peer-deps
uv run pytest -m upstream packages/pyd3js-selection/package_tests

Documentation

• User guide: docs/USER_GUIDE.md
• Changelog: docs/CHANGELOG.md