stkit 17.0.1__tar.gz → 17.0.2__tar.gz

{stkit-17.0.1 → stkit-17.0.2}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## v17.0.2 (2026-10-25)
+
+No migration required.
+
+- `stk verify` follows redirects from `/` and checks that the page it lands on answers 200, so an app whose `/` sends people to sign-in or to its own home passes. A redirect to a broken page still fails.
+- Replacing stk's landing view is documented: `app.view_functions["public.index"] = home` in an extension's `init_app` (Architecture, Public).
+- `STK_CLI_SECTIONS` groups an app's own commands in `stk --help`, after stk's sections, instead of listing them all under Other.
+
 ## v17.0.1 (2026-10-25)
 
 No migration required.

{stkit-17.0.1 → stkit-17.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stkit
-Version: 17.0.1
+Version: 17.0.2
 Summary: An async Quart framework optimized for AI-assisted development workflows
 Author-email: Level09 <hello@level09.com>
 License: MIT

{stkit-17.0.1 → stkit-17.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stkit"
-version = "17.0.1"
+version = "17.0.2"
 description = "An async Quart framework optimized for AI-assisted development workflows"
 authors = [
     {name = "Level09", email = "hello@level09.com"}

{stkit-17.0.1 → stkit-17.0.2}/stk/__init__.py

@@ -3,7 +3,7 @@ stk Framework
 A modern Python web framework optimized for AI-assisted development.
 """
 
-__version__ = "17.0.1"
+__version__ = "17.0.2"
 
 
 def __getattr__(name):

{stkit-17.0.1 → stkit-17.0.2}/stk/checks.py

@@ -286,10 +286,11 @@ def check_admin_reset_route(app):
     )
 
 
-@check("GET / returns 200")
+@check("GET / answers 200, after any redirects")
 async def check_http_index(app):
+    # An app may send / to its sign-in or home page; what it lands on must work.
     client = app.test_client()
-    response = await client.get("/")
+    response = await client.get("/", follow_redirects=True)
     assert response.status_code == 200, f"Expected 200, got {response.status_code}"
 
 

{stkit-17.0.1 → stkit-17.0.2}/stk/cli/main.py

@@ -10,7 +10,7 @@ import inspect
 from importlib.metadata import version
 
 import click
-from quart.cli import QuartGroup
+from quart.cli import NoAppException, QuartGroup, ScriptInfo
 
 import stk.cli as cli
 from stk.cli.base import load_app
@@ -44,7 +44,7 @@ class StkGroup(QuartGroup):
             if command is not None and not command.hidden:
                 commands[name] = command
 
-        for title, names in SECTIONS:
+        for title, names in [*SECTIONS, *_app_sections(ctx)]:
             rows = [
                 (name, commands.pop(name).get_short_help_str(limit=60))
                 for name in names
@@ -64,6 +64,17 @@ class StkGroup(QuartGroup):
                 )
 
 
+def _app_sections(ctx):
+    """The app's own help sections, `STK_CLI_SECTIONS`; none outside an app."""
+    try:
+        app = ctx.ensure_object(ScriptInfo).load_app()
+    except NoAppException:
+        return []
+    return [
+        (title, list(names)) for title, names in app.config.get("STK_CLI_SECTIONS", ())
+    ]
+
+
 def _create_app(**_kwargs):
     return load_app()
 

stkit-17.0.2/tests/test_app_index.py

@@ -0,0 +1,43 @@
+"""An app may replace stk's landing page, and verify judges where / lands."""
+
+import unittest
+from types import SimpleNamespace
+
+from quart import redirect
+
+from stk.app import Stk
+from stk.checks import check_http_index
+from stk.cli.main import _app_sections
+from stk.settings import TestingConfig
+
+
+class AppIndexTest(unittest.IsolatedAsyncioTestCase):
+    async def test_index_can_be_replaced_and_a_redirect_passes_the_check(self):
+        app = Stk(__name__, config=TestingConfig)
+
+        async def home():
+            return redirect("/login")
+
+        app.view_functions["public.index"] = home
+        response = await app.test_client().get("/")
+        self.assertEqual(response.status_code, 302)
+        self.assertTrue(await check_http_index(app))
+
+    async def test_a_redirect_to_a_broken_page_fails_the_check(self):
+        app = Stk(__name__, config=TestingConfig)
+
+        async def home():
+            return redirect("/nowhere")
+
+        app.view_functions["public.index"] = home
+        self.assertFalse(await check_http_index(app))
+
+
+class AppHelpSectionsTest(unittest.TestCase):
+    def test_app_sections_come_from_config(self):
+        app = Stk(__name__, config=TestingConfig)
+        app.config["STK_CLI_SECTIONS"] = [("Runs", ("worker", "enrich"))]
+        ctx = SimpleNamespace(
+            ensure_object=lambda _: SimpleNamespace(load_app=lambda: app)
+        )
+        self.assertEqual(_app_sections(ctx), [("Runs", ["worker", "enrich"])])