IChingPy¶
An object-oriented Python library for working with the I-Ching ☯️ with type annotations.
What is I-Ching (the Book of Changes)?¶
Motivation and Goal¶
Most applications (mostly divination methods) of the I-Ching are considered as superstitious. In Chinese, "superstitious" is defined as: to believe blindly. This library demonstrates applications often regarded as superstitious, leaving it up to you to decide whether to believe in them or not.
These application involves complicated logics, this library implement in such a way that a proficient Python developer can easily understand how to perform those divination by just reading the code.
Installing Ichingpy is as simple as: pip install ichingpy
- Multiple languages support: both Chinese and English can be used as the display language.
IChingPy examples¶
Too see IChingPy at work, let's start with a simple example, creating a hexagram from datetime now.
from datetime import datetime
import ichingpy as icp
hexagram = icp.Hexagram.from_datetime(datetime.now())
hexagram
"""
-- --
-- -- X -> -----
-----
-----
-----
-----
"""
Create a Kou Hexagram (Coming to meet, 天风姤)
gou = icp.Hexagram.from_binary([2, 1, 1, 1, 1, 1])
Create a assigner (创建一个干支装卦器)
assigner = icp.SixLinesDivinationEngine()
assigner.execute(gou)
gou
"""
父母 壬 戌土 -----
兄弟 壬 申金 -----
官鬼 壬 午火 ----- 应
兄弟 辛 酉金 -----
子孙 辛 亥水 -----
父母 辛 丑土 -- -- 世
"""
icp.set_language("en")
gou
"""
PARENTS Ren (9) Xu (11) EARTH -----
SIBLINGS Ren (9) Shen (9 ) METAL -----
OFFICIALSRen (9) Wu (7 ) FIRE ----- OBJECT
SIBLINGS Xin (8) You (10) METAL -----
CHILDREN Xin (8) Hai (12) WATER -----
PARENTS Xin (8) Chou (2 ) EARTH -- -- SUBJECT
"""