quadkit-cli 0.0.2__tar.gz → 0.0.4__tar.gz

{quadkit_cli-0.0.2 → quadkit_cli-0.0.4}/.gitignore

@@ -28,6 +28,8 @@
 !.importlinter
 !.superpowers/
 !.superpowers/**
+!.gitattributes
+!.editorconfig
 !Makefile
 !docker-compose.test.yml
 !quadkit.yaml.example
@@ -98,69 +100,62 @@ internal-docs/
 # Editor swap files
 *.swp
 
-# Tiered package layout (core/, packages/, experimental/<family>/)
 !core/
 !packages/
-!experimental/
-!experimental/*/
 !core/quadkit*/
 !packages/quadkit*/
-!experimental/*/quadkit*/
 !core/quadkit*/pyproject.toml
 !packages/quadkit*/pyproject.toml
-!experimental/*/quadkit*/pyproject.toml
 !core/quadkit*/CHANGELOG.md
 !packages/quadkit*/CHANGELOG.md
-!experimental/*/quadkit*/CHANGELOG.md
 !core/quadkit*/README.md
 !packages/quadkit*/README.md
-!experimental/*/quadkit*/README.md
 !core/quadkit*/alembic.ini
 !packages/quadkit*/alembic.ini
-!experimental/*/quadkit*/alembic.ini
 !core/quadkit*/mypy.ini
 !packages/quadkit*/mypy.ini
-!experimental/*/quadkit*/mypy.ini
 !core/quadkit*/*.yaml.example
 !packages/quadkit*/*.yaml.example
-!experimental/*/quadkit*/*.yaml.example
 !core/quadkit*/src/
 !core/quadkit*/src/**
 !packages/quadkit*/src/
 !packages/quadkit*/src/**
-!experimental/*/quadkit*/src/
-!experimental/*/quadkit*/src/**
 !core/quadkit*/tests/
 !core/quadkit*/tests/**
 !packages/quadkit*/tests/
 !packages/quadkit*/tests/**
-!experimental/*/quadkit*/tests/
-!experimental/*/quadkit*/tests/**
 !core/quadkit*/docs/
 !core/quadkit*/docs/**
 !packages/quadkit*/docs/
 !packages/quadkit*/docs/**
-!experimental/*/quadkit*/docs/
-!experimental/*/quadkit*/docs/**
 
 # dev/
 !dev/
 !dev/**
 
 # Admin dev playground (committed dev asset; local SQLite files stay ignored)
-!experimental/*/quadkit*/playground/
-!experimental/*/quadkit*/playground/**
-experimental/*/quadkit*/playground/*.db
-experimental/*/quadkit*/playground/*.db-*
+!packages/quadkit-admin/playground/
+!packages/quadkit-admin/playground/serve.py
+
+# gatewai apps
+!apps/
+!apps/**
+!apps/gatewai/
+!apps/gatewai/**
+apps/**/node_modules/
+apps/**/dist/
+apps/**/__pycache__/
+apps/**/*.pyc
+apps/**/*.db
+apps/**/*.db-wal
+apps/**/*.db-shm
 
 # Re-exclude private content under the tiered paths.
 # MUST come after the !...docs/** negations above — last match wins.
 core/quadkit*/docs/plans/
 packages/quadkit*/docs/plans/
-experimental/*/quadkit*/docs/plans/
 core/quadkit*/docs/**/
 packages/quadkit*/docs/**/
-experimental/*/quadkit*/docs/**/
 
 # Re-exclude tooling artifacts under the tiered paths
 __pycache__/
@@ -178,13 +173,11 @@ test.db
 *.log
 !core/quadkit*/tests/fixtures/test.db
 !packages/quadkit*/tests/fixtures/test.db
-!experimental/*/quadkit*/tests/fixtures/test.db
 
 # Allow the generated example gifs to be tracked (README hero images).
 !core/quadkit*/docs/gifs/
 !core/quadkit*/docs/gifs/**
 !packages/*/quadkit*/docs/gifs/
 !packages/*/quadkit*/docs/gifs/**
-!experimental/*/quadkit*/docs/gifs/
-!experimental/*/quadkit*/docs/gifs/**
 examples/*/screenshot.png
+!banner*

quadkit_cli-0.0.4/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.5
+Name: quadkit-cli
+Version: 0.0.4
+Summary: Command-line interface for Quadkit Framework - Project scaffolding, code generation, and development tools
+Project-URL: Homepage, https://dbtinoy-.github.io/quadkit/
+Project-URL: Repository, https://github.com/dbtinoy-/quadkit
+Project-URL: Documentation, https://dbtinoy-.github.io/quadkit/
+Project-URL: Issues, https://github.com/dbtinoy-/quadkit/issues
+Project-URL: Changelog, https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md
+Author-email: Quadkit Framework Team <team@quadkit.dev>
+Maintainer-email: Quadkit Framework Team <team@quadkit.dev>
+License: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: cli,codegen,command-line,devtools,framework,scaffolding
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: aiofiles<26,>=23.0.0
+Requires-Dist: click<9,>=8.1.0
+Requires-Dist: httpx<1,>=0.25.0
+Requires-Dist: jinja2<4,>=3.1.0
+Requires-Dist: pyyaml<7,>=6.0
+Requires-Dist: quadkit-contracts>=0.0.2
+Requires-Dist: quadkit>=0.0.2
+Requires-Dist: rich<14,>=13.0.0
+Requires-Dist: shellingham<2,>=1.5.0
+Requires-Dist: tomli<3,>=2.0.0
+Requires-Dist: typer[all]<1,>=0.9.0
+Requires-Dist: watchfiles<2,>=0.21.0
+Provides-Extra: all
+Requires-Dist: pytest-asyncio<2,>=0.21.0; extra == 'all'
+Requires-Dist: pytest-cov<8,>=4.0.0; extra == 'all'
+Requires-Dist: pytest<10,>=8.0.0; extra == 'all'
+Requires-Dist: quadkit-testing>=0.0.2; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black<27,>=23.0.0; extra == 'dev'
+Requires-Dist: mypy<3,>=1.0.0; extra == 'dev'
+Requires-Dist: ruff<1,>=0.1.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio<2,>=0.21.0; extra == 'test'
+Requires-Dist: pytest-cov<8,>=4.0.0; extra == 'test'
+Requires-Dist: pytest<10,>=8.0.0; extra == 'test'
+Requires-Dist: quadkit-testing>=0.0.2; extra == 'test'
+Description-Content-Type: text/markdown
+
+# quadkit-cli
+
+![Quadkit](https://raw.githubusercontent.com/dbtinoy-/quadkit/main/banner.jpg)
+
+[![PyPI](https://img.shields.io/pypi/v/quadkit-cli?color=%2322c55e&label=pypi)](https://pypi.org/project/quadkit-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/quadkit-cli?color=%2322c55e)](https://pypi.org/project/quadkit-cli/)
+[![License](https://img.shields.io/pypi/l/quadkit-cli?color=%2322c55e)](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE)
+
+The `quadkit` command line: project scaffolding, generators, a smart
+runner, and administrative commands for every stage of the application
+lifecycle. Contributor-based — other packages can register their own
+commands.
+
+For day-to-day Quadkit developers: scaffold, generate, run, inspect.
+
+## The quadkit family
+
+| Package | Role |
+| --- | --- |
+| [`quadkit-contracts`](https://pypi.org/project/quadkit-contracts/) | zero-dependency protocols, types, exception hierarchy |
+| [`quadkit`](https://pypi.org/project/quadkit/) | the framework core — DI container, modules, config, logging, `Result` |
+| [`quadkit-web`](https://pypi.org/project/quadkit-web/) | ASGI layer — controllers, routing, middleware, OpenAPI docs |
+| [`quadkit-cli`](https://pypi.org/project/quadkit-cli/) | project scaffolding and code generators |
+| [`quadkit-testing`](https://pypi.org/project/quadkit-testing/) | in-process test beds, fakes, fixtures |
+
+## Installation
+
+```bash
+uv add quadkit-cli
+# or as a standalone tool:
+uv tool install quadkit-cli
+```
+
+Requires **Python >= 3.11**.
+
+## Minimal working example
+
+There is no code to write — the product is the command line:
+
+```bash
+# Create a new project (template defaults to web-api); the package
+# inside is my_api/ with app.py exposing create_app()
+quadkit new project my-api
+cd my-api
+
+# Generate application code (list all generators: quadkit gen list)
+quadkit gen provider MyProvider
+quadkit gen controller Orders
+
+# Serve the application; reload is on by default, pass --no-reload in prod
+quadkit run my_api.app:create_app --host 0.0.0.0 --port 8000 --workers 4
+```
+
+Eleven generators ship today (`quadkit gen list`):
+
+```text
+controller  middleware  graphql  webhook  websocket  exception_filter
+interceptor  error  resource  provider  test
+```
+
+Global options: `--json` for machine-readable output, `--quiet`,
+`--debug`, `--no-color`, and `--config <path>` to point at a specific
+`application.yaml`.
+
+## Command index
+
+| Command | Purpose |
+| --- | --- |
+| `quadkit new project / module / package` | scaffold projects, bounded contexts, and `quadkit-*` extensions |
+| `quadkit init` | initialize Quadkit in an existing project |
+| `quadkit add <provider>` | add a provider to a project (e.g. `database`, `auth`) |
+| `quadkit run [target]` | smart runner — auto-detects `create_app`, sets profile |
+| `quadkit dev start` | production-server startup |
+| `quadkit gen <what>` | code generation (controllers, providers, middleware, tests, more — see `quadkit gen list`) |
+| `quadkit test` / `quadkit lint` | project-level checks |
+| `quadkit db` / `quadkit events` | database / event-schema management |
+| `quadkit config` / `quadkit inspect` / `quadkit shell` | configuration, runtime introspection, REPL |
+| `quadkit project` / `quadkit contrib` / `quadkit system` | project tasks, contributors, system info |
+| `quadkit version` | framework and package versions |
+
+Per-distribution guide:
+[quadkit-cli reference](https://dbtinoy-.github.io/quadkit/reference/quadkit-cli/).
+
+## Optional extras
+
+`[dev]` and `[test]` bundle tooling; `[all]` pulls everything.
+
+## Configuration
+
+The CLI reads `application.yaml` like any Quadkit application; its own
+section is `cli` (`color`), overridable via `QK_CLI__*`, e.g.
+`QK_CLI__COLOR=false`.
+
+## Error handling
+
+Commands report structured failures (use `--json` for machine-readable
+envelopes) and non-zero exit codes; `--debug` surfaces full tracebacks.
+
+## Testing
+
+`quadkit test` runs the project suite; the CLI's own behavior is
+covered by the public test set the release pipeline executes from the
+exported tree.
+
+## Security
+
+The CLI reads configuration and scaffolds code — it does not serve
+traffic. As with every distribution, keep the `0.x` line pinned and
+review release notes on upgrade. Report vulnerabilities privately per
+[SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md).
+
+## Stability
+
+Version `0.0.3` in the `0.x` series, released in lockstep with the
+other four distributions; APIs may change between minor versions until
+1.0 — pin an exact version (`quadkit-cli==0.0.3`) or a tight range
+(`>=0.0.3,<0.1.0`). Full policy:
+[stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
+
+## Links
+
+- **Documentation** — <https://dbtinoy-.github.io/quadkit/>
+- **Getting started** — <https://dbtinoy-.github.io/quadkit/getting-started/installation/>
+- **Changelog** — <https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md>
+- **Issues** — <https://github.com/dbtinoy-/quadkit/issues>
+- **Security** — report privately per [SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md)
+- **Contributing** — [CONTRIBUTING.md](https://github.com/dbtinoy-/quadkit/blob/main/CONTRIBUTING.md)
+
+Apache-2.0 — see [LICENSE](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE). "Quadkit" and the
+Quadkit logo are trademarks of the project — see
+[TRADEMARK.md](https://github.com/dbtinoy-/quadkit/blob/main/TRADEMARK.md).

quadkit_cli-0.0.4/README.md

@@ -0,0 +1,131 @@
+# quadkit-cli
+
+![Quadkit](https://raw.githubusercontent.com/dbtinoy-/quadkit/main/banner.jpg)
+
+[![PyPI](https://img.shields.io/pypi/v/quadkit-cli?color=%2322c55e&label=pypi)](https://pypi.org/project/quadkit-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/quadkit-cli?color=%2322c55e)](https://pypi.org/project/quadkit-cli/)
+[![License](https://img.shields.io/pypi/l/quadkit-cli?color=%2322c55e)](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE)
+
+The `quadkit` command line: project scaffolding, generators, a smart
+runner, and administrative commands for every stage of the application
+lifecycle. Contributor-based — other packages can register their own
+commands.
+
+For day-to-day Quadkit developers: scaffold, generate, run, inspect.
+
+## The quadkit family
+
+| Package | Role |
+| --- | --- |
+| [`quadkit-contracts`](https://pypi.org/project/quadkit-contracts/) | zero-dependency protocols, types, exception hierarchy |
+| [`quadkit`](https://pypi.org/project/quadkit/) | the framework core — DI container, modules, config, logging, `Result` |
+| [`quadkit-web`](https://pypi.org/project/quadkit-web/) | ASGI layer — controllers, routing, middleware, OpenAPI docs |
+| [`quadkit-cli`](https://pypi.org/project/quadkit-cli/) | project scaffolding and code generators |
+| [`quadkit-testing`](https://pypi.org/project/quadkit-testing/) | in-process test beds, fakes, fixtures |
+
+## Installation
+
+```bash
+uv add quadkit-cli
+# or as a standalone tool:
+uv tool install quadkit-cli
+```
+
+Requires **Python >= 3.11**.
+
+## Minimal working example
+
+There is no code to write — the product is the command line:
+
+```bash
+# Create a new project (template defaults to web-api); the package
+# inside is my_api/ with app.py exposing create_app()
+quadkit new project my-api
+cd my-api
+
+# Generate application code (list all generators: quadkit gen list)
+quadkit gen provider MyProvider
+quadkit gen controller Orders
+
+# Serve the application; reload is on by default, pass --no-reload in prod
+quadkit run my_api.app:create_app --host 0.0.0.0 --port 8000 --workers 4
+```
+
+Eleven generators ship today (`quadkit gen list`):
+
+```text
+controller  middleware  graphql  webhook  websocket  exception_filter
+interceptor  error  resource  provider  test
+```
+
+Global options: `--json` for machine-readable output, `--quiet`,
+`--debug`, `--no-color`, and `--config <path>` to point at a specific
+`application.yaml`.
+
+## Command index
+
+| Command | Purpose |
+| --- | --- |
+| `quadkit new project / module / package` | scaffold projects, bounded contexts, and `quadkit-*` extensions |
+| `quadkit init` | initialize Quadkit in an existing project |
+| `quadkit add <provider>` | add a provider to a project (e.g. `database`, `auth`) |
+| `quadkit run [target]` | smart runner — auto-detects `create_app`, sets profile |
+| `quadkit dev start` | production-server startup |
+| `quadkit gen <what>` | code generation (controllers, providers, middleware, tests, more — see `quadkit gen list`) |
+| `quadkit test` / `quadkit lint` | project-level checks |
+| `quadkit db` / `quadkit events` | database / event-schema management |
+| `quadkit config` / `quadkit inspect` / `quadkit shell` | configuration, runtime introspection, REPL |
+| `quadkit project` / `quadkit contrib` / `quadkit system` | project tasks, contributors, system info |
+| `quadkit version` | framework and package versions |
+
+Per-distribution guide:
+[quadkit-cli reference](https://dbtinoy-.github.io/quadkit/reference/quadkit-cli/).
+
+## Optional extras
+
+`[dev]` and `[test]` bundle tooling; `[all]` pulls everything.
+
+## Configuration
+
+The CLI reads `application.yaml` like any Quadkit application; its own
+section is `cli` (`color`), overridable via `QK_CLI__*`, e.g.
+`QK_CLI__COLOR=false`.
+
+## Error handling
+
+Commands report structured failures (use `--json` for machine-readable
+envelopes) and non-zero exit codes; `--debug` surfaces full tracebacks.
+
+## Testing
+
+`quadkit test` runs the project suite; the CLI's own behavior is
+covered by the public test set the release pipeline executes from the
+exported tree.
+
+## Security
+
+The CLI reads configuration and scaffolds code — it does not serve
+traffic. As with every distribution, keep the `0.x` line pinned and
+review release notes on upgrade. Report vulnerabilities privately per
+[SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md).
+
+## Stability
+
+Version `0.0.3` in the `0.x` series, released in lockstep with the
+other four distributions; APIs may change between minor versions until
+1.0 — pin an exact version (`quadkit-cli==0.0.3`) or a tight range
+(`>=0.0.3,<0.1.0`). Full policy:
+[stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
+
+## Links
+
+- **Documentation** — <https://dbtinoy-.github.io/quadkit/>
+- **Getting started** — <https://dbtinoy-.github.io/quadkit/getting-started/installation/>
+- **Changelog** — <https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md>
+- **Issues** — <https://github.com/dbtinoy-/quadkit/issues>
+- **Security** — report privately per [SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md)
+- **Contributing** — [CONTRIBUTING.md](https://github.com/dbtinoy-/quadkit/blob/main/CONTRIBUTING.md)
+
+Apache-2.0 — see [LICENSE](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE). "Quadkit" and the
+Quadkit logo are trademarks of the project — see
+[TRADEMARK.md](https://github.com/dbtinoy-/quadkit/blob/main/TRADEMARK.md).