layerconf 0.1.0__tar.gz

layerconf-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: [main]
+  workflow_call:
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dev dependencies
+        run: uv sync --extra dev
+
+      - name: ruff check
+        run: uv run ruff check src/
+
+      - name: ruff format check
+        run: uv run ruff format --check src/
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and dev dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov=layer --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.12'
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false

layerconf-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write   # needed to push to gh-pages branch
+
+jobs:
+  deploy:
+    name: Build and deploy MkDocs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # for git-revision-date plugin
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install docs and dev dependencies
+        run: uv sync --extra docs --extra dev
+
+      - name: Build and deploy docs
+        run: uv run mkdocs gh-deploy --force

layerconf-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  ci:
+    name: Run CI checks
+    uses: ./.github/workflows/ci.yml
+
+  release:
+    name: Semantic Release + PyPI
+    needs: ci
+    runs-on: ubuntu-latest
+    concurrency:
+      group: release
+      cancel-in-progress: false
+    permissions:
+      contents: write   # PSR pushes version bump commit + tag
+      id-token: write   # OIDC for PyPI Trusted Publishing
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # PSR needs full history to find the last version tag
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install python-semantic-release
+        run: pip install "python-semantic-release==9.*"
+
+      - name: Run semantic-release
+        id: semrel
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: semantic-release version --push --changelog --vcs-release
+
+      - name: Build distribution
+        if: steps.semrel.outputs.released == 'true'
+        run: uv build
+
+      - name: Publish to PyPI (Trusted Publishing)
+        if: steps.semrel.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

layerconf-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+.vscode/
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Planning
+planning_docs/
+
+# docs
+site/

layerconf-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10

layerconf-0.1.0/CHANGELOG.md

@@ -0,0 +1,37 @@
+# CHANGELOG
+
+
+## v0.1.0 (2026-03-24)
+
+### Bug Fixes
+
+- Broken release workflow
+  ([`e349cd0`](https://github.com/AncientPatata/layer/commit/e349cd0697f3cd7ef001359a0da2ca6995338fff))
+
+- Package name
+  ([`2f48964`](https://github.com/AncientPatata/layer/commit/2f489640834c20061f233cef91fd60ca3a37c72b))
+
+- Ruff complaints
+  ([`0dcff05`](https://github.com/AncientPatata/layer/commit/0dcff05000487cf69e1f145c2b35da06afaff11b))
+
+- Trigger patch release
+  ([`9af7b89`](https://github.com/AncientPatata/layer/commit/9af7b89bbb5981c250f8cec76e5a6349a5621b4e))
+
+- Trigger patch release
+  ([`856b2ce`](https://github.com/AncientPatata/layer/commit/856b2ce4b487eb50837caf3b4c0dc988c203b23d))
+
+### Documentation
+
+- Improvements
+  ([`2d4a7a4`](https://github.com/AncientPatata/layer/commit/2d4a7a440da2b7df2a02b848d4de9e9b77f93a2f))
+
+- Initial docs
+  ([`04a5557`](https://github.com/AncientPatata/layer/commit/04a555752c0bc886a9a178e6ac9c3865b48efc70))
+
+### Features
+
+- Etcd provider, schema binding and .env fix
+  ([`4f58d80`](https://github.com/AncientPatata/layer/commit/4f58d80657a0e09bc8251dc7e22ee8cca1035cfa))
+
+- Trigger release, dotenv now core dep.
+  ([`70a5d2d`](https://github.com/AncientPatata/layer/commit/70a5d2dcea0ca8b303d1d8458f9a1a9f26b83e04))

layerconf-0.1.0/CLAUDE.md

@@ -0,0 +1,50 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Layer is a Python library for deterministic, multi-source configuration management. It provides a decorator-based system (`@layer_obj`) for defining typed configuration schemas that support layered merging from multiple sources (files, env vars, dicts), categorical validation, variable interpolation, and full source history tracking.
+
+## Commands
+
+```bash
+# Run all tests
+uv run --with pytest pytest
+
+# Run a single test file
+uv run --with pytest pytest tests/test_solidify.py
+
+# Run a single test
+uv run --with pytest pytest tests/test_solidify.py::TestTypeCoercion::test_str_to_int
+
+# Install in development mode (enables plain `pytest` after)
+uv pip install -e ".[dev]"
+
+# Lint
+ruff check src/
+
+# Build
+hatchling build
+```
+
+## Architecture
+
+The intended data flow for configuration objects is: **Schema Definition → Source Loading → Layering → Interpolation → Validation → Freeze/Export**.
+
+Key modules in `src/layer/`:
+
+- **`core.py`** — The `@layer_obj` decorator and `field()` function. The decorator transforms a class into a configuration object with methods like `.layer()`, `.validate()`, `.resolve()`, `.freeze()`, `.explain()`, `.to_dict()`, `.diff()`, `.json_schema()`. This is the central module that ties everything together.
+- **`solidify.py`** — Loading untyped data into typed `@layer_obj` instances. `solidify()` handles dicts, `solidify_file()` handles YAML/JSON/TOML files, `solidify_env()` handles environment variables with prefix conventions. Includes type coercion logic (str → int, bool, float, list, dict).
+- **`validation.py`** — 14 single-field validators (e.g., `require`, `one_of`, `in_range`, `regex`) and 5 cross-field validators (e.g., `requires_if`, `mutually_exclusive`, `depends_on`). Validators follow the signature `(value, field_name, config) -> True | raise ValidationError`. Validation is organized by category so different rule sets run in different contexts.
+- **`interpolation.py`** — Resolves `${field_name}` and `${nested.path}` variable references in string values, with circular reference detection.
+- **`layering.py`** — `LayerRule` enum: OVERRIDE (default), PRESERVE, MERGE (dicts), APPEND (lists).
+- **`sources.py`** — `SourceHistory` and `SourceEntry` dataclasses for tracking which source set each field value.
+- **`exceptions.py`** — Exception hierarchy: `ConfigError` → `ValidationError`, `StructureError`, `LayeringError`, `InterpolationError`.
+
+## Key Design Details
+
+- `field()` returns a `FieldDef` storing type hints, defaults, validators (grouped by category), metadata, description, secret flag, and custom parser.
+- The `@layer_obj` decorator adds `_field_defs`, `_sources`, and `_frozen` to instances. It replaces `FieldDef` class attributes with their default values on instantiation.
+- Tests use a custom harness with global `passed`/`failed` counters (not pytest). The test file runs directly with `python test_features.py` and exits with code 1 on failure.
+- Python >= 3.10.12 required. Uses UV as package manager.