diamond-setup 1.0.0__tar.gz

diamond_setup-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Format check (ruff)
+        run: uv run ruff format --check .
+
+      - name: Run tests
+        run: uv run pytest
+
+  docs:
+    name: Build docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv python install 3.11
+      - run: uv sync --extra docs
+      - run: uv run mkdocs build --strict

diamond_setup-1.0.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+.uv/
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Docs
+site/
+
+# Editors
+.vscode/
+.idea/
+*.swp

diamond_setup-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements

diamond_setup-1.0.0/LICENSE

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

diamond_setup-1.0.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: diamond-setup
+Version: 1.0.0
+Summary: Universal Python project scaffold — generate professional project skeletons in seconds
+Project-URL: Repository, https://github.com/GenesisAeon/diamond-setup
+Project-URL: Issues, https://github.com/GenesisAeon/diamond-setup/issues
+Author: GenesisAeon
+License: MIT
+License-File: LICENSE
+Keywords: cli,project-generator,scaffold,skeleton,template
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# diamond-setup
+
+**Universal Python project scaffold** — generate professional, CI-ready skeletons in seconds.
+
+[![CI](https://github.com/GenesisAeon/diamond-setup/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/diamond-setup/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+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.
+
+---
+
+## Install
+
+```bash
+pip install diamond-setup
+# or
+uv tool install diamond-setup
+```
+
+## Usage
+
+```bash
+# 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
+├── .gitignore
+└── .pre-commit-config.yaml   # ruff + standard hooks
+```
+
+Then just:
+
+```bash
+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](docs/templates.md).
+
+---
+
+Built with [uv](https://docs.astral.sh/uv/) · [Typer](https://typer.tiangolo.com/) · [Rich](https://rich.readthedocs.io/)

diamond_setup-1.0.0/README.md

@@ -0,0 +1,84 @@
+# diamond-setup
+
+**Universal Python project scaffold** — generate professional, CI-ready skeletons in seconds.
+
+[![CI](https://github.com/GenesisAeon/diamond-setup/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/diamond-setup/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+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.
+
+---
+
+## Install
+
+```bash
+pip install diamond-setup
+# or
+uv tool install diamond-setup
+```
+
+## Usage
+
+```bash
+# 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
+├── .gitignore
+└── .pre-commit-config.yaml   # ruff + standard hooks
+```
+
+Then just:
+
+```bash
+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](docs/templates.md).
+
+---
+
+Built with [uv](https://docs.astral.sh/uv/) · [Typer](https://typer.tiangolo.com/) · [Rich](https://rich.readthedocs.io/)

diamond_setup-1.0.0/docs/cli.md

@@ -0,0 +1,88 @@
+# CLI Reference
+
+## `diamond scaffold`
+
+Create a new project from a template.
+
+```
+Usage: diamond scaffold [OPTIONS] PROJECT_NAME
+
+Arguments:
+  PROJECT_NAME  Name of the new project (kebab-case recommended)
+
+Options:
+  -t, --template TEXT       Template to use [default: minimal]
+  -o, --output-dir PATH     Parent directory for the new project
+  --author TEXT             Author name
+  --description TEXT        Short project description
+  --python-version TEXT     Minimum Python version (e.g. 3.11)
+  --dry-run                 Preview files without writing them
+```
+
+**Examples**
+
+```bash
+# Minimal project in the current directory
+diamond scaffold my-lib
+
+# Genesis preset with custom author
+diamond scaffold my-physics-tool --template genesis --author "Ada Lovelace"
+
+# Preview what would be created
+diamond scaffold my-lib --dry-run
+
+# Output to a specific directory
+diamond scaffold my-lib --output-dir ~/projects
+```
+
+---
+
+## `diamond list-templates`
+
+List all available templates with their descriptions.
+
+```bash
+diamond list-templates
+```
+
+---
+
+## `diamond validate`
+
+Validate a project directory against diamond-setup best practices.
+
+```
+Usage: diamond validate [PATH]
+
+Arguments:
+  PATH  Project directory to validate [default: current directory]
+```
+
+Checks performed:
+
+| Check | Level |
+|-------|-------|
+| `pyproject.toml` present | **Error** |
+| `src/` layout present | Warning |
+| `tests/` directory present | Warning |
+| `.github/workflows/` present | Warning |
+| `README.md` present | Warning |
+| `.gitignore` present | Warning |
+
+```bash
+# Validate the current directory
+diamond validate
+
+# Validate a specific project
+diamond validate path/to/my-project
+```
+
+---
+
+## `diamond version`
+
+Print the installed version.
+
+```bash
+diamond version
+```

diamond_setup-1.0.0/docs/index.md

@@ -0,0 +1,37 @@
+# Diamond Setup
+
+**Universal Python project scaffold** — generate professional, CI-ready project skeletons in seconds.
+
+No cookiecutter, no Jinja2, no magic. Just a clean CLI, sensible templates, and a validator that keeps your projects healthy.
+
+## Quickstart
+
+```bash
+pip install diamond-setup
+# or with uv:
+uv tool install diamond-setup
+```
+
+```bash
+diamond scaffold my-new-tool
+cd my-new-tool && uv sync --dev && uv run pytest
+```
+
+## Why Diamond Setup?
+
+| Feature | diamond-setup | cookiecutter | copier |
+|---------|:---:|:---:|:---:|
+| Zero config needed | ✅ | ❌ | ❌ |
+| Built-in validator | ✅ | ❌ | ❌ |
+| Pure Python templates | ✅ | ❌ | ❌ |
+| `--dry-run` support | ✅ | ❌ | ✅ |
+| Extensible presets | ✅ | ✅ | ✅ |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `diamond scaffold <name>` | Create a new project |
+| `diamond list-templates` | Show available templates |
+| `diamond validate [path]` | Check a project's health |
+| `diamond version` | Show version |

diamond_setup-1.0.0/docs/templates.md

@@ -0,0 +1,111 @@
+# Templates
+
+Diamond Setup ships two built-in templates. Adding your own is a single Python file.
+
+---
+
+## `minimal`
+
+**The default.** A clean, modern Python project with everything you need and nothing you don't.
+
+```bash
+diamond scaffold my-lib
+diamond scaffold my-lib --template minimal
+```
+
+### Files generated
+
+```
+my-lib/
+├── src/
+│   └── my_lib/
+│       └── __init__.py
+├── tests/
+│   ├── __init__.py
+│   └── test_main.py
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── pyproject.toml
+├── README.md
+├── .gitignore
+└── .pre-commit-config.yaml
+```
+
+### Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `name` | *(required)* | Project name |
+| `description` | `"A Python project"` | Short description |
+| `author` | `"Your Name"` | Author name |
+| `python_version` | `"3.11"` | Minimum Python version |
+
+---
+
+## `genesis`
+
+A superset of `minimal` — adds a `domains.yaml` for domain/metric configuration and an `entropy-table` YAML bridge module.
+
+```bash
+diamond scaffold my-physics-tool --template genesis
+```
+
+### Extra files
+
+```
+my-physics-tool/
+├── domains.yaml           ← domain/metric configuration
+├── config/
+│   └── entropy.yaml       ← entropy-table bridge config
+└── src/
+    └── my_physics_tool/
+        ├── __init__.py
+        └── bridge.py      ← entropy-table export function
+```
+
+### Extra variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `metrics` | `"crep"` | Default metrics identifier |
+
+---
+
+## Adding a Custom Template
+
+1. Create `src/diamond_setup/templates/my_template.py`:
+
+```python
+TEMPLATE = {
+    "name": "my_template",
+    "description": "My custom template",
+    "variables": ["name", "description", "author", "python_version"],
+    "defaults": {
+        "description": "My project",
+        "author": "Your Name",
+        "python_version": "3.11",
+    },
+    "files": {
+        "README.md": "# ${name}\n\n${description}\n",
+        "pyproject.toml": "...",
+        # keys are relative paths, values are template strings
+        # use ${variable} for substitution
+        # use $$ for a literal dollar sign
+    },
+}
+```
+
+2. Register it in `src/diamond_setup/templates/__init__.py`:
+
+```python
+from .my_template import TEMPLATE as MY_TEMPLATE
+
+REGISTRY: dict[str, dict] = {
+    "minimal": MINIMAL_TEMPLATE,
+    "genesis": GENESIS_TEMPLATE,
+    "my_template": MY_TEMPLATE,  # ← add this
+}
+```
+
+That's it. `diamond list-templates` will immediately show it.

diamond_setup-1.0.0/mkdocs.yml

@@ -0,0 +1,43 @@
+site_name: Diamond Setup
+site_description: Universal Python project scaffold — generate professional project skeletons in seconds
+site_author: GenesisAeon
+repo_url: https://github.com/GenesisAeon/diamond-setup
+repo_name: GenesisAeon/diamond-setup
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.top
+    - content.code.annotate
+    - content.code.copy
+    - search.highlight
+
+markdown_extensions:
+  - admonition
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.superfences
+  - pymdownx.tabbed:
+      alternate_style: true
+
+nav:
+  - Home: index.md
+  - CLI Reference: cli.md
+  - Templates: templates.md

diamond_setup-1.0.0/pyproject.toml

@@ -0,0 +1,70 @@
+[project]
+name = "diamond-setup"
+version = "1.0.0"
+description = "Universal Python project scaffold — generate professional project skeletons in seconds"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "GenesisAeon" }]
+requires-python = ">=3.11"
+keywords = ["scaffold", "template", "cli", "project-generator", "skeleton"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "pyyaml>=6.0",
+    "pydantic>=2.7",
+]
+
+[project.optional-dependencies]
+docs = [
+    "mkdocs>=1.6.0",
+    "mkdocs-material>=9.5.0",
+]
+dev = [
+    "ruff>=0.6.0",
+    "pre-commit>=3.7.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+]
+
+[project.scripts]
+diamond = "diamond_setup.cli:app"
+
+[project.urls]
+Repository = "https://github.com/GenesisAeon/diamond-setup"
+Issues = "https://github.com/GenesisAeon/diamond-setup/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/diamond_setup"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "I", "W", "UP", "C4", "SIM"]
+ignore = ["B008"]  # typer uses function calls in defaults
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101"]  # allow assert in tests
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=diamond_setup --cov-report=term-missing -v"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["tests/*"]

diamond_setup-1.0.0/src/diamond_setup/__init__.py

@@ -0,0 +1,4 @@
+"""Diamond Setup — universal Python project scaffold."""
+
+__version__ = "1.0.0"
+__author__ = "GenesisAeon"