Important
This plugin currently contains minimal features and is a work-in-progress
Automatic browser reload plugin for Litestar, designed for development use.
pip install litestar-browser-reloadParameters of BrowserReloadPlugin:
watch_paths: Sequence[Union[str, Path]]: Paths to watch for changes.ignore_dirs: Sequence[str]| None: Directory names to ignore. (example)ignore_entity_patterns: Sequence[str]| None: File/Directory name patterns to ignore (example).
from pathlib import Path
from litestar import Litestar
from litestar.contrib.jinja import JinjaTemplateEngine
from litestar.template.config import TemplateConfig
from litestar.response import Template
from litestar_browser_reload import BrowserReloadPlugin
templates_path = Path("templates")
browser_reload = BrowserReloadPlugin(watch_paths=(templates_path,))
app = Litestar(
route_handlers=[],
debug=True,
plugins=[browser_reload],
template_config=TemplateConfig(
directory=templates_path,
engine=JinjaTemplateEngine,
),
)Add the following to your base template:
<head>
...
{% if request.app.debug %}
<script
src="/__reload__/static/reload-listener.js"
data-worker-script-path="/__reload__/static/reload-worker.js"
data-ws-path="/__reload__"
defer
></script>
{% endif %}
</head>litestar-browser-reload is distributed under the terms of the MIT license.
Much of this was copied from django-browser-reload and foxglove