From f7c37573b21e3a219a01f291ad264e0ade9f2064 Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Fri, 5 May 2023 10:51:40 +0000 Subject: automatic import of python-cn2an --- .gitignore | 1 + python-cn2an.spec | 917 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ sources | 1 + 3 files changed, 919 insertions(+) create mode 100644 python-cn2an.spec create mode 100644 sources 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<c=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<c=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<c=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 - 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 -- cgit v1.2.3