Metadata-Version: 2.4
Name: kousuan
Version: 0.1.0
Summary: A Python package for providing mental arithmetic calculation skills
Author-email: liandong <linkwisdom@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/liuliandong/kousuan
Project-URL: Bug Reports, https://github.com/liuliandong/kousuan/issues
Project-URL: Source, https://github.com/liuliandong/kousuan
Keywords: math,mental-arithmetic,calculation,education,kousuan
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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: Topic :: Education
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"

# Kousuan Skill

一个提供口算计算技巧的Python包，帮助提高心算能力和数学计算技巧。

## 功能特性

- 基础四则运算
- 快速加法技巧
- 快速乘法技巧
- 数字分解
- 百分比计算
- 乘法表生成
- 心算技巧集合

## 安装

```bash
pip install kousuan
```

## 使用方法

### 命令行工具

```bash
# 加法
kousuan add 15 27

# 减法
kousuan subtract 50 23

# 乘法
kousuan multiply 12 8

# 除法
kousuan divide 100 4

# 百分比计算
kousuan percentage 200 15

# 快速加法
kousuan qadd 5 10 15 20

# 快速乘法
kousuan qmul 2 3 4 5

# 数字分解
kousuan decompose 84

# 查看心算技巧
kousuan tricks

# 生成乘法表
kousuan table 7
kousuan table 9 --limit 15
```

### Python API

```python
import kousuan as ks

# 基础运算
result = ks.add_numbers(15, 27)
result = ks.multiply_numbers(12, 8)

# 快速计算
numbers = [5, 10, 15, 20]
sum_result = ks.quick_addition(numbers)
product_result = ks.quick_multiplication(numbers)

# 数字分解
factors = ks.number_decomposition(84)

# 获取心算技巧
tricks = ks.mental_math_tricks()

# 生成乘法表
table = ks.get_multiplication_table(7)
```

## 心算技巧

本包包含多种心算技巧，包括：

- **乘以11的技巧**：两位数乘以11时，将两个数字相加，结果放在中间
- **乘以5的技巧**：乘以10再除以2
- **乘以9的技巧**：乘以10再减去原数
- **以5结尾的数字平方**：将前一位数字乘以(前一位数字+1)，后面加上25
- **百分比计算**：计算10%时，将小数点左移一位

## 开发

### 安装开发依赖

```bash
pip install -e .[dev]
```

### 运行测试

```bash
pytest
```

### 代码格式化

```bash
black kousuan/
flake8 kousuan/
```

## 许可证

MIT License

## 作者

liandong
