w3d
w3d is Python library that provides generic DDD.
Requirements
- Python 3.14+
- uv for dependency and environment management
Installation
Clone the repository and sync the environment with uv:
git clone <repo-url> w3d
cd w3d
uv sync
This creates a virtual environment and installs both runtime (pydantic) and dev dependencies from uv.lock.
To add w3d to another project, install it from its source path (until it is published):
uv add /path/to/w3d
Usage
See docs/usage.md for a worked example.
Development
This project uses uv for everything; always run tools through it so they use the project venv.
| Task | Command |
|---|---|
| Run tests | uv run pytest |
| Lint | uv run ruff check |
| Format | uv run ruff format |
| Type check | uv run ty check |
| Sync env | uv sync |
Type checking uses ty (Astral's type checker), not mypy.
Before committing, run all checks in one pass:
./before_commit.zsh
It runs (fail-fast) ruff format (reformats in place), ruff check, ty check, then pytest with a 100% coverage gate, listing any files below 100%.
Project layout
w3d/ # the library (command.py, result.py)
tests/ # behavioral tests
docs/adr/ # architecture decision records
CONTEXT.md # ubiquitous language / domain glossary
1 maintainer
Metadata
1 maintainer
Release files for w3d 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| w3d-0.0.1.tar.gz | 62.0 kB | With provenance | Details for w3d-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| w3d-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for w3d-0.0.1-py3-none-any.whl |
Total release size: 67.8 kB
Release files / w3d-0.0.1.tar.gz
| Download URL | w3d-0.0.1.tar.gz |
|---|---|
| Size | 62.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0cd8ab84e2f5a19f3a6004d908bfb4c9e0f7bc8baeb74c6703e8dae518aa1466
|
|
BLAKE2b-256 checksum How to use checksums |
6eea4f92237d25048f25aa7250451d6a5e27a06781b596c316b982ae5b6dec69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 29, 2026.
Transparency logRelease files / w3d-0.0.1-py3-none-any.whl
| Download URL | w3d-0.0.1-py3-none-any.whl |
|---|---|
| Size | 5.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
90755d14fb1fa2a6d8bf341d262f9d4fb7244c6bb2376fc7071aaec5575488d6
|
|
BLAKE2b-256 checksum How to use checksums |
c34e38b70f80f35d49a294d59345534bbbd384b972d1bdaf247bbd111ce732d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 29, 2026.
Transparency logSecurity for w3d 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for w3d-0.0.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 29, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
