Metadata-Version: 2.4
Name: sxtwl-modern
Version: 1.1.2
Summary: Sxtwl_cpp wrapper for Python - Chinese Lunar Calendar Library
Home-page: https://github.com/SIC98/sxtwl
Author: yuangu
Author-email: yuangu <lifulinghan@aol.com>
License: BSD
Project-URL: Homepage, https://github.com/SIC98/sxtwl
Project-URL: Repository, https://github.com/SIC98/sxtwl
Project-URL: Bug Tracker, https://github.com/SIC98/sxtwl/issues
Keywords: lunar,calendar,chinese,astronomy
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
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: Programming Language :: C++
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

[![Build Status](https://travis-ci.org/yuangu/sxtwl_cpp.svg?branch=master)](https://travis-ci.org/yuangu/sxtwl_cpp)
[![Build status](https://ci.appveyor.com/api/projects/status/i78d0p0dggp9v475?svg=true)](https://ci.appveyor.com/project/yuangu/sxtwl-cpp)

本项目 [GitHub](https://github.com/yuangu/sxtwl_cpp) / [Gitee（码云）](https://gitee.com/yuangu/sxtwl)。

## 详细介绍

sxtwl_cpp 是一个[寿星天文历](http://www.nongli.net/sxwnl/)的 C++实现日历库。因为其依据天文历法算法实现，故其可查询范围广(BC722 年以后与实历相符)。支持 Android、IOS、Windows、MacOS、Linux 等平台。使用 swig 暴露接口给 python,lua,java 等语言使用。

## 功能介绍

- [x] 获取农历、公历以及天干地支数据
- [x] 农历和阴历互转
- [ ] 回历的支持
- [ ] 真太阳时支持
- [ ] 行星历的支持

## 特性

- 易于使用：使用 cmake 管理工程
- 多平台支持
- 查询范围广
- 免除附带表数据

## 用途

- 做为航海历使用。（注：虽然叫做农历，其实和农业生产一点关系都没有。但和航海有关）
- 命理研究
- 考古工作
- 与农历相关的数据提供
- 天文研究
- 其它用途等我再想一下。

## 目前的缺陷

- 由于 js 代码为弱语言类型，在翻译成 C++过程中，为了考虑精度使用的是 long double 类型.有些地方可以考虑用 int 类型替代
- 部分语法无 C++语法特点。

## 效果图

![C#的执行效果图](doc/img/csharp_img.png)

![python的执行效果图](doc/img/python.png)

## 构建方法（C++，C#，PHP,Lua 等）

请参考[构建文档](doc/如何构建.md)

### Python 用户懒人安装方法

```
pip install sxtwl
```

具体详情可以参考：
https://pypi.org/project/sxtwl/

## 交流沟通群

- 如有对日历，易学等感觉兴趣的同学或使用此项目过程中遇到困难的同学，可加微信（yyguzi）入群讨论。
- 如有需要付费类的技术支持（如，八字工具类 APP，万年历，sxtwl_cpp 移值等），也可以微信（yyguzi）议价合作。

## 最后

- 如果想加入此项目请联系 元谷(lifulinghan@aol.com)
- 如果使用此项目，请告之一下作者
- 如果您使用了此项目的代码，为了表示对寿星天文历原作者的尊重，请您项目适当的位置表达对许剑伟先生感谢
