quadkit-cli 0.0.44__tar.gz → 0.0.46__tar.gz

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.5
 Name: quadkit-cli
-Version: 0.0.44
+Version: 0.0.46
 Summary: Command-line interface for Quadkit Framework - Project scaffolding, code generation, and development tools
-Project-URL: Homepage, https://dbtinoy-.github.io/quadkit/
+Project-URL: Homepage, https://oridecon.dev
 Project-URL: Repository, https://github.com/dbtinoy-/quadkit
-Project-URL: Documentation, https://dbtinoy-.github.io/quadkit/
+Project-URL: Documentation, https://oridecon.dev/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>
+Author-email: Quadkit Framework Team <hello@oridecon.dev>
+Maintainer-email: Quadkit Framework Team <hello@oridecon.dev>
 License: Apache-2.0
 License-File: LICENSE
 License-File: NOTICE
@@ -94,7 +94,7 @@ Requires **Python >= 3.11**.
 There is no code to write — the product is the command line:
 
 ```bash
-# Create a new project (template defaults to web-api); the package
+# Create a new project (single `api` template); the package
 # inside is my_api/ with app.py exposing create_app()
 quadkit new project my-api
 cd my-api
@@ -135,7 +135,7 @@ Global options: `--json` for machine-readable output, `--quiet`,
 | `quadkit version` | framework and package versions |
 
 Per-distribution guide:
-[quadkit-cli reference](https://dbtinoy-.github.io/quadkit/reference/quadkit-cli/).
+[quadkit-cli reference](https://oridecon.dev/quadkit/reference/cli/).
 
 ## Optional extras
 
@@ -167,16 +167,16 @@ review release notes on upgrade. Report vulnerabilities privately per
 
 ## Stability
 
-Version `0.0.44` 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.44`) or a tight range
-(`>=0.0.44,<0.1.0`). Full policy:
-[stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
+Version `0.0.46` in the `0.x` series, released in lockstep with the
+other twelve distributions; APIs may change between minor versions until
+1.0 — pin an exact version (`quadkit-cli==0.0.46`) or a tight range
+(`>=0.0.46,<0.1.0`). Full policy:
+[stability and compatibility](https://oridecon.dev/quadkit/ecosystem/compatibility/).
 
 ## Links
 
-- **Documentation** — <https://dbtinoy-.github.io/quadkit/>
-- **Getting started** — <https://dbtinoy-.github.io/quadkit/getting-started/installation/>
+- **Documentation** — <https://oridecon.dev/quadkit/>
+- **Getting started** — <https://oridecon.dev/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)

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/README.md

@@ -38,7 +38,7 @@ Requires **Python >= 3.11**.
 There is no code to write — the product is the command line:
 
 ```bash
-# Create a new project (template defaults to web-api); the package
+# Create a new project (single `api` template); the package
 # inside is my_api/ with app.py exposing create_app()
 quadkit new project my-api
 cd my-api
@@ -79,7 +79,7 @@ Global options: `--json` for machine-readable output, `--quiet`,
 | `quadkit version` | framework and package versions |
 
 Per-distribution guide:
-[quadkit-cli reference](https://dbtinoy-.github.io/quadkit/reference/quadkit-cli/).
+[quadkit-cli reference](https://oridecon.dev/quadkit/reference/cli/).
 
 ## Optional extras
 
@@ -111,16 +111,16 @@ review release notes on upgrade. Report vulnerabilities privately per
 
 ## Stability
 
-Version `0.0.44` 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.44`) or a tight range
-(`>=0.0.44,<0.1.0`). Full policy:
-[stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
+Version `0.0.46` in the `0.x` series, released in lockstep with the
+other twelve distributions; APIs may change between minor versions until
+1.0 — pin an exact version (`quadkit-cli==0.0.46`) or a tight range
+(`>=0.0.46,<0.1.0`). Full policy:
+[stability and compatibility](https://oridecon.dev/quadkit/ecosystem/compatibility/).
 
 ## Links
 
-- **Documentation** — <https://dbtinoy-.github.io/quadkit/>
-- **Getting started** — <https://dbtinoy-.github.io/quadkit/getting-started/installation/>
+- **Documentation** — <https://oridecon.dev/quadkit/>
+- **Getting started** — <https://oridecon.dev/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)

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quadkit-cli"
-version = "0.0.44"
+version = "0.0.46"
 description = "Command-line interface for Quadkit Framework - Project scaffolding, code generation, and development tools"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -47,10 +47,10 @@ dependencies = [
     "tomli>=2.0.0,<3",
 ]
 authors = [
-    { name = "Quadkit Framework Team", email = "team@quadkit.dev" },
+    { name = "Quadkit Framework Team", email = "hello@oridecon.dev" },
 ]
 maintainers = [
-    { name = "Quadkit Framework Team", email = "team@quadkit.dev" },
+    { name = "Quadkit Framework Team", email = "hello@oridecon.dev" },
 ]
 
 [project.license]
@@ -82,9 +82,9 @@ all = [
 ]
 
 [project.urls]
-Homepage = "https://dbtinoy-.github.io/quadkit/"
+Homepage = "https://oridecon.dev"
 Repository = "https://github.com/dbtinoy-/quadkit"
-Documentation = "https://dbtinoy-.github.io/quadkit/"
+Documentation = "https://oridecon.dev/quadkit/"
 Issues = "https://github.com/dbtinoy-/quadkit/issues"
 Changelog = "https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md"
 

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/commands/config.py

@@ -151,7 +151,7 @@ def init(
                 default_config,
                 header=(
                     "# Quadkit Framework Configuration\n"
-                    f"# Documented at {DOCS_BASE_URL}/config\n\n"
+                    f"# Documented at {DOCS_BASE_URL}/getting-started/configuration/\n\n"
                 ),
             )
 

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/commands/events.py

@@ -201,4 +201,4 @@ def replay(
         "  [cyan]await bus.replay(event_type='UserCreated', since=start_time)[/cyan]"
     )
     out.print()
-    out.print(f"See: {DOCS_BASE_URL}/events/replay")
+    out.print(f"See: {DOCS_BASE_URL}/packages/events/quadkit-events/docs/guide/")

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/commands/new.py

@@ -35,10 +35,7 @@ def main(
         "api",
         "--template",
         "-t",
-        help=(
-            "Project template "
-            f"(available in this install: {', '.join(template_names())})"
-        ),
+        help=f"Project template (the only template: {', '.join(template_names())})",
     ),
     directory: str = typer.Option(".", "--directory", "-d", help="Target directory"),
     interactive: bool = typer.Option(
@@ -53,13 +50,14 @@ def main(
     project_name = _valid_name(name, "Project")
     selected_template = template
 
-    if interactive:
+    names = template_names()
+    if interactive and len(names) > 1:
         import click
 
         selected_template = typer.prompt(
             "Select a template",
             default="api",
-            type=click.Choice(template_names()),
+            type=click.Choice(names),
         )
 
     try:

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/registry/__init__.py

@@ -128,15 +128,10 @@ if TYPE_CHECKING:
         TasksInspector,
     )
     from quadkit.cli.registry.presets import (
-        FullStackPreset,
-        GraphQLPreset,
-        MicroservicePreset,
-        MinimalPreset,
+        ApiPreset,
         Preset,
         PresetDefinition,
         PresetRegistry,
-        WebAPIPreset,
-        WorkerPreset,
     )
     from quadkit.cli.registry.provider import (
         AdminProvider,
@@ -200,15 +195,11 @@ if TYPE_CHECKING:
         get_telemetry_status,
     )
     from quadkit.cli.registry.template import (
-        FullStackTemplate,
-        GraphQLTemplate,
-        MinimalTemplate,
+        ApiTemplate,
         ProjectBuilder,
         ProjectTemplate,
         TemplateConfig,
         TemplateRegistry,
-        WebAPITemplate,
-        WorkerTemplate,
     )
     from quadkit.cli.registry.version import (
         VersionInfo,

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/registry/_lazy_exports.py

@@ -11,6 +11,8 @@ from __future__ import annotations
 LAZY_IMPORTS: dict[str, str] = {
     "AIProvider": "quadkit.cli.registry.provider",
     "AdminProvider": "quadkit.cli.registry.provider",
+    "ApiPreset": "quadkit.cli.registry.presets",
+    "ApiTemplate": "quadkit.cli.registry.template",
     "AuthConfigValidator": "quadkit.cli.registry.config",
     "AuthProvider": "quadkit.cli.registry.provider",
     "BashCompletionGenerator": "quadkit.cli.registry.completion",
@@ -46,16 +48,12 @@ LAZY_IMPORTS: dict[str, str] = {
     "FishCompletionGenerator": "quadkit.cli.registry.completion",
     "FormatOptions": "quadkit.cli.registry.formatter",
     "FormatterRegistry": "quadkit.cli.registry.formatter",
-    "FullStackPreset": "quadkit.cli.registry.presets",
-    "FullStackTemplate": "quadkit.cli.registry.template",
     "GeneratorAdapter": "quadkit.cli.registry.generator",
     "GeneratorRegistry": "quadkit.cli.registry.generator",
     "GeneratorResult": "quadkit.cli.registry.generator",
     "GitCheck": "quadkit.cli.registry.health",
     "GranianBackend": "quadkit.cli.registry.server",
-    "GraphQLPreset": "quadkit.cli.registry.presets",
     "GraphQLProvider": "quadkit.cli.registry.provider",
-    "GraphQLTemplate": "quadkit.cli.registry.template",
     "GunicornBackend": "quadkit.cli.registry.server",
     "HealthCheck": "quadkit.cli.registry.health",
     "HealthCheckRegistry": "quadkit.cli.registry.health",
@@ -73,10 +71,7 @@ LAZY_IMPORTS: dict[str, str] = {
     "JSONFormatter": "quadkit.cli.registry.formatter",
     "LoggingHook": "quadkit.cli.registry.hook",
     "MessagingProvider": "quadkit.cli.registry.provider",
-    "MicroservicePreset": "quadkit.cli.registry.presets",
     "MiddlewareInspector": "quadkit.cli.registry.inspect",
-    "MinimalPreset": "quadkit.cli.registry.presets",
-    "MinimalTemplate": "quadkit.cli.registry.template",
     "MonitorProvider": "quadkit.cli.registry.provider",
     "MonitoringProvider": "quadkit.cli.registry.provider",
     "MySQLBackend": "quadkit.cli.registry.database",
@@ -141,11 +136,7 @@ LAZY_IMPORTS: dict[str, str] = {
     "VersionInfo": "quadkit.cli.registry.version",
     "VersionRegistry": "quadkit.cli.registry.version",
     "VersionSource": "quadkit.cli.registry.version",
-    "WebAPIPreset": "quadkit.cli.registry.presets",
-    "WebAPITemplate": "quadkit.cli.registry.template",
     "WebProvider": "quadkit.cli.registry.provider",
-    "WorkerPreset": "quadkit.cli.registry.presets",
-    "WorkerTemplate": "quadkit.cli.registry.template",
     "YAMLFormatter": "quadkit.cli.registry.formatter",
     "ZshCompletionGenerator": "quadkit.cli.registry.completion",
     "create_database_connection": "quadkit.cli.registry.database",

quadkit_cli-0.0.46/src/quadkit/cli/registry/presets.py

@@ -0,0 +1,104 @@
+"""Presets registry for application presets.
+
+This module provides a registry pattern for application presets.
+"""
+
+from __future__ import annotations
+
+import abc
+from dataclasses import dataclass, field
+from typing import Any, ClassVar
+
+from quadkit.cli.package_names import packages_for
+
+
+@dataclass
+class Preset:
+    """A preset configuration of providers."""
+
+    name: str
+    description: str
+    packages: list[str] = field(default_factory=list)
+    config: dict[str, Any] = field(default_factory=dict)
+
+
+class PresetDefinition(abc.ABC):
+    """Abstract base class for preset definitions."""
+
+    name: ClassVar[str]
+    description: ClassVar[str]
+    packages: ClassVar[list[str]] = []
+    config: ClassVar[dict[str, Any]] = {}
+
+    @abc.abstractmethod
+    def get_preset(self) -> Preset:
+        """Get the preset configuration."""
+
+
+class ApiPreset(PresetDefinition):
+    """The single application preset: REST API with the web framework."""
+
+    name = "api"
+    description = "REST API with the web framework"
+    packages = packages_for("web")
+    config = {
+        "web": {"host": "0.0.0.0", "port": 8000},  # noqa: S104 — preset template default
+    }
+
+    def get_preset(self) -> Preset:
+        return Preset(
+            name=self.name,
+            description=self.description,
+            packages=self.packages.copy(),
+            config=self.config.copy(),
+        )
+
+
+class PresetRegistry:
+    """Registry for application presets.
+
+    Instances are always empty — use :meth:`with_defaults` for the
+    in-package built-ins or :meth:`register` for plugin presets.
+    """
+
+    def __init__(self) -> None:
+        self._presets: dict[str, Preset] = {}
+
+    def register(self, preset_class: type[PresetDefinition]) -> None:
+        """Register a preset class."""
+        instance = preset_class()
+        preset = instance.get_preset()
+        self._presets[preset.name] = preset
+
+    def get(self, name: str) -> Preset | None:
+        """Get a preset by name."""
+        return self._presets.get(name)
+
+    def get_all(self) -> dict[str, Preset]:
+        """Get all registered presets."""
+        return self._presets.copy()
+
+    def get_choices(self) -> list[str]:
+        """Get list of available preset names."""
+        return list(self._presets.keys())
+
+    @classmethod
+    def _default_entries(cls) -> tuple[type[PresetDefinition], ...]:
+        """Return the built-in presets (a single one today)."""
+        return (ApiPreset,)
+
+    @classmethod
+    def with_defaults(cls) -> PresetRegistry:
+        """Return an instance populated with the built-in presets."""
+        registry = cls()
+        for entry in cls._default_entries():
+            registry.register(entry)
+        return registry
+
+
+__all__ = [
+    "ApiPreset",
+    "Preset",
+    "PresetDefinition",
+    "PresetRegistry",
+]

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/registry/template.py

@@ -9,7 +9,7 @@ import abc
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, ClassVar
 
-from quadkit.cli.package_names import packages_for, provider_available
+from quadkit.cli.package_names import packages_for
 
 if TYPE_CHECKING:
     from pathlib import Path
@@ -43,76 +43,12 @@ class ProjectTemplate(abc.ABC):
         return self.packages.copy()
 
 
-class MinimalTemplate(ProjectTemplate):
-    """Minimal template with just the core framework."""
+class ApiTemplate(ProjectTemplate):
+    """The single project template: REST API with the web framework."""
 
-    name = "minimal"
-    description = "Bare minimum Quadkit application"
-    packages = [
-        "quadkit",
-    ]
-
-    def get_config(self) -> TemplateConfig:
-        return TemplateConfig(
-            name=self.name,
-            description=self.description,
-            packages=self.packages,
-        )
-
-
-class WebAPITemplate(ProjectTemplate):
-    """REST API template."""
-
-    name = "web-api"
-    description = "REST API with web framework"
-    packages = packages_for("web", "sql")
-
-    def get_config(self) -> TemplateConfig:
-        return TemplateConfig(
-            name=self.name,
-            description=self.description,
-            packages=self.packages,
-        )
-
-
-class GraphQLTemplate(ProjectTemplate):
-    """GraphQL API template."""
-
-    name = "graphql"
-    description = "GraphQL API with web framework"
-    packages = packages_for("web", "sql", "graphql")
-
-    def get_config(self) -> TemplateConfig:
-        return TemplateConfig(
-            name=self.name,
-            description=self.description,
-            packages=self.packages,
-        )
-
-
-class WorkerTemplate(ProjectTemplate):
-    """Background worker template."""
-
-    name = "worker"
-    description = "Background job processor"
-    packages = packages_for("sql", "tasks", "queue")
-
-    def get_config(self) -> TemplateConfig:
-        return TemplateConfig(
-            name=self.name,
-            description=self.description,
-            packages=self.packages,
-        )
-
-
-class FullStackTemplate(ProjectTemplate):
-    """Full-stack application template."""
-
-    name = "fullstack"
-    description = "Full application: auth, cache, storage, events, tasks, HTTP, monitoring"
-    packages = packages_for(
-        "web", "sql", "auth", "cache", "storage", "events", "tasks", "http", "monitor"
-    )
+    name = "api"
+    description = "REST API with the web framework"
+    packages = packages_for("web")
 
     def get_config(self) -> TemplateConfig:
         return TemplateConfig(
@@ -151,17 +87,8 @@ class TemplateRegistry:
 
     @classmethod
     def _default_entries(cls) -> tuple[type[ProjectTemplate], ...]:
-        """Return templates supported by installed optional providers."""
-        entries: list[type[ProjectTemplate]] = [MinimalTemplate, WebAPITemplate]
-        optional = (
-            (GraphQLTemplate, ("sql", "graphql")),
-            (WorkerTemplate, ("sql", "tasks", "queue")),
-            (FullStackTemplate, ("web", "sql", "auth", "cache", "storage", "events", "tasks", "http", "monitor")),
-        )
-        for entry, features in optional:
-            if all(provider_available(feature) for feature in features):
-                entries.append(entry)
-        return tuple(entries)
+        """Return the built-in templates (a single one today)."""
+        return (ApiTemplate,)
 
     @classmethod
     def with_defaults(cls) -> TemplateRegistry:
@@ -214,13 +141,9 @@ class ProjectBuilder:
 
 
 __all__ = [
-    "FullStackTemplate",
-    "GraphQLTemplate",
-    "MinimalTemplate",
+    "ApiTemplate",
     "ProjectBuilder",
     "ProjectTemplate",
     "TemplateConfig",
     "TemplateRegistry",
-    "WebAPITemplate",
-    "WorkerTemplate",
 ]

{quadkit_cli-0.0.44 → quadkit_cli-0.0.46}/src/quadkit/cli/scaffold/__init__.py

@@ -4,9 +4,12 @@ Single source of truth for project bootstrapping — the catalogue lives in
 :mod:`quadkit.cli.scaffold.specs`, the rendered files in
 :mod:`quadkit.cli.scaffold.app_files`, :mod:`quadkit.cli.scaffold.module_files`
 and :mod:`quadkit.cli.scaffold.support_files`, and the writers in
-:mod:`quadkit.cli.scaffold.render`:
+:mod:`quadkit.cli.scaffold.render`. Project metadata is rendered by
+:func:`render_project_metadata` from an explicit :class:`ProjectMetadataContext`;
+downstream builders can use this side-effect-free API without depending on
+private template functions:
 
-- ``quadkit new project --template <name>`` (``commands/new.py``)
+- ``quadkit new project`` (``commands/new.py``)
 - ``ProjectBuilder.create_project`` (``registry/template.py``)
 - scaffold alignment tests (``tests/unit/test_scaffold_alignment.py``)
 
@@ -15,7 +18,7 @@ Every generated file targets the **real** quadkit APIs (``Application``,
 generator map** in :mod:`quadkit.cli.layout`, so a scaffolded project and
 its generators stay aligned:
 
-    quadkit new project myapp --template web-api
+    quadkit new project myapp
     cd myapp && pip install -e .
     quadkit gen controller users  # src/myapp/controllers/users_controller.py
     quadkit dev                   # WebModule auto-discovers it
@@ -36,10 +39,13 @@ and directly in pytest fixtures.
 
 from __future__ import annotations
 
+from quadkit.cli.scaffold.metadata import (
+    ProjectMetadataContext,
+    render_project_metadata,
+)
 from quadkit.cli.scaffold.render import render_module, render_project
 from quadkit.cli.scaffold.specs import (
     _TEMPLATE_SPECS,
-    TEMPLATE_ALIASES,
     TEMPLATES,
     ProjectTemplateSpec,
     component_packages,
@@ -50,9 +56,11 @@ from quadkit.cli.scaffold.specs import (
 
 __all__ = [
     "TEMPLATES",
+    "ProjectMetadataContext",
     "component_packages",
     "render_module",
     "render_project",
+    "render_project_metadata",
     "resolve_template",
     "root_output_dirs",
     "template_names",