divicast 0.2.3

This is a metaphysical chart library, including six line

玄学排盘库

本库用于六爻排盘（六爻预测）和八字排盘（八字预测），提供了基础的六爻、八字相关实体、符号、五行、天干地支等数据结构和推演逻辑，适合用于命理、易学、占卜等相关应用的开发。致力于面向未来，面向AI

功能简介

六爻排盘

• 支持六爻排盘的基本流程
• 内置天干、地支、五行、六神、卦象等基础数据
• 提供六爻相关实体和符号的操作

八字排盘

• 支持八字排盘的基本流程
• 提供格局、大运、流年、神煞等分析功能
• 内置十神、纳音、十二长生等基础数据

安装

pip install divicast

或直接克隆仓库：

git clone https://github.com/wangsquirrel/divicast.git
cd divicast
pip install .

快速上手

以下是一个简单的六爻排盘示例：

更多用法请参考 examples/sixline_example.py。

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))

八字

以下是一个简单的八字排盘示例：

更多用法请参考 examples/bazi_example.py。

import datetime
from divicast.birth_chart import BirthChart, Gender

# 创建一个八字盘
chart = BirthChart.create(
    datetime.datetime(1990, 8, 15, 14, 30, 0),
    gender=Gender.Male,
)

# 输出八字标准化json格式
print(chart.to_standard_output().model_dump_json(exclude_none=True))

时间约定

• 本库不处理时区、地点、真太阳时换算。
• 传入 BirthChart.create()、to_standard_format()、DivinatorySymbol.create() 的时间，必须是调用方已经归一化好的排盘时间。
• 当前只接受 naive datetime。如果传入带 tzinfo 的 aware datetime，库会直接拒绝。
• 如果你的业务口径是“当地真太阳时排盘”，请先在调用方完成转换，再把转换后的 naive datetime 传入本库。

如有问题或建议，欢迎提交 issue 或 PR