htmlforge 0.0.1__py3-none-any.whl

htmlforge/__init__.py

@@ -0,0 +1,27 @@
+"""htmlforge — Build web pages with Python, export to HTML."""
+
+__version__ = "0.0.1"
+
+from htmlforge.simple import Doc
+
+from htmlforge.core import (
+    # Base
+    Element, Page,
+    # Structural
+    Div, Section, Header, Footer, Nav, Main, Article, Aside, Span, Container,
+    # Text
+    H1, H2, H3, H4, H5, H6, P, Strong, Em, Blockquote,
+    Code, Pre, Small, Mark, Sub, Sup,
+    Text, Link,
+    # Lists
+    Ul, Ol, Li, List,
+    # Media
+    Img, Video, Audio, Source, Iframe, Canvas,
+    # Table
+    Table, Thead, Tbody, Tr, Th, Td, Caption,
+    # Forms
+    Form, Input, Textarea, Select, Option,
+    Checkbox, Radio, Label, Button,
+    # Misc
+    Hr, Br, Meta, Progress, Details, Summary,
+)

htmlforge/__main__.py

@@ -0,0 +1,5 @@
+"""Allow ``python -m htmlforge`` to invoke the CLI."""
+
+from htmlforge.cli import render
+
+render()

htmlforge/cli.py

@@ -0,0 +1,194 @@
+"""htmlforge CLI — build HTML from Python page scripts.
+
+Commands:
+    htmlforge render <file.py> [page]  -o <dir>    Render pages to HTML
+    htmlforge render <file.py>         -p <port>   Render and serve locally
+    htmlforge render <file.py>         -w          Watch and auto-rebuild
+
+Workflow is modelled after *manim*:
+    manim scene.py MyScene -qh  →  mp4
+    htmlforge  page.py  MyPage  -o dist  →  html
+"""
+
+from __future__ import annotations
+
+import argparse
+import http.server
+import importlib.util
+import os
+import re
+import socketserver
+import sys
+import time
+from pathlib import Path
+
+from htmlforge.core import Page
+from htmlforge.simple import Doc
+
+
+# ============================================================
+# Entry point
+# ============================================================
+
+def render():
+    """``[project.scripts]`` entry — installed as the ``htmlforge`` command."""
+    ap = argparse.ArgumentParser(
+        prog="htmlforge",
+        description="htmlforge — Build web pages with Python",
+    )
+    ap.add_argument(
+        "command", nargs="?", default="render",
+        help="Command: render (default)",
+    )
+    ap.add_argument("file", help="Python file containing Page objects")
+    ap.add_argument(
+        "page", nargs="?", default=None,
+        help="Specific page variable or class name to render",
+    )
+    ap.add_argument("-o", "--output", default="dist", help="Output directory (default: dist)")
+    ap.add_argument("-p", "--port", type=int, default=8080, help="Server port (default: 8080)")
+    ap.add_argument("-w", "--watch", action="store_true", help="Watch file for changes")
+    ap.add_argument("-s", "--serve", action="store_true", help="Start HTTP server after build")
+    ap.add_argument("-v", "--verbose", action="store_true", help="Verbose output")
+
+    args = ap.parse_args()
+
+    if args.command == "render":
+        _do_render(args)
+    else:
+        ap.print_help()
+
+
+# ============================================================
+# Render
+# ============================================================
+
+def _do_render(args):
+    filepath = Path(args.file).resolve()
+    if not filepath.exists():
+        _err(f"File not found: {filepath}")
+        sys.exit(1)
+
+    # Initial build
+    ok = _build(filepath, args.page, args.output, args.verbose)
+    if not ok:
+        sys.exit(1)
+
+    if args.serve:
+        out_dir = filepath.parent / args.output
+        _serve_dir(str(out_dir), args.port)
+    elif args.watch:
+        _watch_loop(filepath, args.page, args.output, args.verbose)
+
+
+def _build(filepath: Path, page_name: str | None,
+           output: str, verbose: bool) -> bool:
+    try:
+        mod = _load_module(filepath)
+    except Exception as exc:
+        _err(f"Error loading {filepath.name}: {exc}")
+        return False
+
+    pages = _discover_pages(mod)
+
+    if page_name:
+        key = page_name.lower()
+        pages = {k: v for k, v in pages.items() if k == key}
+        if not pages:
+            _err(
+                f"Page '{page_name}' not found. "
+                f"Available: {', '.join(_discover_pages(mod))}"
+            )
+            return False
+
+    if not pages:
+        _err("No Page objects found in the file.")
+        return False
+
+    out_dir = filepath.parent / output
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    for name, page in pages.items():
+        html = page.render()
+        fname = "index.html" if len(pages) == 1 else f"{_slug(name)}.html"
+        (out_dir / fname).write_text(html, encoding="utf-8")
+        _ok(f"  {fname}")
+
+    _info(f"Done. {len(pages)} page(s) → {out_dir}/")
+    return True
+
+
+# ============================================================
+# Serve
+# ============================================================
+
+def _serve_dir(directory: str, port: int):
+    os.chdir(directory)
+    Handler = http.server.SimpleHTTPRequestHandler
+    with socketserver.TCPServer(("", port), Handler) as httpd:
+        _info(f"  Serving at http://localhost:{port}")
+        _info("  Press Ctrl+C to stop.")
+        try:
+            httpd.serve_forever()
+        except KeyboardInterrupt:
+            _info("\n  Server stopped.")
+
+
+# ============================================================
+# Watch
+# ============================================================
+
+def _watch_loop(filepath: Path, page_name: str | None,
+                output: str, verbose: bool):
+    _info("  Watching for changes… (Ctrl+C to stop)")
+    last = filepath.stat().st_mtime
+    try:
+        while True:
+            time.sleep(1)
+            try:
+                cur = filepath.stat().st_mtime
+            except FileNotFoundError:
+                continue
+            if cur != last:
+                last = cur
+                _info(f"  Change detected — {time.strftime('%H:%M:%S')}")
+                _build(filepath, page_name, output, verbose)
+    except KeyboardInterrupt:
+        _info("\n  Watch stopped.")
+
+
+# ============================================================
+# Helpers
+# ============================================================
+
+def _ok(msg: str):
+    print(f"\033[32m{msg}\033[0m")
+
+def _info(msg: str):
+    print(f"\033[36m{msg}\033[0m")
+
+def _err(msg: str):
+    print(f"\033[31mError: {msg}\033[0m", file=sys.stderr)
+
+
+def _load_module(filepath: Path):
+    """Dynamically import a Python file as a module."""
+    spec = importlib.util.spec_from_file_location("_htmlforge_user", str(filepath))
+    if spec is None or spec.loader is None:
+        raise ImportError(f"Cannot load {filepath}")
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+def _discover_pages(mod) -> dict:
+    """Find all ``Page`` and ``Doc`` instances at module level."""
+    return {
+        name: obj
+        for name, obj in vars(mod).items()
+        if isinstance(obj, (Page, Doc)) and not name.startswith("_")
+    }
+
+
+def _slug(name: str) -> str:
+    return re.sub(r"[^a-z0-9]+", "-", name.lower()).strip("-")