# Simple Math Utils

一个简单的数学工具库，提供基本的数学运算功能。

## 功能特点

- 提供基本的数学运算：加法、减法、乘法、除法
- 内置类型提示支持
- 详细的文档和示例
- 完整的测试覆盖
- 健壮的错误处理和日志记录

## 安装

使用pip安装：

```bash
pip install dongjak-math-utils
```

## 使用方法

### 基本用法

```python
from simple_math_utils import add, subtract, multiply, divide

# 基本运算
result = add(10, 5)      # 15
result = subtract(10, 5)  # 5
result = multiply(10, 5)  # 50
result = divide(10, 5)    # 2.0

# 支持浮点数
result = add(3.14, 2.71)  # 5.85
```

### 高级用法

```python
# 链式操作
result = divide(multiply(add(10, 5), subtract(8, 3)), 2)
# 等同于 ((10 + 5) * (8 - 3)) / 2 = 37.5
```

## 开发

### 环境设置

1. 克隆仓库
2. 创建并激活虚拟环境
3. 安装开发依赖

```bash
git clone https://github.com/yourusername/dongjak-math-utils.git
cd dongjak-math-utils
python -m venv .venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # Linux/Mac
pip install -e ".[dev]"
```

### 运行测试

```bash
pytest
```

## 许可证

MIT

## 项目结构

```
dongjak_math_utils/
├── dongjak_math_utils/       # 主库目录
│   ├── __init__.py          # 导出公共API
│   ├── core.py              # 核心功能
├── tests/                   # 测试目录
│   └── test_core.py         # 核心功能测试
└── examples/                # 示例目录
    └── basic_usage.py       # 基本用法示例
```