memoryfield-tool 0.0.1__py3-none-any.whl

memoryfield_tool/__init__.py

@@ -0,0 +1,6 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("memoryfield-tool")
+except PackageNotFoundError:  # pragma: no cover - not installed
+    __version__ = "0.0.0.dev0+unknown"

memoryfield_tool/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

memoryfield_tool/assets.py

@@ -0,0 +1,16 @@
+from pathlib import Path
+
+PICO_CDN_URL = "https://cdn.jsdelivr.net/npm/@picocss/pico@2.0.6/css/pico.min.css"
+_PICO_LOCAL = Path(__file__).parent / "static" / "pico.min.css"
+
+
+def has_bundled_pico() -> bool:
+    """True when the build hook produced the bundled pico.min.css (absent in dev)."""
+    return _PICO_LOCAL.is_file()
+
+
+def pico_css_href() -> str:
+    """The stylesheet URL: bundled asset when present, else the pinned CDN fallback."""
+    if has_bundled_pico():
+        return "/static/pico.min.css"
+    return PICO_CDN_URL

memoryfield_tool/catalog.py

@@ -0,0 +1,53 @@
+from . import frontmatter, pages
+from .transport import Transport
+
+
+def catalog_field(t: Transport, *, field_name: str | None = None) -> list[dict[str, object]]:
+    """Return per-page dicts for a field, in filename order (unsorted)."""
+    rows: list[dict[str, object]] = []
+    for key in pages.collect_pages(t):
+        text = t.read_object(key).decode("utf-8")
+        fm, _has = frontmatter.parse_frontmatter(text)
+        fm_dict = fm if fm is not None else {}
+        row: dict[str, object] = {
+            "filename": key,
+            "title": str(fm_dict.get("title", "")),
+            "summary": str(fm_dict.get("summary", "")),
+            "created": fm_dict.get("created", ""),
+            "updated": fm_dict.get("updated", ""),
+        }
+        if field_name is not None:
+            row["field"] = field_name
+        rows.append(row)
+    return rows
+
+
+def catalog_sort(rows: list[dict[str, object]], sort: str) -> list[dict[str, object]]:
+    """Return rows sorted per the awiki catalog sort rules."""
+    rows = list(rows)
+    if sort == "path":
+        rows.sort(key=lambda r: str(r["filename"]))
+    elif sort == "title":
+        rows.sort(key=lambda r: str(r["title"]).lower())
+    elif sort == "created":
+        rows.sort(key=lambda r: str(r["created"]), reverse=True)
+    elif sort == "updated":
+        rows.sort(key=lambda r: str(r["updated"]), reverse=True)
+    return rows
+
+
+def catalog_markdown(rows: list[dict[str, object]], *, show_field: bool = False) -> str:
+    """Render rows as a markdown table, optionally with a leading Field column."""
+    if show_field:
+        out = ["| Field | Page | Summary |", "|-------|------|---------|"]
+    else:
+        out = ["| Page | Summary |", "|------|---------|"]
+    for r in rows:
+        summary = str(r["summary"] or "—")
+        if len(summary) > 160:
+            summary = summary[:157] + "..."
+        if show_field:
+            out.append(f"| {r['field']} | {r['filename']} | {summary} |")
+        else:
+            out.append(f"| {r['filename']} | {summary} |")
+    return "\n".join(out)