daodejing-runze 1.0.0__py3-none-any.whl

daodejing_runze/__init__.py

@@ -0,0 +1,44 @@
+"""道可道 · 润泽解读道德经 —— 八十一章结构化数据。
+
+    >>> import daodejing_runze as dj
+    >>> dj.chapter(1)["title"]
+    '道可道，非常道'
+    >>> [c["volume"] for c in dj.chapters()][:5]
+    ['根', '根', '根', '根', '根']
+
+作者：润泽博士（#润泽博士）。许可：CC BY-NC-SA 4.0。
+"""
+import json
+import os
+
+__version__ = "1.0.0"
+_DATA = os.path.join(os.path.dirname(__file__), "data", "daodejing-81.jsonl")
+_cache = None
+
+
+def chapters():
+    """返回全部 81 章（list[dict]）。字段：id/no/title/volume/scripture/notes/text。"""
+    global _cache
+    if _cache is None:
+        with open(_DATA, encoding="utf-8") as f:
+            _cache = [json.loads(line) for line in f if line.strip()]
+    return _cache
+
+
+def chapter(n):
+    """取第 n 章（1–81）。"""
+    if not 1 <= n <= 81:
+        raise ValueError("chapter number must be 1..81")
+    return chapters()[n - 1]
+
+
+def scripture(n):
+    """取第 n 章经文（纯文本）。"""
+    return chapter(n)["scripture"]
+
+
+def by_volume(name):
+    """按卷取章：根 / 动 / 生 / 落 / 还。"""
+    if name not in ("根", "动", "生", "落", "还"):
+        raise ValueError("volume must be one of 根 动 生 落 还")
+    return [c for c in chapters() if c["volume"] == name]