sanmiao 0.1.0__tar.gz

sanmiao-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+Copyright © 2025 Daniel Patrick MORGAN
+
+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.

sanmiao-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+include README.md include LICENSE include src/sanmiao/data/*.csv

sanmiao-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: sanmiao
+Version: 0.1.0
+Summary: A Python package for date conversion to and from Chinese and Japanese historical calendars
+Author-email: Daniel Patrick Morgan <daniel.morgan@college-de-france.fr>
+Project-URL: Homepage, https://github.com/PotatoSinology/sanmiao
+Project-URL: Repository, https://github.com/PotatoSinology/sanmiao.git
+Project-URL: Issues, https://github.com/PotatoSinology/sanmiao/issues
+Keywords: date conversion,Chinese calendar,Japanese calendar,history,history of astronomy,astronomy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.3.5
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: lxml>=4.6.0
+Requires-Dist: importlib_resources>=5.0; python_version < "3.9"
+Dynamic: license-file
+
+# Sanmiao
+> **Chinese and Japanese historical date conversion in Python**.
+
+Author: Daniel Patrick Morgan (CNRS-CRCAO)
+
+Sanmiao is a Python package for date conversion to and from Chinese and Japanese historical calendars (3rd cent. B.C.–20th cent.) written by a historian of astronomy. 
+
+GitHub: [https://github.com/architest/pymeeus](https://github.com/architest/pymeeus)
+
+## Installation
+
+The easiest way of installing Sanmiao is using pip:
+
+```sh
+pip install sanmiao
+```
+
+If you prefer Python3, you can use:
+
+```sh
+pip3 install --user sanmiao
+```
+
+If you have Sanmiao already installed, but want to upgrade to the latest version:
+
+```sh
+pip3 install -U sanmiao
+```
+
+## Using Sanmiao
+
+Sanmiao uses the astronomical year, where 1 B.C. = 0, 100 B.C. = -99, etc. It recognizes years (e.g., 534), Y-M-D date strings (e.g., -99-3-5, 1532-6-4), Julian Day Numbers (e.g., 1684971.5), and Chinese date strings of differing precision and completeness (e.g., "東漢孝獻皇帝劉協建安十八年二月," "太祖元年," or "三年三月甲申"). These should be separated by commas, semicolons, or line breaks:
+
+```Python
+import sanmiao
+
+user_input = """
+東漢孝獻皇帝劉協建安十八年二月, 
+宋太祖三年四月
+313-12-10, 
+415, 416, 417
+"""
+result = sanmiao.cjk_date_interpreter(user_input)
+```
+## Sources
+What distinguishes this date convertor from others is that it uses historical tables based, notably those of Zhang Peiyu[^1] and Uchida Masao,[^2] and it is updated to include new archeological evidence[^3] as well as minor dynasties and reign eras. The tables are based on calculation from contemporary procedure texts (_lifa_ 曆法), eclipses, and recorded dates, and I plan to expand them in future versions to include Korean tables and independantly calculated new moons for minor dynasties running different calendars.
+
+[^1]: Zhang Peiyu 張培瑜, _Sanqianwubai nian liri tianxiang_ 三千五百年曆日天象 (Zhengzhou: Daxiang chubanshe, 1997).
+[^2]: Uchida Masao, _Nihon rekijitsu genten_ 日本暦日原典 (Tōkyō : Yūzankaku shuppan , 1975).
+[^3]: E.g., Zhang Peiyu 張培瑜, "Genju xinchu liri jiandu shilun Qin he Han chu de lifa" 根据新出歷日簡牘試論秦和漢初的曆法, _Zhongyuan wenwu_ 中原文物 2007.5: 62–77.
+
+## Contributing
+
+The preferred method to contribute is through forking and pull requests:
+
+1. Fork it (<https://github.com/PotatoSinology/sanmiao/fork>)
+2. Create your feature branch (`git checkout -b feature/fooBar`)
+3. Commit your changes (`git commit -am 'Add some fooBar'`)
+4. Push to the branch (`git push origin feature/fooBar`)
+5. Create a new Pull Request

sanmiao-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Sanmiao
+> **Chinese and Japanese historical date conversion in Python**.
+
+Author: Daniel Patrick Morgan (CNRS-CRCAO)
+
+Sanmiao is a Python package for date conversion to and from Chinese and Japanese historical calendars (3rd cent. B.C.–20th cent.) written by a historian of astronomy. 
+
+GitHub: [https://github.com/architest/pymeeus](https://github.com/architest/pymeeus)
+
+## Installation
+
+The easiest way of installing Sanmiao is using pip:
+
+```sh
+pip install sanmiao
+```
+
+If you prefer Python3, you can use:
+
+```sh
+pip3 install --user sanmiao
+```
+
+If you have Sanmiao already installed, but want to upgrade to the latest version:
+
+```sh
+pip3 install -U sanmiao
+```
+
+## Using Sanmiao
+
+Sanmiao uses the astronomical year, where 1 B.C. = 0, 100 B.C. = -99, etc. It recognizes years (e.g., 534), Y-M-D date strings (e.g., -99-3-5, 1532-6-4), Julian Day Numbers (e.g., 1684971.5), and Chinese date strings of differing precision and completeness (e.g., "東漢孝獻皇帝劉協建安十八年二月," "太祖元年," or "三年三月甲申"). These should be separated by commas, semicolons, or line breaks:
+
+```Python
+import sanmiao
+
+user_input = """
+東漢孝獻皇帝劉協建安十八年二月, 
+宋太祖三年四月
+313-12-10, 
+415, 416, 417
+"""
+result = sanmiao.cjk_date_interpreter(user_input)
+```
+## Sources
+What distinguishes this date convertor from others is that it uses historical tables based, notably those of Zhang Peiyu[^1] and Uchida Masao,[^2] and it is updated to include new archeological evidence[^3] as well as minor dynasties and reign eras. The tables are based on calculation from contemporary procedure texts (_lifa_ 曆法), eclipses, and recorded dates, and I plan to expand them in future versions to include Korean tables and independantly calculated new moons for minor dynasties running different calendars.
+
+[^1]: Zhang Peiyu 張培瑜, _Sanqianwubai nian liri tianxiang_ 三千五百年曆日天象 (Zhengzhou: Daxiang chubanshe, 1997).
+[^2]: Uchida Masao, _Nihon rekijitsu genten_ 日本暦日原典 (Tōkyō : Yūzankaku shuppan , 1975).
+[^3]: E.g., Zhang Peiyu 張培瑜, "Genju xinchu liri jiandu shilun Qin he Han chu de lifa" 根据新出歷日簡牘試論秦和漢初的曆法, _Zhongyuan wenwu_ 中原文物 2007.5: 62–77.
+
+## Contributing
+
+The preferred method to contribute is through forking and pull requests:
+
+1. Fork it (<https://github.com/PotatoSinology/sanmiao/fork>)
+2. Create your feature branch (`git checkout -b feature/fooBar`)
+3. Commit your changes (`git commit -am 'Add some fooBar'`)
+4. Push to the branch (`git push origin feature/fooBar`)
+5. Create a new Pull Request

sanmiao-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sanmiao"
+version = "0.1.0"
+authors = [
+    {name = "Daniel Patrick Morgan", email = "daniel.morgan@college-de-france.fr"}
+]
+description = "A Python package for date conversion to and from Chinese and Japanese historical calendars"
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = [
+    "pandas>=1.3.5",
+    "numpy>=1.21.0",  # Minimum compatible with Python 3.7
+    "lxml>=4.6.0",     # Minimum compatible with Python 3.7
+    "importlib_resources>=5.0; python_version < '3.9'"
+]
+keywords = ["date conversion", "Chinese calendar", "Japanese calendar", "history", "history of astronomy", "astronomy"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Education",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering"
+]
+[project.urls]
+Homepage = "https://github.com/PotatoSinology/sanmiao"
+Repository = "https://github.com/PotatoSinology/sanmiao.git"
+Issues = "https://github.com/PotatoSinology/sanmiao/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

sanmiao-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sanmiao-0.1.0/src/sanmiao/__init__.py

@@ -0,0 +1,3 @@
+__version__ = "0.1.0"
+
+from .sanmiao import gz_year, jdn_to_gz, ganshu, numcon, iso_to_jdn, jdn_to_iso, jy_to_ccs, cjk_date_interpreter

sanmiao-0.1.0/src/sanmiao/data/dynasty_table_dump.csv

@@ -0,0 +1,143 @@
+dyn_id,dyn_name,dyn_start_year,dyn_end_year,cal_stream,part_of
+1,先秦,-5999,-220,,
+2,三皇五帝,-5999,-2001,,
+3,夏,-2001,-1558,,
+4,商,-1574,-1044,,
+5,周,-1044,-475,,
+6,西周,-1044,-770,,5
+7,春秋,-721,-480,,
+8,戰國,-480,-220,,
+9,東周,-770,-475,,5
+10,魯,-1042,-255,,
+11,齊,-999,-220,,
+12,姜齊,,,,
+13,田齊,,,,11
+14,晉,-1041,-348,,
+15,秦,-899,-205,,
+16,楚,-845,,,
+17,宋,-857,,,
+18,衛,-865,,,
+19,鄭,-805,,,
+20,燕,-863,,,
+21,吳,-584,,,
+22,越,-620,,,
+23,蔡,-862,-446,,
+24,曹,-1044,,,
+25,陳,-853,,,
+26,杞,-749,,,
+27,滕,-650,,,
+28,韓,-407,,,
+29,魏,-444,,,
+30,趙,-407,,,
+31,,,,,
+32,,,,,
+33,,,,,
+34,,,,,
+35,,,,,
+36,,,,,
+37,,,,,
+38,,,,,
+39,,,,,
+40,,,,,
+41,秦,-220,-205,1,
+42,漢,-205,220,1,
+43,西漢,-205,9,1,42
+44,新,9,25,1,
+45,更始,,,1,
+46,東漢,25,220,1,42
+47,三國,220,265,1,
+48,三國魏,220,265,1,
+49,三國蜀,221,263,1,
+50,三國吳,222,280,1,
+51,晉,265,419,1,
+52,西晉,265,316,1,51
+53,東晉,317,419,1,51
+54,北漢,304,318,1,
+55,前趙,318,329,1,
+56,成漢,304,347,1,
+57,後趙,319,351,1,
+58,前涼,317,376,1,
+59,前燕,337,370,1,
+60,,350,352,1,
+61,前仇池,296,371,1,
+62,前秦,350,394,1,
+63,後燕,384,407,1,
+64,後秦,384,417,1,
+65,西秦,385,431,1,
+66,後涼,386,403,1,
+67,南涼,397,414,1,
+68,北涼,401,439,1,
+69,南燕,398,410,1,
+70,西涼,400,421,1,
+71,夏,407,431,1,
+72,北燕,407,436,1,
+73,西燕,384,394,1,
+74,後仇池,385,473,1,
+75,西蜀,405,413,1,
+76,高昌,,,,
+77,,,,,
+78,,,,,
+79,,,,,
+80,,,,,
+81,拓跋魏,386,557,2,
+82,南北朝,420,589,,
+83,劉宋,420,479,1,
+84,南齊,479,502,1,
+85,南梁,502,557,1,
+86,東梁,555,587,1,
+87,西梁,557,560,1,
+88,陳,557,589,1,
+89,北魏,386,534,2,81
+90,武興,473,555,2,
+91,陰平,477,511,2,
+92,東魏,534,550,2,81
+93,西魏,535,557,3,81
+94,北齊,550,578,2,
+95,北周,557,581,3,
+96,隋,581,618,3,
+97,唐,618,907,3,
+98,鄭,619,621,3,
+99,周,684,705,3,
+100,前蜀,903,925,3,
+101,吳,904,937,3,
+102,吳,904,937,3,
+103,五代,907,960,3,
+104,吳越,907,978,3,
+105,後梁,907,923,3,
+106,楚,907,951,3,
+107,閩國,909,945,3,
+108,南漢,917,971,3,
+109,後唐,923,936,3,
+110,南平,924,963,3,
+111,後蜀,933,965,3,
+112,閩,909,925,3,
+113,後晉,936,947,3,
+114,南唐,937,975,3,
+115,遼,947,1115,3,
+116,後漢,947,951,3,
+117,後周,951,960,3,
+118,北漢,951,979,3,
+119,宋,960,1279,3,
+120,西夏,1032,1227,3,
+121,金,1115,1234,3,
+122,偽齊,1130,1137,3,
+123,西遼,1132,1218,3,
+124,元,1234,1367,3,
+125,明,1368,1644,3,
+126,北元,1371,1387,3,
+127,清,1644,1911,3,
+128,南明,1644,1661,3,
+129,中華民國,1912,3000,,
+130,中華人民共和國,1949,3000,,
+131,偽燕,,,3,
+132,北宋,,,3,
+133,日本,-2000,3000,4,
+134,高句麗,-36,668,5,
+135,百濟,-17,660,6,
+136,新羅,-56,935,7,
+137,金官伽倻,42,532,8,
+138,渤海,698,926,5,
+139,後百濟,900,936,6,
+140,後高句麗,901,918,5,
+141,高麗,918,1392,5,
+142,朝鮮,1392,1910,5,

sanmiao-0.1.0/src/sanmiao/data/dynasty_tags.csv

@@ -0,0 +1,127 @@
+string,dyn_id
+夏,3
+商,4
+殷,4
+殷商,4
+周,5
+西周,6
+東周,9
+秦,41
+漢,42
+前漢,43
+西漢,43
+新,44
+更始,45
+後漢,46
+東漢,46
+曹魏,48
+魏,48
+蜀,49
+吳,50
+晉,51
+西晉,52
+東晉,53
+趙,55
+成漢,56
+趙,57
+涼,58
+燕,59
+冉魏,60
+前秦,62
+後燕,63
+後秦,64
+西秦,65
+後涼,66
+南涼,67
+北涼,68
+南燕,69
+西涼,70
+北燕,72
+西燕,73
+劉宋,83
+宋,83
+南宋,83
+南齊,84
+齊,84
+南梁,85
+梁,85
+梁,86
+梁,87
+西梁,87
+陳,88
+北魏,89
+魏,89
+東魏,92
+魏,92
+西魏,93
+魏,93
+北齊,94
+齊,94
+北周,95
+周,95
+隋,96
+唐,97
+周,99
+武周,99
+前蜀,100
+吳,101
+吳,102
+吳越,104
+後梁,105
+楚,106
+閩國,107
+南漢,108
+後唐,109
+南平,110
+後蜀,111
+閩,112
+後晉,113
+南唐,114
+遼,115
+後漢,116
+後周,117
+北漢,118
+宋,119
+西夏,120
+金,121
+偽齊,122
+西遼,123
+元,124
+明,125
+北元,126
+清,127
+南明,128
+中華民國,129
+中華人民共和國,130
+偽燕,131
+北宋,132
+北魏,89
+北齊,94
+晉,14
+秦,15
+楚,16
+宋,17
+衛,18
+鄭,19
+燕,20
+吳,21
+越,22
+蔡,23
+曹,24
+陳,25
+杞,26
+滕,27
+韓,28
+魏,29
+趙,30
+魯,10
+齊,11
+偽梁,85
+六國,8
+朝鮮,142
+高麗,141
+後百濟,139
+百濟,139
+後高句麗,140
+高句麗,140
+新羅,136