eggpipe 0.3.0__tar.gz → 0.3.1__tar.gz

{eggpipe-0.3.0 → eggpipe-0.3.1}/CHANGELOG.md

@@ -5,6 +5,14 @@
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-11-13
+
+### Changed
+
+- PyPI-страница использует отдельный пользовательский `README-pypi.md` без инженерной
+  документации и команд разработки.
+- Основной `README.md` остаётся полным описанием для GitHub.
+
 ## [0.3.0] - 2026-11-13
 
 ### Changed

{eggpipe-0.3.0 → eggpipe-0.3.1}/CONTRIBUTING.md

@@ -47,6 +47,23 @@ uv run python tools/check_wheel.py dist
 - При изменении версии обнови `engineering/requirements/index.md`, System Design, README,
   `.session-context.md` и harness-файлы, где указана актуальная версия.
 
+## Ветки и main
+
+`main` защищён: прямые коммиты и push запрещены. Любое изменение идёт через отдельную
+ветку и pull request.
+
+```bash
+git switch -c type/short-description
+# изменения и коммиты
+git push -u origin type/short-description
+```
+
+Затем открой PR в `main`. Merge разрешён только после зелёных проверок `ci` и `docs`.
+Force-push в `main` и удаление ветки `main` запрещены.
+
+Для соло-разработки достаточно PR без обязательного внешнего approval: проверки CI
+и самостоятельный review остаются обязательными.
+
 ## Pull request
 
 - Один PR — одна логическая задача.

eggpipe-0.3.1/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.5
+Name: eggpipe
+Version: 0.3.1
+Summary: CLI tool and library for metadata-driven code generation
+Project-URL: Homepage, https://github.com/SpiGit/eggpipe
+Project-URL: Documentation, https://github.com/SpiGit/eggpipe/tree/main/docs
+Project-URL: Repository, https://github.com/SpiGit/eggpipe
+Project-URL: Changelog, https://github.com/SpiGit/eggpipe/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/SpiGit/eggpipe/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: code-generation,metadata,pydantic,yaml
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: pydantic-settings>=2.2.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: ruamel-yaml>=0.18.6
+Requires-Dist: typer>=0.12.0
+Requires-Dist: typing-extensions>=4.10.0
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6.100.0; extra == 'dev'
+Requires-Dist: jinja2>=3.1.0; extra == 'dev'
+Requires-Dist: mkdocs>=1.6.0; extra == 'dev'
+Requires-Dist: pyrefly>=1.4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: watchdog>=4.0.0; extra == 'dev'
+Provides-Extra: jinja
+Requires-Dist: jinja2>=3.1.0; extra == 'jinja'
+Provides-Extra: watch
+Requires-Dist: watchdog>=4.0.0; extra == 'watch'
+Description-Content-Type: text/markdown
+
+# Eggpipe
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SpiGit/eggpipe/main/docs/assets/brand/lockup/eggpipe-wordmark-light.png" alt="Eggpipe" width="420">
+</p>
+
+Eggpipe generates SQL, Python, TypeScript, OpenAPI and other artifacts from a single
+YAML model description.
+
+> **Beta (0.x).** Until 1.0, the public API, CLI, config format and generated artifacts
+> may change without backward compatibility. Pin the version for production and read
+> the changelog before upgrading.
+
+## Install
+
+```bash
+pip install eggpipe
+```
+
+Python 3.11+ is required.
+
+Optional extras:
+
+```bash
+pip install "eggpipe[watch]"   # watch mode
+pip install "eggpipe[jinja]"   # Jinja2 helper for plugins
+```
+
+## CLI
+
+```bash
+eggpipe init
+eggpipe generate model.yaml
+eggpipe generate --plan
+eggpipe generate --check
+eggpipe watch model.yaml
+```
+
+## Library
+
+```python
+from eggpipe import AppConfig, Engine, ProjectConfigLoader
+
+rules = ProjectConfigLoader().load(".eggpipe.yaml")
+engine = Engine(AppConfig(), rules)
+
+report = engine.build()       # parse, validate and generate without writing
+report = engine.generate()    # build + write artifacts
+report = engine.check()       # check drift without writing
+
+if not report.success:
+    for diagnostic in report.diagnostics:
+        print(diagnostic.code, diagnostic.message)
+```
+
+## Plugins
+
+Generators and document formats are plugins registered through entry points:
+
+```toml
+[project.entry-points."eggpipe.generators"]
+my-generator = "my_package:my_generator"
+
+[project.entry-points."eggpipe.formats"]
+sql-model = "my_package:SqlModelFormat"
+```
+
+## Documentation
+
+- [Documentation](https://github.com/SpiGit/eggpipe/tree/main/docs)
+- [Quick start](https://github.com/SpiGit/eggpipe/blob/main/docs/user/quickstart.md)
+- [CLI reference](https://github.com/SpiGit/eggpipe/blob/main/docs/user/cli.md)
+- [Plugin guide](https://github.com/SpiGit/eggpipe/blob/main/docs/user/plugins.md)
+- [Changelog](https://github.com/SpiGit/eggpipe/blob/main/CHANGELOG.md)
+- [Issues](https://github.com/SpiGit/eggpipe/issues)
+
+## License
+
+MIT

eggpipe-0.3.1/README-pypi.md

@@ -0,0 +1,79 @@
+# Eggpipe
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SpiGit/eggpipe/main/docs/assets/brand/lockup/eggpipe-wordmark-light.png" alt="Eggpipe" width="420">
+</p>
+
+Eggpipe generates SQL, Python, TypeScript, OpenAPI and other artifacts from a single
+YAML model description.
+
+> **Beta (0.x).** Until 1.0, the public API, CLI, config format and generated artifacts
+> may change without backward compatibility. Pin the version for production and read
+> the changelog before upgrading.
+
+## Install
+
+```bash
+pip install eggpipe
+```
+
+Python 3.11+ is required.
+
+Optional extras:
+
+```bash
+pip install "eggpipe[watch]"   # watch mode
+pip install "eggpipe[jinja]"   # Jinja2 helper for plugins
+```
+
+## CLI
+
+```bash
+eggpipe init
+eggpipe generate model.yaml
+eggpipe generate --plan
+eggpipe generate --check
+eggpipe watch model.yaml
+```
+
+## Library
+
+```python
+from eggpipe import AppConfig, Engine, ProjectConfigLoader
+
+rules = ProjectConfigLoader().load(".eggpipe.yaml")
+engine = Engine(AppConfig(), rules)
+
+report = engine.build()       # parse, validate and generate without writing
+report = engine.generate()    # build + write artifacts
+report = engine.check()       # check drift without writing
+
+if not report.success:
+    for diagnostic in report.diagnostics:
+        print(diagnostic.code, diagnostic.message)
+```
+
+## Plugins
+
+Generators and document formats are plugins registered through entry points:
+
+```toml
+[project.entry-points."eggpipe.generators"]
+my-generator = "my_package:my_generator"
+
+[project.entry-points."eggpipe.formats"]
+sql-model = "my_package:SqlModelFormat"
+```
+
+## Documentation
+
+- [Documentation](https://github.com/SpiGit/eggpipe/tree/main/docs)
+- [Quick start](https://github.com/SpiGit/eggpipe/blob/main/docs/user/quickstart.md)
+- [CLI reference](https://github.com/SpiGit/eggpipe/blob/main/docs/user/cli.md)
+- [Plugin guide](https://github.com/SpiGit/eggpipe/blob/main/docs/user/plugins.md)
+- [Changelog](https://github.com/SpiGit/eggpipe/blob/main/CHANGELOG.md)
+- [Issues](https://github.com/SpiGit/eggpipe/issues)
+
+## License
+
+MIT

{eggpipe-0.3.0 → eggpipe-0.3.1}/README.md

@@ -205,5 +205,5 @@ uv run python tools/check_docs.py --strict
 
 ## Статус
 
-**Стадия:** Eggpipe 0.3.0, ТЗ v2.2. Реализованы E0–E8 и E9: пакет/CLI/config/state,
-форматы и слои, decorator API, глобальный manifest, CLI/JSON v2, CI и release workflow.
+**Стадия:** Eggpipe 0.3.1, ТЗ v2.2. Реализованы E0–E9, пакет опубликован на PyPI:
+CLI/config/state, форматы и слои, decorator API, глобальный manifest, CLI/JSON v2, CI и release workflow.

{eggpipe-0.3.0 → eggpipe-0.3.1}/docs/ai/context.md

@@ -8,7 +8,7 @@
 - Package/import/CLI: `eggpipe`.
 - Конфиг: `.eggpipe.yaml`; state: `.eggpipe/`.
 - Актуальное ТЗ: `engineering/requirements/v2.2.md`.
-- Версия пакета: `0.3.0`; версия ТЗ: `2.2`.
+- Версия пакета: `0.3.1`; версия ТЗ: `2.2`.
 - Статус: beta (0.x); до 1.0 breaking changes возможны (ADR-0014).
 - Brand assets: `docs/assets/brand/`.
 

{eggpipe-0.3.0 → eggpipe-0.3.1}/docs/ai/llms-full.txt

@@ -14,7 +14,7 @@
 - Package/import/CLI: `eggpipe`.
 - Конфиг: `.eggpipe.yaml`; state: `.eggpipe/`.
 - Актуальное ТЗ: `engineering/requirements/v2.2.md`.
-- Версия пакета: `0.3.0`; версия ТЗ: `2.2`.
+- Версия пакета: `0.3.1`; версия ТЗ: `2.2`.
 - Статус: beta (0.x); до 1.0 breaking changes возможны (ADR-0014).
 - Brand assets: `docs/assets/brand/`.
 
@@ -289,13 +289,13 @@ generators:
 
 ## Как обновляться
 
-1. Зафиксируйте точную версию, например `eggpipe==0.3.0`.
+1. Зафиксируйте точную версию, например `eggpipe==0.3.1`.
 2. Прочитайте `CHANGELOG.md` перед обновлением.
 3. Прогоните `eggpipe generate --check` в CI, чтобы поймать drift артефактов.
 
 ## Миграция с v1.x
 
-Публичного релиза v1.x не было, поэтому миграция не требуется. Все версии до 0.3.0
+Публичного релиза v1.x не было, поэтому миграция не требуется. Все версии до 0.3.1
 относятся к разработке проекта.
 
 ## После 1.0

{eggpipe-0.3.0 → eggpipe-0.3.1}/docs/ai/manifest.json

@@ -98,7 +98,7 @@
       "path": "engineering/system-design/index.md"
     }
   ],
-  "package_version": "0.3.0",
+  "package_version": "0.3.1",
   "project": "eggpipe",
   "public_api": [
     "AppConfig",

{eggpipe-0.3.0 → eggpipe-0.3.1}/docs/user/status.md

@@ -19,13 +19,13 @@
 
 ## Как обновляться
 
-1. Зафиксируйте точную версию, например `eggpipe==0.3.0`.
+1. Зафиксируйте точную версию, например `eggpipe==0.3.1`.
 2. Прочитайте `CHANGELOG.md` перед обновлением.
 3. Прогоните `eggpipe generate --check` в CI, чтобы поймать drift артефактов.
 
 ## Миграция с v1.x
 
-Публичного релиза v1.x не было, поэтому миграция не требуется. Все версии до 0.3.0
+Публичного релиза v1.x не было, поэтому миграция не требуется. Все версии до 0.3.1
 относятся к разработке проекта.
 
 ## После 1.0

{eggpipe-0.3.0 → eggpipe-0.3.1}/engineering/adr/0014-beta-status-and-compatibility.md

@@ -27,7 +27,7 @@ CI-проверки и автоматизация.
   может расширяться, а условия срабатывания — уточняться.
 - Сгенерированные файлы не являются публичным API: шаблоны и структура вывода могут
   меняться между версиями.
-- Для production рекомендуется фиксировать точную версию (`eggpipe==0.3.0`) и читать
+- Для production рекомендуется фиксировать точную версию (`eggpipe==0.3.1`) и читать
   `CHANGELOG.md` перед обновлением.
 - После выпуска **1.0** проект переходит на обычные гарантии SemVer: breaking changes —
   только в major-версиях.

{eggpipe-0.3.0 → eggpipe-0.3.1}/engineering/plan-v2.md

@@ -188,7 +188,7 @@
 - [x] `uv build`/`check_wheel`.
 - [x] CI: example install, config names.
 - [x] Release docs: PyPI name `eggpipe`, trusted publisher, repo name.
-- [x] Версия пакета: 0.3.0.
+- [x] Версия пакета: 0.3.1.
 
 **Критерий:** все проверки зелёные; release workflow готов.
 
@@ -240,6 +240,6 @@
 - [x] `check_docs --strict`, `mkdocs --strict`.
 - [x] `ruff`, `pyrefly`, `pytest --cov`.
 - [x] `uv build`, `check_wheel`.
-- [ ] `eggpipe` install/run из PyPI.
+- [x] `eggpipe` install/run из PyPI.
 - [x] TPC-H golden.
 - [x] Release checklist обновлён.

{eggpipe-0.3.0 → eggpipe-0.3.1}/engineering/release.md

@@ -26,11 +26,13 @@
 
 ## Публикация
 
+Тег ставится только на `main` после merge release PR. Прямой push в `main` запрещён.
+
 Релиз запускается тегом:
 
 ```bash
-git tag v0.3.0
-git push origin v0.3.0
+git tag v0.3.1
+git push origin v0.3.1
 ```
 
 Workflow `.github/workflows/release.yml`:
@@ -56,7 +58,7 @@ Workflow `.github/workflows/release.yml`:
 5. Запушить тег:
 
    ```bash
-   git push origin v0.3.0
+   git push origin v0.3.1
    ```
 
 Без `PYPI_PUBLISH=true` артефакты публикуются только в GitHub Release.

{eggpipe-0.3.0 → eggpipe-0.3.1}/engineering/system-design/index.md

@@ -1249,7 +1249,7 @@ class ExecutionPlan:
     {
       "generator": "oracle-ddl",
       "output_dir": "output/oracle",
-      "eggpipe_version": "0.3.0",
+      "eggpipe_version": "0.3.1",
       "plugin_version": "1.2.0",
       "formats": [{"name": "entity-model", "version": "1.0"}],
       "generated_at": "2026-11-11T12:34:56Z",
@@ -1478,7 +1478,7 @@ def test_invalid_models_produce_expected_code(data) -> None:
 ```toml
 [project]
 name = "eggpipe"
-version = "0.3.0"
+version = "0.3.1"
 description = "CLI tool and library for metadata-driven code generation"
 readme = "README.md"
 license = "MIT"

{eggpipe-0.3.0 → eggpipe-0.3.1}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "eggpipe"
-version = "0.3.0"
+version = "0.3.1"
 description = "CLI tool and library for metadata-driven code generation"
-readme = "README.md"
+readme = "README-pypi.md"
 license = "MIT"
 license-files = ["LICENSE"]
 requires-python = ">=3.11"

{eggpipe-0.3.0 → eggpipe-0.3.1}/src/eggpipe/version.py

@@ -1,3 +1,3 @@
 """Package version in one place."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{eggpipe-0.3.0 → eggpipe-0.3.1}/tests/test_artifact_writer.py

@@ -14,7 +14,7 @@ from eggpipe.utils.exceptions import LockError, ManifestError
 
 
 def writer(tmp_path: Path) -> ArtifactWriter:
-    return ArtifactWriter(eggpipe_version="0.3.0", config_dir=tmp_path)
+    return ArtifactWriter(eggpipe_version="0.3.1", config_dir=tmp_path)
 
 
 def plan_for(

{eggpipe-0.3.0 → eggpipe-0.3.1}/tests/test_check_wheel.py

@@ -14,9 +14,9 @@ def test_dependency_name_normalizes_distribution_names() -> None:
 def test_relative_sdist_names_strips_root_prefix() -> None:
     names = relative_sdist_names(
         [
-            "eggpipe-0.3.0/pyproject.toml",
-            "eggpipe-0.3.0/src/eggpipe/__init__.py",
-            "eggpipe-0.3.0",
+            "eggpipe-0.3.1/pyproject.toml",
+            "eggpipe-0.3.1/src/eggpipe/__init__.py",
+            "eggpipe-0.3.1",
         ]
     )
     assert names == {

{eggpipe-0.3.0 → eggpipe-0.3.1}/tests/test_package.py

@@ -6,7 +6,7 @@ import eggpipe
 
 
 def test_version() -> None:
-    assert eggpipe.__version__ == "0.3.0"
+    assert eggpipe.__version__ == "0.3.1"
 
 
 def test_public_api_exports_core_models() -> None:

{eggpipe-0.3.0 → eggpipe-0.3.1}/tools/check_docs.py

@@ -50,6 +50,7 @@ REQUIRED_FILES = (
     ".github/workflows/release.yml",
     "AGENTS.md",
     "README.md",
+    "README-pypi.md",
     "CHANGELOG.md",
     "CONTRIBUTING.md",
     "LICENSE",

{eggpipe-0.3.0 → eggpipe-0.3.1}/tools/check_wheel.py

@@ -30,6 +30,7 @@ REQUIRED_WHEEL_FILES = {
 REQUIRED_SDIST_FILES = {
     "pyproject.toml",
     "README.md",
+    "README-pypi.md",
     "LICENSE",
     "src/eggpipe/__init__.py",
     "src/eggpipe/py.typed",