diamond-setup
Universal Python project scaffold — generate professional, CI-ready skeletons in seconds.
No cookiecutter, no Jinja2, no magic. Just a clean CLI that produces a fully working project — uv sync, pytest, ruff, pre-commit and CI all wired up from second one.
Installation
pip install diamond-setup
# or
uv tool install diamond-setup
Usage
# New project with the minimal template (default)
diamond scaffold my-lib
# GenesisAeon preset (adds domains.yaml + entropy-table bridge)
diamond scaffold my-physics-tool --template genesis --author "Ada Lovelace"
# Preview what would be generated (no files written)
diamond scaffold my-lib --dry-run
# See all templates
diamond list-templates
# Validate any project directory
diamond validate path/to/my-project
diamond validate # validates the current directory
What you get
Running diamond scaffold my-lib produces:
my-lib/
├── src/
│ └── my_lib/
│ └── __init__.py # __version__ = "0.1.0"
├── tests/
│ ├── __init__.py
│ └── test_main.py
├── .github/
│ └── workflows/
│ └── ci.yml # matrix: 3.11 + 3.12
├── pyproject.toml # hatchling, ruff, pytest configured
├── README.md
├── AGENT.md # GenesisAeon release & metadata rules
├── .gitignore
└── .pre-commit-config.yaml # ruff + standard hooks
Then just:
cd my-lib
uv sync --dev
pre-commit install
uv run pytest
Templates
| Template | Description |
|---|---|
minimal |
Clean Python package for everyone |
genesis |
Adds domains.yaml + entropy-table bridge (GenesisAeon preset) |
Extending
Adding a new template is one Python file. See docs/templates.md.
Role in the GenesisAeon Ecosystem
diamond-setup is P-INFRA-1 in the GenesisAeon ecosystem registry —
the ecosystem infrastructure / template scaffold package. It generates the
standardized project skeletons (CI, packaging, pre-commit) used to bootstrap
new GenesisAeon packages, including the genesis preset that wires in the
entropy-table bridge.
Citation
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file diamond_setup-2.3.0.tar.gz.
File metadata
- Download URL: diamond_setup-2.3.0.tar.gz
- Upload date:
- Size: 97.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
599453e622a29db48d03158451d2666a53600432e81c834e84c78bda00e70c3f
|
|
| MD5 |
af122713121e174292e6376edb3f2fff
|
|
| BLAKE2b-256 |
cfe7265966bf71567fc39df247c6e3b50e8e12c0ddc35fa983d114aad8528f64
|
Provenance
The following attestation bundles were made for diamond_setup-2.3.0.tar.gz:
Publisher:
release.yml on GenesisAeon/diamond-setup
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
diamond_setup-2.3.0.tar.gz -
Subject digest:
599453e622a29db48d03158451d2666a53600432e81c834e84c78bda00e70c3f - Sigstore transparency entry: 2350439407
- Sigstore integration time:
-
Permalink:
GenesisAeon/diamond-setup@cad6dddd9174b1f328c4c06f21b9dac55ad90484 -
Branch / Tag:
refs/tags/v2.3.0 - Owner: https://github.com/GenesisAeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@cad6dddd9174b1f328c4c06f21b9dac55ad90484 -
Trigger Event:
push
-
Statement type:
File details
Details for the file diamond_setup-2.3.0-py3-none-any.whl.
File metadata
- Download URL: diamond_setup-2.3.0-py3-none-any.whl
- Upload date:
- Size: 16.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c01e26e8f4cca0d00bb0c63ba2d0497de183158f7bf115101664e5a67f81af6b
|
|
| MD5 |
6ced28112121fd00696ce96cffea1ef1
|
|
| BLAKE2b-256 |
be7729a36254cc3d942642d73a5b91c8b1524a3b242ce6ad07cac11f30faf1fe
|
Provenance
The following attestation bundles were made for diamond_setup-2.3.0-py3-none-any.whl:
Publisher:
release.yml on GenesisAeon/diamond-setup
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
diamond_setup-2.3.0-py3-none-any.whl -
Subject digest:
c01e26e8f4cca0d00bb0c63ba2d0497de183158f7bf115101664e5a67f81af6b - Sigstore transparency entry: 2350439436
- Sigstore integration time:
-
Permalink:
GenesisAeon/diamond-setup@cad6dddd9174b1f328c4c06f21b9dac55ad90484 -
Branch / Tag:
refs/tags/v2.3.0 - Owner: https://github.com/GenesisAeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@cad6dddd9174b1f328c4c06f21b9dac55ad90484 -
Trigger Event:
push
-
Statement type:
