71 lines
2.0 KiB
Python
71 lines
2.0 KiB
Python
|
"""以 livereload 提供静态资源目录：保存 HTML/JS/CSS 时浏览器自动刷新。
|
|||
|
|
|
|||
|
|
需 dev 依赖：``uv sync --group dev``（``livereload``）。
|
|||
|
|
|
|||
|
|
用法:
|
|||
|
|
uv run --group dev python scripts/dev_static_livereload.py --root web/voice-confirmation
|
|||
|
|
uv run --group dev python scripts/dev_static_livereload.py --root web/voice-confirmation -p 8080 --host 127.0.0.1
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
from __future__ import annotations
|
|||
|
|
|
|||
|
|
import argparse
|
|||
|
|
import sys
|
|||
|
|
from pathlib import Path
|
|||
|
|
|
|||
|
|
|
|||
|
|
def main() -> None:
|
|||
|
|
try:
|
|||
|
|
from livereload import Server
|
|||
|
|
except ImportError as exc: # pragma: no cover
|
|||
|
|
print(
|
|||
|
|
"需要安装 dev 依赖: uv sync --group dev （需含 livereload）",
|
|||
|
|
file=sys.stderr,
|
|||
|
|
)
|
|||
|
|
raise SystemExit(1) from exc
|
|||
|
|
|
|||
|
|
p = argparse.ArgumentParser(description="Static site + browser live reload (livereload)")
|
|||
|
|
p.add_argument(
|
|||
|
|
"--root",
|
|||
|
|
type=Path,
|
|||
|
|
required=True,
|
|||
|
|
help="要托管的目录（如 web/voice-confirmation）",
|
|||
|
|
)
|
|||
|
|
p.add_argument("--host", default="127.0.0.1")
|
|||
|
|
p.add_argument("-p", "--port", type=int, default=8080)
|
|||
|
|
p.add_argument(
|
|||
|
|
"--extra-watch",
|
|||
|
|
type=Path,
|
|||
|
|
action="append",
|
|||
|
|
default=[],
|
|||
|
|
help="额外监视路径（可重复），变更时触发自动刷新",
|
|||
|
|
)
|
|||
|
|
args = p.parse_args()
|
|||
|
|
root: Path = args.root.resolve()
|
|||
|
|
if not root.is_dir():
|
|||
|
|
print(f"不是目录: {root}", file=sys.stderr)
|
|||
|
|
raise SystemExit(2)
|
|||
|
|
|
|||
|
|
server = Server()
|
|||
|
|
server.watch(str(root))
|
|||
|
|
for w in args.extra_watch:
|
|||
|
|
wp = w.resolve()
|
|||
|
|
if wp.exists():
|
|||
|
|
server.watch(str(wp if wp.is_file() else wp))
|
|||
|
|
|
|||
|
|
url = f"http://{args.host}:{args.port}/"
|
|||
|
|
print(f"Livereload 静态根目录: {root}")
|
|||
|
|
print(f"访问: {url} （编辑目录内文件后应自动刷新浏览器；首次请手动打开）")
|
|||
|
|
print("按 Ctrl+C 停止。")
|
|||
|
|
server.serve(
|
|||
|
|
host=args.host,
|
|||
|
|
port=args.port,
|
|||
|
|
root=str(root),
|
|||
|
|
open_url=False,
|
|||
|
|
debug=False,
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
if __name__ == "__main__":
|
|||
|
|
main()
|