scaffold-ca-python 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

scaffold_ca_python/factory/entry_points/ep_mcp.py

@@ -29,7 +29,9 @@ class EntryPointMcp(EntryPointFactory):
         Always queues:
         - src/infrastructure/entry_points/mcp_server/__init__.py
         - src/infrastructure/entry_points/mcp_server/tools.py
+        - src/infrastructure/entry_points/mcp_server/routes.py
         - tests/infrastructure/entry_points/mcp_server/test_tools.py
+        - tests/infrastructure/entry_points/mcp_server/test_routes.py
 
         Conditionally queues (when builder params are True):
         - resources.py + test_resources.py  (with_resources=True)
@@ -66,12 +68,23 @@ class EntryPointMcp(EntryPointFactory):
             builder.render(f"{base}/tools.py.jinja2", ctx_dict),
             template_name=f"{base}/tools.py.jinja2",
         )
+        builder.add_file(
+            src_dir / "routes.py",
+            builder.render(f"{base}/routes.py.jinja2", ctx_dict),
+            template_name=f"{base}/routes.py.jinja2",
+        )
         builder.add_file(
             test_dir / "test_tools.py",
             builder.render(f"{base}/test_tools.py.jinja2", ctx_dict),
             template_name=f"{base}/test_tools.py.jinja2",
             is_test=True,
         )
+        builder.add_file(
+            test_dir / "test_routes.py",
+            builder.render(f"{base}/test_routes.py.jinja2", ctx_dict),
+            template_name=f"{base}/test_routes.py.jinja2",
+            is_test=True,
+        )
 
         # Optional: resources
         if with_resources:

scaffold_ca_python/templates/entry_point/mcp/app.py.jinja2

@@ -9,7 +9,7 @@ from starlette.applications import Starlette
 from starlette.routing import Mount
 
 from {{ project.python_package }}.application.config.container import Container
-from {{ project.python_package }}.infrastructure.entry_points.mcp_server import tools
+from {{ project.python_package }}.infrastructure.entry_points.mcp_server import routes, tools
 {%- if with_resources %}
 from {{ project.python_package }}.infrastructure.entry_points.mcp_server import resources
 {%- endif %}
@@ -18,6 +18,7 @@ from {{ project.python_package }}.infrastructure.entry_points.mcp_server import
 {%- endif %}
 
 mcp: FastMCP = FastMCP("{{ project.name }}", stateless_http=True)
+routes.bind_routes(mcp)
 
 
 @asynccontextmanager

scaffold_ca_python/templates/entry_point/mcp/routes.py.jinja2

@@ -0,0 +1,25 @@
+"""MCP custom routes binding — register non-MCP HTTP routes such as the health check."""
+
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+from starlette.requests import Request
+from starlette.responses import JSONResponse, Response
+
+
+def bind_routes(mcp: FastMCP) -> None:
+    """
+    Bind routes to the FastMCP instance.
+    """
+
+    @mcp.custom_route(name="health_check", path="/api/v1/health", methods=["GET"])
+    async def health_check(_request: Request) -> Response:
+        """
+        Health check endpoint to verify the server is running.
+
+        Returns:
+            JSON response indicating the server is healthy.
+        """
+
+        response_data = {"status": "ok"}
+        return JSONResponse(response_data)

scaffold_ca_python/templates/entry_point/mcp/test_app.py.jinja2

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from mcp.server.fastmcp import FastMCP
 from starlette.applications import Starlette
+from starlette.testclient import TestClient
 
 from {{ project.python_package }}.application import app as app_module
 
@@ -28,3 +29,19 @@ def test_start_server_has_routes() -> None:
 def test_lifespan_is_callable() -> None:
     """lifespan must be a callable (async context manager factory)."""
     assert callable(app_module.lifespan)
+
+
+def test_health_route_registered_once() -> None:
+    """Repeated start_server() calls must not duplicate the health route."""
+    app_module.start_server()
+    server = app_module.start_server()
+    health = [r for r in server.routes[0].routes if getattr(r, "path", None) == "/api/v1/health"]
+    assert len(health) == 1
+
+
+def test_health_route_reachable_through_start_server() -> None:
+    """The health route is not shadowed by the Mount('/')."""
+    client = TestClient(app_module.start_server())
+    response = client.get("/api/v1/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}

scaffold_ca_python/templates/entry_point/mcp/test_routes.py.jinja2

@@ -0,0 +1,25 @@
+"""Tests for {{ project.python_package }}.infrastructure.entry_points.mcp_server.routes."""
+
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+from starlette.testclient import TestClient
+
+from {{ project.python_package }}.infrastructure.entry_points.mcp_server.routes import bind_routes
+
+
+def _client() -> TestClient:
+    mcp = FastMCP("test")
+    bind_routes(mcp)
+    return TestClient(mcp.streamable_http_app())
+
+
+def test_health_check_returns_ok() -> None:
+    response = _client().get("/api/v1/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}
+
+
+def test_health_check_rejects_post() -> None:
+    response = _client().post("/api/v1/health")
+    assert response.status_code == 405

{scaffold_ca_python-0.4.0.dist-info → scaffold_ca_python-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scaffold-ca-python
-Version: 0.4.0
+Version: 0.5.0
 Summary: Scaffolder to generate Clean Architecture apps
 Project-URL: Homepage, https://github.com/bancolombia/scaffold-clean-architecture-py
 Project-URL: Repository, https://github.com/bancolombia/scaffold-clean-architecture-py

{scaffold_ca_python-0.4.0.dist-info → scaffold_ca_python-0.5.0.dist-info}/RECORD

@@ -35,7 +35,7 @@ scaffold_ca_python/factory/entry_points/__init__.py,sha256=ylyCH8R8iORQjHkx-bzy4
 scaffold_ca_python/factory/entry_points/base.py,sha256=DOhL2jniv-LdiNIgFINgXX-i6krRO2EAvJAi7L_ZisA,1892
 scaffold_ca_python/factory/entry_points/ep_agent.py,sha256=ODql04XDXya3ANYez38M3AYoUeRh9OmW7nxGmWHRgIY,3410
 scaffold_ca_python/factory/entry_points/ep_generic.py,sha256=L51mO007f6LtgBzOAmBlW4dClLK9IzQf3rJjNUbd9xk,2823
-scaffold_ca_python/factory/entry_points/ep_mcp.py,sha256=6kS-E0NiyHwAfXbl-bB18YcCj2_nZ1mMp1qZaCQo59E,5687
+scaffold_ca_python/factory/entry_points/ep_mcp.py,sha256=TVJrEFRrviB5tw6RbVtOIbzzgr-hmN0s1XQs5qIJguA,6244
 scaffold_ca_python/factory/entry_points/ep_restapi.py,sha256=PFkt9TH1aN6YO8w4zAeoqFOuibC8oc7qJUbFfX9YI_U,5951
 scaffold_ca_python/factory/pipelines/__init__.py,sha256=0YPpPGsZ6A3-udHTSZDyUHleLFLQQh1V5IL6AB0qJ6g,557
 scaffold_ca_python/factory/pipelines/pipeline_factory.py,sha256=s4fpuyhdxXiwko-LlM6Pv-QJdRGQJb17KVrC-DW6ojo,842
@@ -70,13 +70,15 @@ scaffold_ca_python/templates/entry_point/generic/entrypoint_main.py.jinja2,sha25
 scaffold_ca_python/templates/entry_point/generic/handler.py.jinja2,sha256=glCst1soTiKG_gDdq5C-OogzljOJ_QooaW_boYt7gsg,417
 scaffold_ca_python/templates/entry_point/generic/test_handler.py.jinja2,sha256=gRhvVabkylQ8z06JZ9L2CHdTa83oxL1X4ldR3_DZQWg,1195
 scaffold_ca_python/templates/entry_point/mcp/__init__.py.jinja2,sha256=8J_YmIXHUh26PkaxeM8z5lf-dtK0da1T4haOM8U6Y9A,38
-scaffold_ca_python/templates/entry_point/mcp/app.py.jinja2,sha256=VMU2AWXAVJVT0IqTI3E6XGBGn2rR80ViSN0jNyRf3E4,1916
+scaffold_ca_python/templates/entry_point/mcp/app.py.jinja2,sha256=2Kfi3AjRvJi7ee1vO0PyUa4pfX8j1GcsHO89GmQy6JU,1948
 scaffold_ca_python/templates/entry_point/mcp/prompts.py.jinja2,sha256=PUFRtuWlEzR7bg7zY0O8dx-5tNrEZXrNZ5XgBoUMulQ,765
 scaffold_ca_python/templates/entry_point/mcp/resources.py.jinja2,sha256=ZV_2WwklhSGhVFel3stS00zmPJuTlznfvFrpiM9dDKo,840
+scaffold_ca_python/templates/entry_point/mcp/routes.py.jinja2,sha256=_JRXwnCMSJ-YBhEsxs-2JuVVQQ5sLeDDnkGB_8E4UJs,752
 scaffold_ca_python/templates/entry_point/mcp/server.py.jinja2,sha256=gVzJm_ugY9E7-1RYIfbEKduDR71gluq4l3OB_aTRr1w,656
-scaffold_ca_python/templates/entry_point/mcp/test_app.py.jinja2,sha256=MjVDhAXTz35HcCOVTsaWA--qvD_Qyn2SNG99CF6wctk,967
+scaffold_ca_python/templates/entry_point/mcp/test_app.py.jinja2,sha256=mvP2BXW_OK4HvPjl1dfHs-y7r9FIYViJ3BCBtAqX8iY,1643
 scaffold_ca_python/templates/entry_point/mcp/test_prompts.py.jinja2,sha256=Y9C7z7jpjoTKANlFB6hNJUUw2abt5qF2C4Nm7MkvDvA,1566
 scaffold_ca_python/templates/entry_point/mcp/test_resources.py.jinja2,sha256=2jHfPqyJ4TJZJupxe8T7gVz2ysaqZHcAog6186ie2CI,1763
+scaffold_ca_python/templates/entry_point/mcp/test_routes.py.jinja2,sha256=aYVWQXiRguziMtOnvZc5uwnhgYhsH87yrIDPM4gz95g,753
 scaffold_ca_python/templates/entry_point/mcp/test_tool_stub.py.jinja2,sha256=Tq4uDcZc77bCC9gCVidmM5HmtjPfACaHBoQW0qEhIWo,295
 scaffold_ca_python/templates/entry_point/mcp/test_tools.py.jinja2,sha256=bd_8nvLuqPApKIYQoBhEokMYZrPYFUn1pnDEIOVxwCo,1550
 scaffold_ca_python/templates/entry_point/mcp/tool_stub.py.jinja2,sha256=VaGWAUF-BFQ7EeOHXUHQ2H-Mzr1UfbfziDsS7EVWUCc,289
@@ -121,8 +123,8 @@ scaffold_ca_python/templates/project/application/config/resource_container.py.ji
 scaffold_ca_python/templates/project/application/config/usecases_container.py.jinja2,sha256=3fEHe6mkXkDHlfO5nhLqzLB7ccTpqwtjHZfLyfysbro,527
 scaffold_ca_python/templates/use_case/test_use_case.py.jinja2,sha256=spomnRHeXWiWjy3QHQt839yIMFDUqA7h-Wq4KfZxAyg,372
 scaffold_ca_python/templates/use_case/use_case.py.jinja2,sha256=KPtaK1wvZ-7qHdDZyuVfqXTPYwJdNUMPXQZGuKZFA7Y,217
-scaffold_ca_python-0.4.0.dist-info/METADATA,sha256=7LQgO7e31QQ8vmmP1PfqwXgaWnQRrLIIpengbcw8mf4,7475
-scaffold_ca_python-0.4.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-scaffold_ca_python-0.4.0.dist-info/entry_points.txt,sha256=4PyYg6mNCvAlt2yF_o1-QR2CBXiowYGpNyqcP88tu6I,104
-scaffold_ca_python-0.4.0.dist-info/licenses/LICENSE,sha256=3ZZEP7DK_h3lEjS8r-DvQCec2q7zAqqq7HmSq6cuL0E,1068
-scaffold_ca_python-0.4.0.dist-info/RECORD,,
+scaffold_ca_python-0.5.0.dist-info/METADATA,sha256=LzgbMKXGUltT5VqAjcy4iM1WLe3EzI65blOTxX8N6Cw,7475
+scaffold_ca_python-0.5.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+scaffold_ca_python-0.5.0.dist-info/entry_points.txt,sha256=4PyYg6mNCvAlt2yF_o1-QR2CBXiowYGpNyqcP88tu6I,104
+scaffold_ca_python-0.5.0.dist-info/licenses/LICENSE,sha256=3ZZEP7DK_h3lEjS8r-DvQCec2q7zAqqq7HmSq6cuL0E,1068
+scaffold_ca_python-0.5.0.dist-info/RECORD,,