90 lines
3.0 KiB
Python
90 lines
3.0 KiB
Python
import unittest
|
|
|
|
from plba.http.routes import (
|
|
HttpRoute,
|
|
HttpRouter,
|
|
MethodNotAllowed,
|
|
RouteNotFound,
|
|
)
|
|
|
|
|
|
async def unused_handler(scope, receive, send) -> None:
|
|
return None
|
|
|
|
|
|
class HttpRouteDefinitionTests(unittest.TestCase):
|
|
def test_requires_versioned_path_with_endpoint_segment(self) -> None:
|
|
for path in (
|
|
"/health",
|
|
"/api/v0/health",
|
|
"/api/v1",
|
|
"/api/v1//health",
|
|
"/api/v1/health/",
|
|
"/api/v1/{bad-name}",
|
|
"/api/v1/{item_id}/{item_id}",
|
|
):
|
|
with self.subTest(path=path), self.assertRaises(ValueError):
|
|
HttpRoute("GET", path, unused_handler)
|
|
|
|
def test_requires_uppercase_http_method_and_callable_handler(self) -> None:
|
|
with self.assertRaises(ValueError):
|
|
HttpRoute("get", "/api/v1/items", unused_handler)
|
|
with self.assertRaises(ValueError):
|
|
HttpRoute("GET", "/api/v1/items", None) # type: ignore[arg-type]
|
|
|
|
|
|
class HttpRouterTests(unittest.TestCase):
|
|
def test_resolves_named_parameters(self) -> None:
|
|
route = HttpRoute("GET", "/api/v1/items/{item_id}", unused_handler)
|
|
|
|
match = HttpRouter((route,)).resolve("GET", "/api/v1/items/sku-42")
|
|
|
|
self.assertIs(match.route, route)
|
|
self.assertEqual(match.path_params, {"item_id": "sku-42"})
|
|
|
|
def test_static_path_has_priority_over_parameter_path(self) -> None:
|
|
parameter_route = HttpRoute(
|
|
"GET", "/api/v1/items/{item_id}", unused_handler
|
|
)
|
|
static_route = HttpRoute("GET", "/api/v1/items/by-id", unused_handler)
|
|
router = HttpRouter((parameter_route, static_route))
|
|
|
|
match = router.resolve("GET", "/api/v1/items/by-id")
|
|
|
|
self.assertIs(match.route, static_route)
|
|
self.assertEqual(match.path_params, {})
|
|
|
|
def test_rejects_duplicate_and_ambiguous_routes(self) -> None:
|
|
routes = (
|
|
("/api/v1/items/{item_id}", "/api/v1/items/{item_id}"),
|
|
("/api/v1/{kind}/items", "/api/v1/items/{name}"),
|
|
)
|
|
for first_path, second_path in routes:
|
|
with self.subTest(paths=(first_path, second_path)):
|
|
first = HttpRoute("GET", first_path, unused_handler)
|
|
second = HttpRoute("GET", second_path, unused_handler)
|
|
with self.assertRaises(ValueError):
|
|
HttpRouter((first, second))
|
|
|
|
def test_known_path_with_wrong_method_reports_allowed_methods(self) -> None:
|
|
router = HttpRouter(
|
|
(HttpRoute("GET", "/api/v1/items", unused_handler),)
|
|
)
|
|
|
|
with self.assertRaises(MethodNotAllowed) as caught:
|
|
router.resolve("POST", "/api/v1/items")
|
|
|
|
self.assertEqual(caught.exception.allowed_methods, ("GET",))
|
|
|
|
def test_unknown_path_is_not_found(self) -> None:
|
|
router = HttpRouter(
|
|
(HttpRoute("GET", "/api/v1/items", unused_handler),)
|
|
)
|
|
|
|
with self.assertRaises(RouteNotFound):
|
|
router.resolve("GET", "/api/v1/unknown")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|