Skip to content

Commit dfd64ef

Browse files
committed
Create CALCULATOR.md
1 parent b2c1d6d commit dfd64ef

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Calculator
2+
3+
A powerful and safe mathematical expression evaluator with a rich web interface.
4+
5+
## Features
6+
7+
### 🖥️ UX Friendly Interface
8+
Experience a clean, modern interface designed for efficiency. The UI is fully responsive and supports dark mode, seamlessly integrating with the rest of the application.
9+
10+
### 💾 Persistent History
11+
Never lose track of your calculations. The Calculator automatically saves your history to `localStorage`, ensuring your previous expressions and results are preserved between sessions.
12+
13+
### ⚡ 1-Click Interaction
14+
Streamline your workflow with interactive history items:
15+
- **Load & Copy**: Click on any past expression or answer to instantly load it into the input field and copy it to your clipboard.
16+
- **Visual Feedback**: Temporary checkmarks confirm successful copy actions.
17+
18+
### ⌨️ Keyboard-Free Access
19+
While full keyboard support is available, you can perform complex calculations entirely via the UI:
20+
- **Numbers & Constants**: Quick access to digits and mathematical constants like `pi`, `e`, `inf`.
21+
- **Operators**: Comprehensive set of buttons for arithmetic (`+`, `-`, `*`, `/`, `%`, `^`) and boolean logic (`and`, `or`, `not`).
22+
- **Functions**: One-click insertion or wrapping of selection for all supported math functions.
23+
24+
### 🐍 Python Math Support
25+
Unlock the power of Python's math library directly in the browser.
26+
- **Math Functions**: Support for `sin`, `cos`, `tan`, `sqrt`, `log`, `factorial`, and many more.
27+
- **Statistics**: Built-in functions for `mean`, `median`, `stdev`, and `variance`.
28+
29+
### 🛡️ Safe Evaluation
30+
Security is a priority. Instead of using Python's unsafe `eval()`, the Calculator uses a robust **AST (Abstract Syntax Tree) evaluator**.
31+
- **Restricted Environment**: Only allowed mathematical operations and functions are executed.
32+
- **No Side Effects**: Prevents arbitrary code execution, making it safe to evaluate expressions from untrusted sources.

0 commit comments

Comments
 (0)