summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCoprDistGit <infra@openeuler.org>2023-05-05 10:51:40 +0000
committerCoprDistGit <infra@openeuler.org>2023-05-05 10:51:40 +0000
commitf7c37573b21e3a219a01f291ad264e0ade9f2064 (patch)
tree7f7dc2dfe93a79a9b24c621bd4a5aa2152c51676
parent1711a7ca94b9a5641710c7ab98449c5251d9b60f (diff)
automatic import of python-cn2anopeneuler20.03
-rw-r--r--.gitignore1
-rw-r--r--python-cn2an.spec917
-rw-r--r--sources1
3 files changed, 919 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
index e69de29..f81a001 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/cn2an-0.5.19.tar.gz
diff --git a/python-cn2an.spec b/python-cn2an.spec
new file mode 100644
index 0000000..910d7a7
--- /dev/null
+++ b/python-cn2an.spec
@@ -0,0 +1,917 @@
+%global _empty_manifest_terminate_build 0
+Name: python-cn2an
+Version: 0.5.19
+Release: 1
+Summary: Convert Chinese numerals and Arabic numerals.
+License: MIT License
+URL: https://github.com/Ailln/cn2an
+Source0: https://mirrors.nju.edu.cn/pypi/web/packages/71/d4/d0ec88bfaf2d5881fef00045e8a2197c5965d59fadb01a19b1a937729cd8/cn2an-0.5.19.tar.gz
+BuildArch: noarch
+
+Requires: python3-setuptools
+Requires: python3-proces
+
+%description
+# cn2an: Chinese Numerals To Arabic Numerals
+
+[![Pypi](https://img.shields.io/pypi/v/cn2an.svg)](https://pypi.org/project/cn2an/)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Ailln/cn2an/blob/master/LICENSE)
+[![stars](https://img.shields.io/github/stars/Ailln/cn2an.svg)](https://github.com/Ailln/cn2an/stargazers)
+[![build](https://img.shields.io/github/workflow/status/Ailln/cn2an/build)](https://github.com/Ailln/cn2an/actions?query=workflow%3Abuild)
+[![API](https://img.shields.io/badge/API-reference-pink.svg)](https://github.com/Ailln/cn2an/wiki/API)
+
+📦 **`cn2an`** 是一个快速转化 `中文数字` 和 `阿拉伯数字` 的工具包!
+
+[![](https://ailln.oss-cn-hangzhou.aliyuncs.com/github/cn2an/cn2an-site-latest.png)](https://www.dovolopor.com/cn2an)
+
+🔗[点击访问 DEMO](https://www.dovolopor.com/cn2an)
+
+> 🎈 `v0.5.19 update`: update proces>=0.1.3 to fix v0.5.18
+>
+> 🎈 [`en2an`](https://github.com/Ailln/en2an): 「英文数字」和「阿拉伯数字」互转正在收集需求中! [详情](https://github.com/Ailln/en2an)
+>
+> 🎈 [`Cn2An.jl`](https://github.com/Ailln/Cn2An.jl): Julia 语言版本已经上线,正在丰富基础功能。[详情](https://github.com/Ailln/Cn2An.jl)
+
+## 1 功能
+
+### 1.1 `中文数字` => `阿拉伯数字`
+
+- 支持 `中文数字` => `阿拉伯数字`;
+- 支持 `大写中文数字` => `阿拉伯数字`;
+- 支持 `中文数字和阿拉伯数字` => `阿拉伯数字`;
+
+### 1.2 `阿拉伯数字` => `中文数字`
+
+- 支持 `阿拉伯数字` => `中文数字`;
+- 支持 `阿拉伯数字` => `大写中文数字`;
+- 支持 `阿拉伯数字` => `大写人民币`;
+
+### 1.3 句子转化
+
+- 支持 `中文数字` => `阿拉伯数字`;
+ - 支持 `日期`;
+ - 支持 `分数`;
+ - 支持 `百分比`;
+ - 支持 `摄氏度`;
+
+- 支持 `阿拉伯数字` => `中文数字`;
+ - 支持 `日期`;
+ - 支持 `分数`;
+ - 支持 `百分比`;
+ - 支持 `摄氏度`;
+
+### 1.4 其他
+
+- 支持 `小数`;
+- 支持 `负数`;
+- 支持 `HTTP API`。
+
+## 2 安装
+
+> ⚠️ 注意:
+> 1. 本地安装仅支持 Python 的 3.6 以上版本;
+> 2. 其他语言用户可以考虑使用 [HTTP API](https://www.dovolopor.com/api/cn2an) ;
+> 3. 尽可能使用 `cn2an` 的最新版本。
+
+### 2.1 使用 pip 安装
+
+```shell
+pip install cn2an -U
+```
+
+### 2.2 从代码库安装
+
+```shell
+git clone https://github.com/Ailln/cn2an.git
+cd cn2an && python setup.py install
+```
+
+## 3 使用
+
+```python
+# 在文件首部引入包
+import cn2an
+
+# 查看当前版本号
+print(cn2an.__version__)
+# 0.5.19
+```
+
+### 3.1 `中文数字` => `阿拉伯数字`
+
+> 最大支持到 `10**16`,即 `千万亿`,最小支持到 `10**-16`。
+
+```python
+import cn2an
+
+# 在 strict 模式(默认)下,只有严格符合数字拼写的才可以进行转化
+output = cn2an.cn2an("一百二十三")
+# 或者
+output = cn2an.cn2an("一百二十三", "strict")
+# output:
+# 123
+
+# 在 normal 模式下,可以将 一二三 进行转化
+output = cn2an.cn2an("一二三", "normal")
+# output:
+# 123
+
+# 在 smart 模式下,可以将混合拼写的 1百23 进行转化
+output = cn2an.cn2an("1百23", "smart")
+# output:
+# 123
+
+# 以上三种模式均支持负数
+output = cn2an.cn2an("负一百二十三", "strict")
+# output:
+# -123
+
+# 以上三种模式均支持小数
+output = cn2an.cn2an("一点二三", "strict")
+# output:
+# 1.23
+```
+
+### 3.2 `阿拉伯数字` => `中文数字`
+
+> 最大支持到`10**16`,即`千万亿`,最小支持到 `10**-16`。
+
+```python
+import cn2an
+
+# 在 low 模式(默认)下,数字转化为小写的中文数字
+output = cn2an.an2cn("123")
+# 或者
+output = cn2an.an2cn("123", "low")
+# output:
+# 一百二十三
+
+# 在 up 模式下,数字转化为大写的中文数字
+output = cn2an.an2cn("123", "up")
+# output:
+# 壹佰贰拾叁
+
+# 在 rmb 模式下,数字转化为人民币专用的描述
+output = cn2an.an2cn("123", "rmb")
+# output:
+# 壹佰贰拾叁元整
+
+# 以上三种模式均支持负数
+output = cn2an.an2cn("-123", "low")
+# output:
+# 负一百二十三
+
+# 以上三种模式均支持小数
+output = cn2an.an2cn("1.23", "low")
+# output:
+# 一点二三
+```
+
+### 3.3 句子转化
+
+> ⚠️:试验性功能,可能会造成不符合期望的转化。
+
+```python
+import cn2an
+
+# 在 cn2an 方法(默认)下,可以将句子中的中文数字转成阿拉伯数字
+output = cn2an.transform("小王捡了一百块钱")
+# 或者
+output = cn2an.transform("小王捡了一百块钱", "cn2an")
+# output:
+# 小王捡了100块钱
+
+# 在 an2cn 方法下,可以将句子中的中文数字转成阿拉伯数字
+output = cn2an.transform("小王捡了100块钱", "an2cn")
+# output:
+# 小王捡了一百块钱
+
+
+## 支持日期
+output = cn2an.transform("小王的生日是二零零一年三月四日", "cn2an")
+# output:
+# 小王的生日是2001年3月4日
+
+output = cn2an.transform("小王的生日是2001年3月4日", "an2cn")
+# output:
+# 小王的生日是二零零一年三月四日
+
+## 支持分数
+output = cn2an.transform("抛出去的硬币为正面的概率是二分之一", "cn2an")
+# output:
+# 抛出去的硬币为正面的概率是1/2
+
+output = cn2an.transform("抛出去的硬币为正面的概率是1/2", "an2cn")
+# output:
+# 抛出去的硬币为正面的概率是二分之一
+
+## 支持百分比
+## 支持摄氏度
+```
+
+### 3.4 HTTP API
+
+主要为其他语言(Java、Javascript、Go等)用户提供方便,当然 Python 用户也可以使用,点击查看[详细用法](https://github.com/Ailln/cn2an/wiki/API#http-api)。
+
+## 4 版本支持
+
+- 理论上支持 `Windows`、`MacOS`、`Ubuntu` 下的所有 `Python 3.6+` 的版本。
+- 实际上仅在 `ubuntu-latest`、`windows-latest`、`macOS-latest` 的 `Python 3.6, 3.7, 3.8` 上做过完整测试。
+- 欢迎提交其他版本使用情况到 [Issues](https://github.com/Ailln/cn2an/issues) 中,期待你的反馈。
+- 如果你有 `Python 2` 的使用需求,可 Fork 代码自行修改。当然也欢迎提 PR,贡献自己代码给其他人。
+
+## 5 问题反馈
+
+1. 先搜索 [Issues](https://github.com/Ailln/cn2an/issues) 中有没有人已经问过类似的问题;
+2. 如果没有找到解答,请新开一个 issue:
+ 1. 首先,在「issue 标题」中填写你遇到的问题的简介;
+ 2. 然后,在「issue 详情」中填写你遇到的问题的详情;
+ 3. 最后,不要忘记注明你使用的操作系统(比如 Windows 10)和 Python 版本(比如 Python 3.6.3)。
+3. 还可以参考 [Issue Template](https://github.com/Ailln/cn2an/tree/master/.github/ISSUE_TEMPLATE) 。
+
+## 6 开发相关
+
+### 6.1 开发进度
+
+本项目是用看板管理开发进度,请点击 [v0.5](https://github.com/Ailln/cn2an/projects/4) 查看开发进度和计划事项。
+
+### 6.2 代码测试
+
+本地测试使用 [Anaconda](https://www.anaconda.com/) 的虚拟环境,测试方法如下:
+
+```bash
+# 执行测试
+bash scripts/local_test.sh
+```
+
+线上测试使用 [GitHub Actions](https://github.com/Ailln/cn2an/actions) 。
+
+### 6.3 性能测试
+
+- 测试版本:`v0.5.1`
+- 测试设备:`2.3 GHz 双核Intel Core i5 MacBook Pro`
+- 测试代码:[performance.py](https://github.com/Ailln/cn2an/tree/master/cn2an/performance.py)
+- 测试方法:
+
+ ```bash
+ pip install -r requirements_test.txt
+
+ python -m cn2an.performance
+ ```
+
+- 测试结果:
+
+ | 序号 | 功能 | 执行次数 | 执行时间(万次平均) | 性能(次/秒)
+ | :-: | :-: | :-: | :-: | :-: |
+ | 1 | an2cn | 10000 | 0.15 | **67k** |
+ | 2 | cn2an | 10000 | 0.35 | **29k** |
+
+测试时,我使用的是最大长度的测试数据!因此,大多数情况下该库的性能会更好~
+
+## 7 许可证
+
+[![](https://award.dovolopor.com?lt=License&rt=MIT&rbc=green)](./LICENSE)
+[![](https://award.dovolopor.com?lt=Ailln's&rt=idea&lbc=lightgray&rbc=red&ltc=red)](https://github.com/Ailln/award)
+
+## 8 交流
+
+欢迎添加微信号:`Ailln_`,备注「cn2an」,邀请你进入 Python 交流群。
+
+## 9 致谢
+
+- [Thunder Bouble](https://github.com/sfyc23): 提出很多有效的反馈,包括一些 bug 和新功能;
+- [Damon Yu](https://github.com/20071313): 增加对全角数字和全角符号的支持。
+
+## 10 参考
+
+- [🎈 cn2an 核心代码解析](https://www.v2ai.cn/2020/06/30/python/8-cn2an/)
+- [如何发布自己的包到 pypi](https://www.v2ai.cn/2018/07/30/python/1-pypi/)
+- [Python 中的小陷阱](https://www.v2ai.cn/2019/01/01/python/4-python-trap/)
+- [汉字数字转阿拉伯数字](https://www.zouyesheng.com/han-number-convert.html)
+- [Chinese Text Normalization for Speech Processing](https://github.com/speechio/chinese_text_normalization)
+- [The Best Tool of Chinese Number to Digits](https://github.com/Wall-ee/chinese2digits)
+- [Microsoft Recognizers Text Overview](https://github.com/microsoft/Recognizers-Text)
+- [process: 数据预处理管道](https://github.com/Ailln/proces)
+
+
+
+%package -n python3-cn2an
+Summary: Convert Chinese numerals and Arabic numerals.
+Provides: python-cn2an
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-pip
+%description -n python3-cn2an
+# cn2an: Chinese Numerals To Arabic Numerals
+
+[![Pypi](https://img.shields.io/pypi/v/cn2an.svg)](https://pypi.org/project/cn2an/)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Ailln/cn2an/blob/master/LICENSE)
+[![stars](https://img.shields.io/github/stars/Ailln/cn2an.svg)](https://github.com/Ailln/cn2an/stargazers)
+[![build](https://img.shields.io/github/workflow/status/Ailln/cn2an/build)](https://github.com/Ailln/cn2an/actions?query=workflow%3Abuild)
+[![API](https://img.shields.io/badge/API-reference-pink.svg)](https://github.com/Ailln/cn2an/wiki/API)
+
+📦 **`cn2an`** 是一个快速转化 `中文数字` 和 `阿拉伯数字` 的工具包!
+
+[![](https://ailln.oss-cn-hangzhou.aliyuncs.com/github/cn2an/cn2an-site-latest.png)](https://www.dovolopor.com/cn2an)
+
+🔗[点击访问 DEMO](https://www.dovolopor.com/cn2an)
+
+> 🎈 `v0.5.19 update`: update proces>=0.1.3 to fix v0.5.18
+>
+> 🎈 [`en2an`](https://github.com/Ailln/en2an): 「英文数字」和「阿拉伯数字」互转正在收集需求中! [详情](https://github.com/Ailln/en2an)
+>
+> 🎈 [`Cn2An.jl`](https://github.com/Ailln/Cn2An.jl): Julia 语言版本已经上线,正在丰富基础功能。[详情](https://github.com/Ailln/Cn2An.jl)
+
+## 1 功能
+
+### 1.1 `中文数字` => `阿拉伯数字`
+
+- 支持 `中文数字` => `阿拉伯数字`;
+- 支持 `大写中文数字` => `阿拉伯数字`;
+- 支持 `中文数字和阿拉伯数字` => `阿拉伯数字`;
+
+### 1.2 `阿拉伯数字` => `中文数字`
+
+- 支持 `阿拉伯数字` => `中文数字`;
+- 支持 `阿拉伯数字` => `大写中文数字`;
+- 支持 `阿拉伯数字` => `大写人民币`;
+
+### 1.3 句子转化
+
+- 支持 `中文数字` => `阿拉伯数字`;
+ - 支持 `日期`;
+ - 支持 `分数`;
+ - 支持 `百分比`;
+ - 支持 `摄氏度`;
+
+- 支持 `阿拉伯数字` => `中文数字`;
+ - 支持 `日期`;
+ - 支持 `分数`;
+ - 支持 `百分比`;
+ - 支持 `摄氏度`;
+
+### 1.4 其他
+
+- 支持 `小数`;
+- 支持 `负数`;
+- 支持 `HTTP API`。
+
+## 2 安装
+
+> ⚠️ 注意:
+> 1. 本地安装仅支持 Python 的 3.6 以上版本;
+> 2. 其他语言用户可以考虑使用 [HTTP API](https://www.dovolopor.com/api/cn2an) ;
+> 3. 尽可能使用 `cn2an` 的最新版本。
+
+### 2.1 使用 pip 安装
+
+```shell
+pip install cn2an -U
+```
+
+### 2.2 从代码库安装
+
+```shell
+git clone https://github.com/Ailln/cn2an.git
+cd cn2an && python setup.py install
+```
+
+## 3 使用
+
+```python
+# 在文件首部引入包
+import cn2an
+
+# 查看当前版本号
+print(cn2an.__version__)
+# 0.5.19
+```
+
+### 3.1 `中文数字` => `阿拉伯数字`
+
+> 最大支持到 `10**16`,即 `千万亿`,最小支持到 `10**-16`。
+
+```python
+import cn2an
+
+# 在 strict 模式(默认)下,只有严格符合数字拼写的才可以进行转化
+output = cn2an.cn2an("一百二十三")
+# 或者
+output = cn2an.cn2an("一百二十三", "strict")
+# output:
+# 123
+
+# 在 normal 模式下,可以将 一二三 进行转化
+output = cn2an.cn2an("一二三", "normal")
+# output:
+# 123
+
+# 在 smart 模式下,可以将混合拼写的 1百23 进行转化
+output = cn2an.cn2an("1百23", "smart")
+# output:
+# 123
+
+# 以上三种模式均支持负数
+output = cn2an.cn2an("负一百二十三", "strict")
+# output:
+# -123
+
+# 以上三种模式均支持小数
+output = cn2an.cn2an("一点二三", "strict")
+# output:
+# 1.23
+```
+
+### 3.2 `阿拉伯数字` => `中文数字`
+
+> 最大支持到`10**16`,即`千万亿`,最小支持到 `10**-16`。
+
+```python
+import cn2an
+
+# 在 low 模式(默认)下,数字转化为小写的中文数字
+output = cn2an.an2cn("123")
+# 或者
+output = cn2an.an2cn("123", "low")
+# output:
+# 一百二十三
+
+# 在 up 模式下,数字转化为大写的中文数字
+output = cn2an.an2cn("123", "up")
+# output:
+# 壹佰贰拾叁
+
+# 在 rmb 模式下,数字转化为人民币专用的描述
+output = cn2an.an2cn("123", "rmb")
+# output:
+# 壹佰贰拾叁元整
+
+# 以上三种模式均支持负数
+output = cn2an.an2cn("-123", "low")
+# output:
+# 负一百二十三
+
+# 以上三种模式均支持小数
+output = cn2an.an2cn("1.23", "low")
+# output:
+# 一点二三
+```
+
+### 3.3 句子转化
+
+> ⚠️:试验性功能,可能会造成不符合期望的转化。
+
+```python
+import cn2an
+
+# 在 cn2an 方法(默认)下,可以将句子中的中文数字转成阿拉伯数字
+output = cn2an.transform("小王捡了一百块钱")
+# 或者
+output = cn2an.transform("小王捡了一百块钱", "cn2an")
+# output:
+# 小王捡了100块钱
+
+# 在 an2cn 方法下,可以将句子中的中文数字转成阿拉伯数字
+output = cn2an.transform("小王捡了100块钱", "an2cn")
+# output:
+# 小王捡了一百块钱
+
+
+## 支持日期
+output = cn2an.transform("小王的生日是二零零一年三月四日", "cn2an")
+# output:
+# 小王的生日是2001年3月4日
+
+output = cn2an.transform("小王的生日是2001年3月4日", "an2cn")
+# output:
+# 小王的生日是二零零一年三月四日
+
+## 支持分数
+output = cn2an.transform("抛出去的硬币为正面的概率是二分之一", "cn2an")
+# output:
+# 抛出去的硬币为正面的概率是1/2
+
+output = cn2an.transform("抛出去的硬币为正面的概率是1/2", "an2cn")
+# output:
+# 抛出去的硬币为正面的概率是二分之一
+
+## 支持百分比
+## 支持摄氏度
+```
+
+### 3.4 HTTP API
+
+主要为其他语言(Java、Javascript、Go等)用户提供方便,当然 Python 用户也可以使用,点击查看[详细用法](https://github.com/Ailln/cn2an/wiki/API#http-api)。
+
+## 4 版本支持
+
+- 理论上支持 `Windows`、`MacOS`、`Ubuntu` 下的所有 `Python 3.6+` 的版本。
+- 实际上仅在 `ubuntu-latest`、`windows-latest`、`macOS-latest` 的 `Python 3.6, 3.7, 3.8` 上做过完整测试。
+- 欢迎提交其他版本使用情况到 [Issues](https://github.com/Ailln/cn2an/issues) 中,期待你的反馈。
+- 如果你有 `Python 2` 的使用需求,可 Fork 代码自行修改。当然也欢迎提 PR,贡献自己代码给其他人。
+
+## 5 问题反馈
+
+1. 先搜索 [Issues](https://github.com/Ailln/cn2an/issues) 中有没有人已经问过类似的问题;
+2. 如果没有找到解答,请新开一个 issue:
+ 1. 首先,在「issue 标题」中填写你遇到的问题的简介;
+ 2. 然后,在「issue 详情」中填写你遇到的问题的详情;
+ 3. 最后,不要忘记注明你使用的操作系统(比如 Windows 10)和 Python 版本(比如 Python 3.6.3)。
+3. 还可以参考 [Issue Template](https://github.com/Ailln/cn2an/tree/master/.github/ISSUE_TEMPLATE) 。
+
+## 6 开发相关
+
+### 6.1 开发进度
+
+本项目是用看板管理开发进度,请点击 [v0.5](https://github.com/Ailln/cn2an/projects/4) 查看开发进度和计划事项。
+
+### 6.2 代码测试
+
+本地测试使用 [Anaconda](https://www.anaconda.com/) 的虚拟环境,测试方法如下:
+
+```bash
+# 执行测试
+bash scripts/local_test.sh
+```
+
+线上测试使用 [GitHub Actions](https://github.com/Ailln/cn2an/actions) 。
+
+### 6.3 性能测试
+
+- 测试版本:`v0.5.1`
+- 测试设备:`2.3 GHz 双核Intel Core i5 MacBook Pro`
+- 测试代码:[performance.py](https://github.com/Ailln/cn2an/tree/master/cn2an/performance.py)
+- 测试方法:
+
+ ```bash
+ pip install -r requirements_test.txt
+
+ python -m cn2an.performance
+ ```
+
+- 测试结果:
+
+ | 序号 | 功能 | 执行次数 | 执行时间(万次平均) | 性能(次/秒)
+ | :-: | :-: | :-: | :-: | :-: |
+ | 1 | an2cn | 10000 | 0.15 | **67k** |
+ | 2 | cn2an | 10000 | 0.35 | **29k** |
+
+测试时,我使用的是最大长度的测试数据!因此,大多数情况下该库的性能会更好~
+
+## 7 许可证
+
+[![](https://award.dovolopor.com?lt=License&rt=MIT&rbc=green)](./LICENSE)
+[![](https://award.dovolopor.com?lt=Ailln's&rt=idea&lbc=lightgray&rbc=red&ltc=red)](https://github.com/Ailln/award)
+
+## 8 交流
+
+欢迎添加微信号:`Ailln_`,备注「cn2an」,邀请你进入 Python 交流群。
+
+## 9 致谢
+
+- [Thunder Bouble](https://github.com/sfyc23): 提出很多有效的反馈,包括一些 bug 和新功能;
+- [Damon Yu](https://github.com/20071313): 增加对全角数字和全角符号的支持。
+
+## 10 参考
+
+- [🎈 cn2an 核心代码解析](https://www.v2ai.cn/2020/06/30/python/8-cn2an/)
+- [如何发布自己的包到 pypi](https://www.v2ai.cn/2018/07/30/python/1-pypi/)
+- [Python 中的小陷阱](https://www.v2ai.cn/2019/01/01/python/4-python-trap/)
+- [汉字数字转阿拉伯数字](https://www.zouyesheng.com/han-number-convert.html)
+- [Chinese Text Normalization for Speech Processing](https://github.com/speechio/chinese_text_normalization)
+- [The Best Tool of Chinese Number to Digits](https://github.com/Wall-ee/chinese2digits)
+- [Microsoft Recognizers Text Overview](https://github.com/microsoft/Recognizers-Text)
+- [process: 数据预处理管道](https://github.com/Ailln/proces)
+
+
+
+%package help
+Summary: Development documents and examples for cn2an
+Provides: python3-cn2an-doc
+%description help
+# cn2an: Chinese Numerals To Arabic Numerals
+
+[![Pypi](https://img.shields.io/pypi/v/cn2an.svg)](https://pypi.org/project/cn2an/)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Ailln/cn2an/blob/master/LICENSE)
+[![stars](https://img.shields.io/github/stars/Ailln/cn2an.svg)](https://github.com/Ailln/cn2an/stargazers)
+[![build](https://img.shields.io/github/workflow/status/Ailln/cn2an/build)](https://github.com/Ailln/cn2an/actions?query=workflow%3Abuild)
+[![API](https://img.shields.io/badge/API-reference-pink.svg)](https://github.com/Ailln/cn2an/wiki/API)
+
+📦 **`cn2an`** 是一个快速转化 `中文数字` 和 `阿拉伯数字` 的工具包!
+
+[![](https://ailln.oss-cn-hangzhou.aliyuncs.com/github/cn2an/cn2an-site-latest.png)](https://www.dovolopor.com/cn2an)
+
+🔗[点击访问 DEMO](https://www.dovolopor.com/cn2an)
+
+> 🎈 `v0.5.19 update`: update proces>=0.1.3 to fix v0.5.18
+>
+> 🎈 [`en2an`](https://github.com/Ailln/en2an): 「英文数字」和「阿拉伯数字」互转正在收集需求中! [详情](https://github.com/Ailln/en2an)
+>
+> 🎈 [`Cn2An.jl`](https://github.com/Ailln/Cn2An.jl): Julia 语言版本已经上线,正在丰富基础功能。[详情](https://github.com/Ailln/Cn2An.jl)
+
+## 1 功能
+
+### 1.1 `中文数字` => `阿拉伯数字`
+
+- 支持 `中文数字` => `阿拉伯数字`;
+- 支持 `大写中文数字` => `阿拉伯数字`;
+- 支持 `中文数字和阿拉伯数字` => `阿拉伯数字`;
+
+### 1.2 `阿拉伯数字` => `中文数字`
+
+- 支持 `阿拉伯数字` => `中文数字`;
+- 支持 `阿拉伯数字` => `大写中文数字`;
+- 支持 `阿拉伯数字` => `大写人民币`;
+
+### 1.3 句子转化
+
+- 支持 `中文数字` => `阿拉伯数字`;
+ - 支持 `日期`;
+ - 支持 `分数`;
+ - 支持 `百分比`;
+ - 支持 `摄氏度`;
+
+- 支持 `阿拉伯数字` => `中文数字`;
+ - 支持 `日期`;
+ - 支持 `分数`;
+ - 支持 `百分比`;
+ - 支持 `摄氏度`;
+
+### 1.4 其他
+
+- 支持 `小数`;
+- 支持 `负数`;
+- 支持 `HTTP API`。
+
+## 2 安装
+
+> ⚠️ 注意:
+> 1. 本地安装仅支持 Python 的 3.6 以上版本;
+> 2. 其他语言用户可以考虑使用 [HTTP API](https://www.dovolopor.com/api/cn2an) ;
+> 3. 尽可能使用 `cn2an` 的最新版本。
+
+### 2.1 使用 pip 安装
+
+```shell
+pip install cn2an -U
+```
+
+### 2.2 从代码库安装
+
+```shell
+git clone https://github.com/Ailln/cn2an.git
+cd cn2an && python setup.py install
+```
+
+## 3 使用
+
+```python
+# 在文件首部引入包
+import cn2an
+
+# 查看当前版本号
+print(cn2an.__version__)
+# 0.5.19
+```
+
+### 3.1 `中文数字` => `阿拉伯数字`
+
+> 最大支持到 `10**16`,即 `千万亿`,最小支持到 `10**-16`。
+
+```python
+import cn2an
+
+# 在 strict 模式(默认)下,只有严格符合数字拼写的才可以进行转化
+output = cn2an.cn2an("一百二十三")
+# 或者
+output = cn2an.cn2an("一百二十三", "strict")
+# output:
+# 123
+
+# 在 normal 模式下,可以将 一二三 进行转化
+output = cn2an.cn2an("一二三", "normal")
+# output:
+# 123
+
+# 在 smart 模式下,可以将混合拼写的 1百23 进行转化
+output = cn2an.cn2an("1百23", "smart")
+# output:
+# 123
+
+# 以上三种模式均支持负数
+output = cn2an.cn2an("负一百二十三", "strict")
+# output:
+# -123
+
+# 以上三种模式均支持小数
+output = cn2an.cn2an("一点二三", "strict")
+# output:
+# 1.23
+```
+
+### 3.2 `阿拉伯数字` => `中文数字`
+
+> 最大支持到`10**16`,即`千万亿`,最小支持到 `10**-16`。
+
+```python
+import cn2an
+
+# 在 low 模式(默认)下,数字转化为小写的中文数字
+output = cn2an.an2cn("123")
+# 或者
+output = cn2an.an2cn("123", "low")
+# output:
+# 一百二十三
+
+# 在 up 模式下,数字转化为大写的中文数字
+output = cn2an.an2cn("123", "up")
+# output:
+# 壹佰贰拾叁
+
+# 在 rmb 模式下,数字转化为人民币专用的描述
+output = cn2an.an2cn("123", "rmb")
+# output:
+# 壹佰贰拾叁元整
+
+# 以上三种模式均支持负数
+output = cn2an.an2cn("-123", "low")
+# output:
+# 负一百二十三
+
+# 以上三种模式均支持小数
+output = cn2an.an2cn("1.23", "low")
+# output:
+# 一点二三
+```
+
+### 3.3 句子转化
+
+> ⚠️:试验性功能,可能会造成不符合期望的转化。
+
+```python
+import cn2an
+
+# 在 cn2an 方法(默认)下,可以将句子中的中文数字转成阿拉伯数字
+output = cn2an.transform("小王捡了一百块钱")
+# 或者
+output = cn2an.transform("小王捡了一百块钱", "cn2an")
+# output:
+# 小王捡了100块钱
+
+# 在 an2cn 方法下,可以将句子中的中文数字转成阿拉伯数字
+output = cn2an.transform("小王捡了100块钱", "an2cn")
+# output:
+# 小王捡了一百块钱
+
+
+## 支持日期
+output = cn2an.transform("小王的生日是二零零一年三月四日", "cn2an")
+# output:
+# 小王的生日是2001年3月4日
+
+output = cn2an.transform("小王的生日是2001年3月4日", "an2cn")
+# output:
+# 小王的生日是二零零一年三月四日
+
+## 支持分数
+output = cn2an.transform("抛出去的硬币为正面的概率是二分之一", "cn2an")
+# output:
+# 抛出去的硬币为正面的概率是1/2
+
+output = cn2an.transform("抛出去的硬币为正面的概率是1/2", "an2cn")
+# output:
+# 抛出去的硬币为正面的概率是二分之一
+
+## 支持百分比
+## 支持摄氏度
+```
+
+### 3.4 HTTP API
+
+主要为其他语言(Java、Javascript、Go等)用户提供方便,当然 Python 用户也可以使用,点击查看[详细用法](https://github.com/Ailln/cn2an/wiki/API#http-api)。
+
+## 4 版本支持
+
+- 理论上支持 `Windows`、`MacOS`、`Ubuntu` 下的所有 `Python 3.6+` 的版本。
+- 实际上仅在 `ubuntu-latest`、`windows-latest`、`macOS-latest` 的 `Python 3.6, 3.7, 3.8` 上做过完整测试。
+- 欢迎提交其他版本使用情况到 [Issues](https://github.com/Ailln/cn2an/issues) 中,期待你的反馈。
+- 如果你有 `Python 2` 的使用需求,可 Fork 代码自行修改。当然也欢迎提 PR,贡献自己代码给其他人。
+
+## 5 问题反馈
+
+1. 先搜索 [Issues](https://github.com/Ailln/cn2an/issues) 中有没有人已经问过类似的问题;
+2. 如果没有找到解答,请新开一个 issue:
+ 1. 首先,在「issue 标题」中填写你遇到的问题的简介;
+ 2. 然后,在「issue 详情」中填写你遇到的问题的详情;
+ 3. 最后,不要忘记注明你使用的操作系统(比如 Windows 10)和 Python 版本(比如 Python 3.6.3)。
+3. 还可以参考 [Issue Template](https://github.com/Ailln/cn2an/tree/master/.github/ISSUE_TEMPLATE) 。
+
+## 6 开发相关
+
+### 6.1 开发进度
+
+本项目是用看板管理开发进度,请点击 [v0.5](https://github.com/Ailln/cn2an/projects/4) 查看开发进度和计划事项。
+
+### 6.2 代码测试
+
+本地测试使用 [Anaconda](https://www.anaconda.com/) 的虚拟环境,测试方法如下:
+
+```bash
+# 执行测试
+bash scripts/local_test.sh
+```
+
+线上测试使用 [GitHub Actions](https://github.com/Ailln/cn2an/actions) 。
+
+### 6.3 性能测试
+
+- 测试版本:`v0.5.1`
+- 测试设备:`2.3 GHz 双核Intel Core i5 MacBook Pro`
+- 测试代码:[performance.py](https://github.com/Ailln/cn2an/tree/master/cn2an/performance.py)
+- 测试方法:
+
+ ```bash
+ pip install -r requirements_test.txt
+
+ python -m cn2an.performance
+ ```
+
+- 测试结果:
+
+ | 序号 | 功能 | 执行次数 | 执行时间(万次平均) | 性能(次/秒)
+ | :-: | :-: | :-: | :-: | :-: |
+ | 1 | an2cn | 10000 | 0.15 | **67k** |
+ | 2 | cn2an | 10000 | 0.35 | **29k** |
+
+测试时,我使用的是最大长度的测试数据!因此,大多数情况下该库的性能会更好~
+
+## 7 许可证
+
+[![](https://award.dovolopor.com?lt=License&rt=MIT&rbc=green)](./LICENSE)
+[![](https://award.dovolopor.com?lt=Ailln's&rt=idea&lbc=lightgray&rbc=red&ltc=red)](https://github.com/Ailln/award)
+
+## 8 交流
+
+欢迎添加微信号:`Ailln_`,备注「cn2an」,邀请你进入 Python 交流群。
+
+## 9 致谢
+
+- [Thunder Bouble](https://github.com/sfyc23): 提出很多有效的反馈,包括一些 bug 和新功能;
+- [Damon Yu](https://github.com/20071313): 增加对全角数字和全角符号的支持。
+
+## 10 参考
+
+- [🎈 cn2an 核心代码解析](https://www.v2ai.cn/2020/06/30/python/8-cn2an/)
+- [如何发布自己的包到 pypi](https://www.v2ai.cn/2018/07/30/python/1-pypi/)
+- [Python 中的小陷阱](https://www.v2ai.cn/2019/01/01/python/4-python-trap/)
+- [汉字数字转阿拉伯数字](https://www.zouyesheng.com/han-number-convert.html)
+- [Chinese Text Normalization for Speech Processing](https://github.com/speechio/chinese_text_normalization)
+- [The Best Tool of Chinese Number to Digits](https://github.com/Wall-ee/chinese2digits)
+- [Microsoft Recognizers Text Overview](https://github.com/microsoft/Recognizers-Text)
+- [process: 数据预处理管道](https://github.com/Ailln/proces)
+
+
+
+%prep
+%autosetup -n cn2an-0.5.19
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+ find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+ find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+ find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+ find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+ find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-cn2an -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.19-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..d75d194
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+695663c5ced34c853f9e2abb418bb994 cn2an-0.5.19.tar.gz