Block a user
simple-calculator (0.3.1)
Published 2025-10-11 07:08:25 +00:00 by gitea_admin
Installation
pip install --index-url About this package
一个简单的Python计算器库，提供基本的数学运算功能
Simple Calculator
一个简洁的 Python 计算器库，提供基本的数学运算功能。
✨ 特性
- 基本运算：加、减、乘、除
- 高级运算：幂运算、平方根
- 错误处理：完善的异常处理机制
- 轻量级：无外部依赖，纯 Python 实现
- 类型安全：完整的类型提示支持
- 测试覆盖：全面的单元测试覆盖
🚀 安装
pip install simple-calculator
或从源码安装：
git clone https://git.dev.maimaiag.com/gitea_admin/simple-calculator.git
cd simple-calculator
pip install -e .
📖 使用示例
基本用法
from simple_calculator import Calculator
# 创建计算器实例
calc = Calculator()
# 基本运算
result = calc.add(10, 5) # 15
result = calc.subtract(10, 5) # 5
result = calc.multiply(10, 5) # 50
result = calc.divide(10, 5) # 2.0
result = calc.power(10, 5) # 100000
result = calc.sqrt(100) # 10.0
print(f"加法: {calc.add(10, 5)}") # 输出: 加法: 15
print(f"减法: {calc.subtract(10, 5)}") # 输出: 减法: 5
print(f"乘法: {calc.multiply(10, 5)}") # 输出: 乘法: 50
print(f"除法: {calc.divide(10, 5)}") # 输出: 除法: 2.0
print(f"幂运算: {calc.power(2, 8)}") # 输出: 幂运算: 256
print(f"平方根: {calc.sqrt(16)}") # 输出: 平方根: 4.0
错误处理
from simple_calculator import Calculator
calc = Calculator()
try:
# 除零错误
calc.divide(10, 0)
except ValueError as e:
print(f"错误: {e}") # 输出: 错误: 除数不能为零
try:
# 负数平方根
calc.sqrt(-4)
except ValueError as e:
print(f"错误: {e}") # 输出: 错误: 不能计算负数的平方根
🛠️ 开发
本项目使用 uv 进行包管理和开发。
环境设置
# 克隆仓库
git clone https://git.dev.maimaiag.com/gitea_admin/simple-calculator.git
cd simple-calculator
# 安装开发依赖
uv sync --dev
# 激活虚拟环境
source .venv/bin/activate # Linux/macOS
# 或
.venv\Scripts\activate # Windows
可用命令
# 查看所有可用命令
just --list
# 版本管理
just version # 显示当前版本
just changelog # 生成版本改动日志
just bump-patch # 补丁版本升级
just bump-minor # 次版本升级
just bump-major # 主版本升级
# 代码质量
just lint-check # 代码检查
just lint-fix # 代码格式化
just quality # 完整代码质量检查
# 测试
just test # 运行测试
just test-cov # 测试并显示覆盖率
just test-html # 生成HTML测试报告
# 构建
just build # 构建Python包
just deploy # 完整部署流程
# 运行示例
just demo # 运行演示程序
代码质量工具
- 代码格式化：ruff
- 类型检查：mypy
- 测试：pytest
- 覆盖率：pytest-cov
- 版本管理：bump-my-version
运行示例程序
# 运行内置演示
just demo
# 或直接运行
uv run main.py
📊 项目结构
simple-calculator/
├── simple_calculator/ # 主包目录
│ ├── __init__.py # 包初始化和版本信息
│ └── calculator.py # 计算器实现
├── scripts/ # 脚本目录
│ ├── changelog.sh # 版本改动日志生成
│ └── bump-with-changelog.sh # 版本升级脚本
├── tests/ # 测试目录
│ ├── __init__.py
│ └── test_calculator.py
├── docs/ # 文档目录
├── justfile # 任务运行器配置
├── pyproject.toml # 项目配置
├── README.md # 项目说明
└── LICENSE # 许可证文件
🤝 贡献
欢迎贡献代码！请遵循以下步骤：
- Fork 项目
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
代码规范
- 使用 ruff 进行代码格式化
- 确保所有测试通过
- 添加适当的类型提示
- 遵循 PEP 8 规范
📝 更新日志
v0.3.0 (最新)
- 🔄 重构项目结构和配置
- 🛠️ 添加完整的版本管理工具链
- 📦 清理和优化项目依赖
- 📊 添加版本升级时的改动通知功能
- 🧪 完善测试框架和代码质量工具
v0.2.x
- ✨ 添加版本自动管理功能
- 🔧 集成代码质量检查工具
- 📝 改进项目文档
v0.1.x
- 🎉 初始版本发布
- ✅ 实现基本数学运算功能
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🔗 相关链接
- 仓库地址: https://git.dev.maimaiag.com/gitea_admin/simple-calculator
- 问题反馈: https://git.dev.maimaiag.com/gitea_admin/simple-calculator/issues
- 包主页: https://git.dev.maimaiag.com/gitea_admin/simple-calculator
💡 使用建议
- 对于复杂的数学计算，建议结合 Python 内置的
math模块使用 - 如需更多高级功能，可以考虑扩展
Calculator类 - 在生产环境中使用时，建议添加适当的错误处理逻辑
Simple Calculator - 让数学计算更简单！ 🧮✨
Requirements
Requires Python: >=3.8
Details
Assets (1)
Versions (8)
View all