# python-calc

**Repository Path**: jack5261/python-calc

## Basic Information

- **Project Name**: python-calc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python Kalker

一个用 Python 实现的、带 REPL 的科学计算器，整体体验参考了 [Kalker](https://github.com/PaddiM8/kalker)。

这个项目的目标不是逐项复刻原版，而是提供一个开箱即用、无第三方依赖、交互友好的 Kalker 风格实现。

## 特性

- 支持 REPL：`python3 -m kalker`
- 支持表达式：`+ - * / % ^ !`
- 支持隐式乘法和简写：`2sin(pi/2)`、`2xy`、`sqrt9`
- 支持变量和 `ans`
- 支持用户函数：`f(x) = x^2 + 1`
- 支持数值求导：`f'(2)`、`sin'(pi)`
- 支持数值积分：`∫(0, pi, sin(x) dx)` 或 `integral(0, pi, sin(x), x)`
- 支持求和：`sum(1, 5, 2n + 1)` 或 `sum(n, 1, 5, 2n + 1)`
- 支持单变量实数方程求根：`x^2 = 64`
- 支持复数：`1 + 2i`
- 支持脚本执行：`python3 -m kalker examples/demo.kalker`

## 快速开始

### 启动 REPL

```bash
python3 -m kalker
```

示例：

```text
kalker> x = 5
5
kalker> f(x) = x^3 - 2x + 1
kalker> f(3)
22
kalker> f'(2)
10
kalker> ∫(0, pi, sin(x) dx)
2
```

### 单次求值

```bash
python3 -m kalker --eval "2sin(pi/2) + 3!"
```

### 执行脚本

```bash
python3 -m kalker examples/demo.kalker
```

## REPL 命令

- `help`
- `vars`
- `funcs`
- `load <file>`
- `clear` / `reset`
- `exit` / `quit`

## 测试

```bash
python3 -m unittest discover -s tests -v
```

## 当前范围

当前版本优先覆盖 Kalker 常用能力：

- 科学计算
- REPL
- 函数定义
- 单变量数值求导、积分、求和
- 单变量实数方程求根

暂时没有实现完整符号计算、矩阵、单位制以及原版全部语法细节，但当前结构已经比较适合继续扩展。