httk.serve.web.engine.discovery¶

Resolve site routes to static files and renderable content sources.

Attributes¶

`normalize_route`(route)	Normalize a site route for lookup.
`resolve_route`(config, route)	Resolve a route against the configured static and content directories.

httk.serve.web.engine.discovery.DEFAULT_CONTENT_EXTENSIONS: tuple[str, Ellipsis] = ('.md', '.rst', '.html', '.httkweb')[source]¶

httk.serve.web.engine.discovery.normalize_route(route)[source]¶

Normalize a site route for lookup.

Parameters:: route (str) – Route text supplied by a caller or request.
Returns:: Route without a leading slash, using index for the root.
Return type:: str

httk.serve.web.engine.discovery.resolve_route(config, route)[source]¶

Resolve a route against the configured static and content directories.

Parameters:

config (httk.serve.web.model.config.SiteConfig) – Site directory configuration.
route (str) – Route to resolve.

Returns:

The matching static, content, or missing route description.

Return type:

httk.serve.web.model.page.ResolvedRoute