x-iztro 0.2.0

Zi Wei Dou Shu (Purple Star Astrology) chart engine, field-for-field identical to iztro
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

//! 紫微斗数排盘核心库，移植自 JS iztro v2.5.8。
//!
//! 入口：[`by_solar`] / [`by_lunar`] 排盘，[`get_horoscope`] 计算运限，
//! [`astrolabe_to_prompt`] / [`horoscope_to_prompt`] 生成 AI 分析文本。
//! 排盘行为由 [`Config`] 的六个开关控制，默认与 JS iztro 一致。

#![warn(missing_docs)]

/// 绑定层共用的编组与分派。
///
/// 排盘入口只被 `python` feature 与 wasm32 目标的绑定文件消费——两者都不在
/// 默认的本机构建里，故豁免 dead_code；C FFI 只经它走统一查询入口。
#[allow(dead_code)]
pub(crate) mod bridge;

/// 排盘与运限主流程
pub mod astro;
/// 枚举、常量与星耀数据表
pub mod data;
/// 跨语言绑定的序列化 DTO（camelCase + 翻译值 + 语言无关标识）
pub mod dto;
/// 排盘入口的错误类型
pub mod error;
/// 六语言词表与翻译入口
pub mod i18n;
/// 星盘、宫位、星耀与运限的数据结构
pub mod models;
/// AI 分析 Prompt 生成
pub mod prompt;
/// 安星算法
pub mod star;
/// 通用索引工具
pub mod utils;

#[cfg(feature = "python")]
mod python;

/// C ABI 导出（供 Go/C 等语言调用）
#[doc(hidden)]
pub mod ffi;

#[cfg(target_arch = "wasm32")]
#[doc(hidden)]
pub mod wasm;

// Re-export main public API
pub use astro::builder::{by_lunar, by_solar};
pub use astro::horoscope::get_horoscope;
pub use astro::palace::{get_five_elements_class, get_palace_names, get_soul_and_body};
pub use astro::query::{
    get_major_star_by_lunar_date, get_major_star_by_solar_date, get_sign_by_lunar_date,
    get_sign_by_solar_date, get_zodiac_by_solar_date,
};
pub use data::stars::StarKey;
pub use data::types::*;
pub use error::{BridgeError, IztroError};
pub use i18n::lookup::{key_of, key_of_in, translate_key};
pub use i18n::{
    translate_brightness, translate_earthly_branch, translate_five_elements_class,
    translate_gender, translate_heavenly_stem, translate_horoscope_name, translate_mutagen,
    translate_palace, translate_sign, translate_star, translate_time, translate_zodiac,
};
pub use models::astrolabe::{
    Astrolabe, PalaceRef, PalaceTarget, RawChineseDate, RawDates, RawLunarDate, StarRef,
};
pub use models::horoscope::{
    AgeItem, HoroscopeData, HoroscopeItem, HoroscopeRef, YearlyDecStar, YearlyItem,
};
pub use models::palace::{Decadal, PalaceData};
pub use models::star::Star;
pub use models::surpalaces::SurroundedPalaces;
pub use prompt::{astrolabe_to_prompt, horoscope_to_prompt};

/// 便捷函数：排盘并返回 JSON
///
/// # Errors
/// 入参非法时返回 [`IztroError`]（同 [`by_solar`]）。
pub fn by_solar_json(
    solar_date: &str,
    time_index: u8,
    gender: Gender,
    fix_leap: bool,
    language: Language,
    config: Config,
) -> Result<String, IztroError> {
    let astrolabe = by_solar(solar_date, time_index, gender, fix_leap, language, config)?;
    Ok(serde_json::to_string(&astrolabe.to_dto())
        .expect("DTO 只含字符串、数值与容器，序列化不会失败"))
}

/// 便捷函数：农历排盘并返回 JSON
///
/// # Errors
/// 入参非法时返回 [`IztroError`]（同 [`by_lunar`]）。
pub fn by_lunar_json(
    lunar_date: &str,
    time_index: u8,
    gender: Gender,
    leap: LeapMonth,
    language: Language,
    config: Config,
) -> Result<String, IztroError> {
    let astrolabe = by_lunar(lunar_date, time_index, gender, leap, language, config)?;
    Ok(serde_json::to_string(&astrolabe.to_dto())
        .expect("DTO 只含字符串、数值与容器，序列化不会失败"))
}