divicast 0.1.1__tar.gz

divicast-0.1.1/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

divicast-0.1.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.3
+Name: divicast
+Version: 0.1.1
+Summary: This is a metaphysical chart library, including six line
+Author: Wáng Sōng
+Author-email: Wáng Sōng <wangsquirrel@gmail.com>
+License: MIT License
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Requires-Dist: pydantic>=2.11.9
+Requires-Dist: rich==14.0.0
+Requires-Dist: tyme4py>=1.3.4
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/wangsquirrel/divicast
+Description-Content-Type: text/markdown
+
+# 玄学排盘库
+
+本库用于六爻排盘（六爻预测），提供了基础的六爻相关实体、符号、五行、天干地支等数据结构和推演逻辑，适合用于命理、易学、占卜等相关应用的开发。致力于面向未来，面向AI
+
+## 功能简介
+
+- 支持六爻排盘的基本流程
+- 内置天干、地支、五行、六神、卦象等基础数据
+- 提供六爻相关实体和符号的操作
+- 易于扩展和集成到其他 Python 项目
+
+## 安装
+
+```bash
+pip install divicast
+```
+
+或直接克隆仓库：
+```
+git clone https://github.com/wangsquirrel/divicast.git
+cd divicast
+pip install .
+```
+
+## 快速上手
+
+以下是一个简单的六爻排盘示例：
+
+更多用法请参考 examples/sixline_example.py。
+
+```python
+from divicast.sixline import DivinatorySymbol, rich_draw_divination, to_standard_format
+
+# 创建一个六爻卦象
+d = DivinatorySymbol.create()
+
+# 输出文本排版格式的卦象
+rich_draw_divination(d)
+
+# 输出卦象标准化json格式
+print(to_standard_format(d).model_dump_json(exclude_none=True))
+```
+
+如有问题或建议，欢迎提交 issue 或 PR

divicast-0.1.1/README.md

@@ -0,0 +1,44 @@
+# 玄学排盘库
+
+本库用于六爻排盘（六爻预测），提供了基础的六爻相关实体、符号、五行、天干地支等数据结构和推演逻辑，适合用于命理、易学、占卜等相关应用的开发。致力于面向未来，面向AI
+
+## 功能简介
+
+- 支持六爻排盘的基本流程
+- 内置天干、地支、五行、六神、卦象等基础数据
+- 提供六爻相关实体和符号的操作
+- 易于扩展和集成到其他 Python 项目
+
+## 安装
+
+```bash
+pip install divicast
+```
+
+或直接克隆仓库：
+```
+git clone https://github.com/wangsquirrel/divicast.git
+cd divicast
+pip install .
+```
+
+## 快速上手
+
+以下是一个简单的六爻排盘示例：
+
+更多用法请参考 examples/sixline_example.py。
+
+```python
+from divicast.sixline import DivinatorySymbol, rich_draw_divination, to_standard_format
+
+# 创建一个六爻卦象
+d = DivinatorySymbol.create()
+
+# 输出文本排版格式的卦象
+rich_draw_divination(d)
+
+# 输出卦象标准化json格式
+print(to_standard_format(d).model_dump_json(exclude_none=True))
+```
+
+如有问题或建议，欢迎提交 issue 或 PR

divicast-0.1.1/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "divicast"
+version = "0.1.1"
+description = "This is a metaphysical chart library, including six line"
+readme = "README.md"
+authors = [
+    { name = "Wáng Sōng", email = "wangsquirrel@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "pydantic>=2.11.9",
+    "rich==14.0.0",
+    "tyme4py>=1.3.4",
+]
+license = { file = "LICENSE" }
+
+[project.urls]
+"Homepage" = "https://github.com/wangsquirrel/divicast"
+
+[build-system]
+requires = ["uv_build>=0.8.4,<0.9.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+test = [
+    "jsonschema>=4.25.0",
+]

divicast-0.1.1/src/divicast/__init__.py

@@ -0,0 +1,8 @@
+__version__ = "0.1.1"
+
+from .sixline.divinatory_symbol import DivinatorySymbol
+
+__all__ = [
+    "DivinatorySymbol",
+    "__version__"
+]

divicast-0.1.1/src/divicast/base/symbol.py

@@ -0,0 +1,113 @@
+from enum import Enum
+from typing import Any, Iterator, List, Self, Type, TypeVar
+
+T = TypeVar("T", bound="ValuedMultiton")
+
+
+class ValuedMultiton(Enum):
+    """
+    一个功能丰富的枚举基类，旨在通过继承来使用。
+
+    它提供了多种方式来定义和访问枚举成员，每个成员都包含一个整数值和一个中文描述。
+
+    特性:
+    - 通过 `(整数, "中文名")` 的元组形式来定义成员。
+    - 实例可以通过名称、整数值或中文名进行检索。
+    - 提供了清晰的 `__str__` 和 `__repr__` 表示。
+    - 支持迭代、比较，并提供了 `next()` 方法用于循环遍历。
+    - 提供了 `all()` 和 `iterator_from()` 等便利的类方法。
+
+    """
+
+    def __init__(self, num: int, chinese_name: str | None = None):
+        if not isinstance(num, int) or not isinstance(chinese_name, str):
+            raise TypeError(
+                "Enum members must be defined as a tuple of (int, str).")
+        self.num = num
+        self.chinese_name = chinese_name
+
+    @classmethod
+    def _missing_(cls: Type[T], value: Any) -> T | None:
+        """
+        实现通过整数值查找实例，例如 `Color(1)`。
+        """
+        if isinstance(value, int):
+            for member in cls:
+                if member.num == value:
+                    return member
+        return None
+
+    @classmethod
+    def from_chinese_name(cls: Type[T], chinese_name: str) -> T:
+        """通过中文名查找枚举成员。"""
+        for member in cls:
+            if member.chinese_name == chinese_name:
+                return member
+        raise ValueError(
+            f"'{chinese_name}' is not a valid chinese_name for {cls.__name__}"
+        )
+
+    @classmethod
+    def all(cls: Type[T]) -> List[T]:
+        """以列表形式返回所有枚举成员，按定义顺序排列。"""
+        return list(cls)
+
+    def next(self, step: int = 1) -> Self:
+        """返回后`step`个枚举成员。如果是最后一个，则循环回到第一个。"""
+        members = self.all()
+        index = members.index(self)
+        return members[(index + step) % len(members)]
+
+    @classmethod
+    def iterator_from(cls: Type[T], start_member: T) -> Iterator[T]:
+        """创建一个从指定成员开始并循环一次的迭代器。"""
+        if not isinstance(start_member, cls):
+            raise TypeError(
+                f"start_member must be an instance of {cls.__name__}")
+
+        current = start_member
+        while True:
+            yield current
+            current = current.next()
+            if current == start_member:
+                break
+
+    def __str__(self) -> str:
+        """返回用户的友好字符串表示（中文名）。"""
+        return self.chinese_name
+
+    def __repr__(self) -> str:
+        """返回开发者的清晰、无歧义的表示。"""
+        return f"<{self.__class__.__name__}.{self.name}: {self.num} ('{self.chinese_name}')>"
+
+    def __eq__(self, other: Any) -> bool:
+        """
+        允许枚举成员与整数值进行比较。
+        例如 `Color.RED == 1`。
+        """
+        if isinstance(other, int):
+            return self.num == other
+        # 对于其他类型，使用 `enum.Enum` 的默认比较逻辑
+        return super().__eq__(other)
+
+    def __hash__(self) -> int:
+        """确保枚举成员是可哈希的，以便在字典键或集合中使用。"""
+        return hash(self.num)
+
+    # --- 序列化 ---
+
+    def to_dict(self) -> str:
+        """
+        返回一个简单的、可序列化的表示（成员名称）。
+        """
+        return self.name
+
+
+class BelongsTo:
+    """
+    继承此类以创建一个属于另一个类的类。
+    """
+
+    def belongs_to(self, _: type[T], map_name: str) -> T:
+        a = getattr(self, map_name)[self]
+        return a

divicast-0.1.1/src/divicast/entities/daemon.py

@@ -0,0 +1,21 @@
+from divicast.base.symbol import ValuedMultiton
+
+
+class Daemon(ValuedMultiton):
+    """
+    神煞
+    """
+
+    Tianyiguiren = (0, "天乙贵人")
+    Yima = (1, "驿马")
+    Taohua = (2, "桃花")
+    Wenchang = (3, "文昌")
+    Lushen = (4, "禄神")
+    Jiesha = (5, "劫煞")
+    Huagai = (6, "华盖")
+    Jiangxing = (7, "将星")
+    Tianxi = (8, "天喜")
+    Tianyi = (9, "天医")
+    Yangren = (10, "阳刃")
+    Zaisha = (11, "灾煞")
+    Mouxing = (12, "谋星")

divicast-0.1.1/src/divicast/entities/dizhi.py

@@ -0,0 +1,78 @@
+from __future__ import annotations  # 用于前向引用
+
+from typing import ClassVar, Dict, List
+
+from divicast.base.symbol import ValuedMultiton
+from divicast.entities.wuxing import *
+
+
+class Dizhi(BelongsToYinYang, BelongsToWuxing, ValuedMultiton):
+    """
+    地支
+    """
+
+    _WUXING_MAP: Dict['Dizhi', 'Wuxing']
+
+    Zi = (0, "子")
+    Chou = (1, "丑")
+    Yin = (2, "寅")
+    Mou = (3, "卯")
+    Chen = (4, "辰")
+    Si = (5, "巳")
+    Wu = (6, "午")
+    Wei = (7, "未")
+    Shen = (8, "申")
+    You = (9, "酉")
+    Xu = (10, "戌")
+    Hai = (11, "亥")
+
+    def is_chong(self, d: Dizhi) -> bool:
+        """判断地支相冲"""
+        return abs(self.num - d.num) == 6
+
+    def chong(self) -> Dizhi:
+        """返回相冲的地支"""
+        return Dizhi((self.num + 6) % 12)
+
+    def is_he(self, d: Dizhi) -> bool:
+        """判断地支相合"""
+        return (self.num + d.num) % 12 == 1
+
+    def he(self) -> Dizhi:
+        """返回相合的地支"""
+        return Dizhi((13 - self.num) % 12)
+
+    def belongs_to_yinyang(self) -> YinYang:
+        return YinYang((self.num+1) % 2)
+
+    def generate(self) -> List[Dizhi]:
+        r = []
+        w = self.belongs_to_wuxing().generate()
+        for d in self.all():
+            if d.belongs_to_wuxing() == w:
+                r.append(d)
+        return r
+
+    def restrain(self) -> List[Dizhi]:
+        r = []
+        w = self.belongs_to_wuxing().restrain()
+        for d in self.all():
+            if d.belongs_to_wuxing() == w:
+                r.append(d)
+        return r
+
+
+Dizhi._WUXING_MAP = {
+    Dizhi.Zi: Wuxing.Water,
+    Dizhi.Chou: Wuxing.Earth,
+    Dizhi.Yin: Wuxing.Wood,
+    Dizhi.Mou: Wuxing.Wood,
+    Dizhi.Chen: Wuxing.Earth,
+    Dizhi.Si: Wuxing.Fire,
+    Dizhi.Wu: Wuxing.Fire,
+    Dizhi.Wei: Wuxing.Earth,
+    Dizhi.Shen: Wuxing.Metal,
+    Dizhi.You: Wuxing.Metal,
+    Dizhi.Xu: Wuxing.Earth,
+    Dizhi.Hai: Wuxing.Water,
+}

divicast-0.1.1/src/divicast/entities/liushen.py

@@ -0,0 +1,14 @@
+from divicast.base.symbol import ValuedMultiton
+
+
+class Liushen(ValuedMultiton):
+    """
+    六神
+    """
+
+    QingLong = (0, "青龙")
+    ZhuQue = (1, "朱雀")
+    GouChen = (2, "勾陈")
+    TengShe = (3, "腾蛇")
+    BaiHu = (4, "白虎")
+    XuanWu = (5, "玄武")

divicast-0.1.1/src/divicast/entities/relative.py

@@ -0,0 +1,14 @@
+from divicast.base.symbol import ValuedMultiton
+from divicast.entities.wuxing import Wuxing
+
+
+class Relative(ValuedMultiton):
+    """
+    六亲
+    """
+
+    Brother = (0, "兄弟")
+    Descendant = (1, "子孙")
+    Parent = (2, "父母")
+    Governer = (3, "官鬼")
+    Wife = (4, "妻财")

divicast-0.1.1/src/divicast/entities/tiangan.py

@@ -0,0 +1,104 @@
+from __future__ import annotations  # 用于前向引用
+
+from typing import ClassVar, Dict, Self
+
+from divicast.base.symbol import ValuedMultiton
+from divicast.entities.wuxing import (BelongsToWuxing, BelongsToYinYang,
+                                      Wuxing, YinYang)
+
+
+class Shishen(ValuedMultiton):
+    """
+    十神
+    """
+
+    BiJian = (0, "比肩")
+    JieCai = (1, "劫财")
+    ShiShen = (2, "食神")
+    ShangGuan = (3, "伤官")
+    PianCai = (4, "偏财")
+    ZhengCai = (5, "正财")
+    QiSha = (6, "七杀")  # 也叫偏官
+    ZhengGuan = (7, "正官")
+    PianYin = (8, "偏印")  # 也叫枭神
+    ZhengYin = (9, "正印")
+
+
+class Tiangan(BelongsToWuxing, BelongsToYinYang, ValuedMultiton):
+    """
+    天干
+    """
+    _WUXING_MAP: ClassVar[Dict[Tiangan, Wuxing]]
+
+    Jia = (0, "甲")
+    Yi = (1, "乙")
+    Bing = (2, "丙")
+    Ding = (3, "丁")
+    Wu = (4, "戊")
+    Ji = (5, "己")
+    Geng = (6, "庚")
+    Xin = (7, "辛")
+    Ren = (8, "壬")
+    Gui = (9, "癸")
+
+    def belongs_to_yinyang(self) -> YinYang:
+        """
+        获取天干所属的阴阳
+        """
+        return YinYang((self.num+1) % 2)
+
+    def get_shishen(self, other: Self) -> Shishen:
+        """
+        获取对应的十神
+        """
+        if self.belongs_to_wuxing() == other.belongs_to_wuxing():
+            # 同五行
+            return (
+                Shishen.BiJian
+                if self.belongs_to_yinyang() == other.belongs_to_yinyang()
+                else Shishen.JieCai  # type: ignore
+            )
+        elif self.belongs_to_wuxing().generate() == other.belongs_to_wuxing():
+            # 我生对方
+            return (
+                Shishen.ShiShen
+                if self.belongs_to_yinyang() == other.belongs_to_yinyang()
+                else Shishen.ShangGuan  # type: ignore
+            )
+        elif self.belongs_to_wuxing().restrain() == other.belongs_to_wuxing():
+            # 我克对方
+            return (
+                Shishen.PianCai
+                if self.belongs_to_yinyang() == other.belongs_to_yinyang()
+                else Shishen.ZhengCai  # type: ignore
+            )
+        elif self.belongs_to_wuxing() == other.belongs_to_wuxing().restrain():
+            # 对方克我
+            return (
+                Shishen.QiSha
+                if self.belongs_to_yinyang() == other.belongs_to_yinyang()
+                else Shishen.ZhengGuan  # type: ignore
+            )
+        elif self.belongs_to_wuxing() == other.belongs_to_wuxing().generate():
+            # 对方生我
+            return (
+                Shishen.PianYin
+                if self.belongs_to_yinyang() == other.belongs_to_yinyang()
+                else Shishen.ZhengYin  # type: ignore
+            )
+        else:
+            raise ValueError("无法计算对应的十神关系")
+
+
+Tiangan._WUXING_MAP = {
+    Tiangan.Jia: Wuxing.Wood,
+    Tiangan.Yi: Wuxing.Wood,
+    Tiangan.Bing: Wuxing.Fire,
+    Tiangan.Ding: Wuxing.Fire,
+    Tiangan.Wu: Wuxing.Earth,
+    Tiangan.Ji: Wuxing.Earth,
+    Tiangan.Geng: Wuxing.Metal,
+    Tiangan.Xin: Wuxing.Metal,
+    Tiangan.Ren: Wuxing.Water,
+    Tiangan.Gui: Wuxing.Water,
+}