get-fortune-analysis

Use the lunar_python library to convert the solar birth date into a lunar calendar object, then extract the Eight Characters (BaZi) via getEightChar. The day master element and annual Ten Gods are derived from the resulting stems and branches.

lunar_python provides Solar and Lunar classes for calendar conversion and exposes getEightChar for Four Pillars calculation. It also supports retrieving year stems, branches, and directional positions like the wealth god direction.

It requires birth_year, birth_month, birth_day, and birth_hour as integers, with an optional focus_type parameter for career, wealth, or love emphasis. The birth hour defaults to zero if not specified.

A scoring rule adds 40 points if the month branch supports the day master element and 15 points for each matching branch in year, day, and hour pillars. A score of 40 or above is classified as strong, otherwise weak.

The annual pillar uses a simplified mid-year lunar lookup rather than precise Li Chun boundary logic, so fortunes near the solar term transition may be inaccurate. Yin-yang classification of branches is also simplified.