evar 0.2.0

Modern ergonomic math calculator inspired by eva
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

<!-- markdownlint-disable no-inline-html first-line-heading -->

<div align="center">

![evar.webp](./images/evar.webp)

</div>

# evar

Welcome to evar, a feature-rich CLI calculator REPL!
My goal was to create a modern, ergonomic, and simple calculator.

## Features ✨

- **Basic Math Functions**: Perform essential mathematical operations.

  Supported operators: `+`, `-`, `*`, `/`, `%`, `^`, `!`

  Supported functions:
  - **Trigonometric Functions**: `sin`, `cos`, `tan`, `sec`, `csc`, `cot`
  - **Inverse Trigonometric Functions**: `asin`, `acos`, `atan`
  - **Hyperbolic Functions**: `sinh`, `cosh`, `tanh`
  - **Exponential and Logarithmic Functions**: `sqrt`, `exp`, `exp2`, `ln`, `log2`, `log10`, `log`
  - **Angle Conversion Functions**: `rad`, `deg`
  - **Rounding Functions**: `floor`, `ceil`, `round`
  - **Miscellaneous Functions**: `abs`, `log`, `ntroot`

- **Mathematical Notation**: Write expressions like `2 sin(x)` instead of `2 * sin(x)`.

  ```bash
  > 2sin(2pi/3)
  1.7320508075688774
  > 2 * sin(2 * pi / 3)
  1.7320508075688774
  > sqrt(3)
  1.7320508075688772
  ```

- **Variable & Function Definition**: Define your own variables and functions.

  ```bash
  > let x = 3
  3
  > let y = 10
  10
  > let f(z, w) = z + w
  > f(x, y)
  13
  ```

- **Neat Error Handling**: Easily understand errors.

  ```bash
  > let f(x) = 
  error: found end of input expected expression
    ┌─ <repl>:1:12
    │
  1 │ let f(x) = 
    │ ---------- ^ found end of input expected expression
    │ │          
    │ while parsing this function definition
  ```

- **Persistent History**: Keep a record of your calculations.

- **Realtime Input Highlight**: See your input highlighted as you type.

- **Radian & Degrees Mode**: Switch between radian and degrees mode.

- **And More...**

## Inspiration 💡

evar is inspired by [`eva`](https://github.com/oppiliappan/eva), another CLI calculator written in Rust.

## Installation 🛠️

- crates.io

```bash
cargo install evar
```

- manual

```bash
git clone https://github.com/enklht/evar.git
cd evar
cargo run
```

## Usage 🚀

```
Modern ergonomic math calculator inspired by eva

Usage: evar [OPTIONS]

Options:
  -a, --angle-unit <ANGLE_UNIT>  Angle Unit [default: radian] [possible values: radian,
 degree]
      --no-color                 Disable colored output
  -f, --fix <FIX>                Number of decimal places in output (0-63) [default: No
ne]
  -d, --debug                    Print parsed expression for debug purpose
  -h, --help                     Print help
  -V, --version                  Print version
```

## Contributing 🤝

Contributions are welcome via GitHub.

## License 📜

This project is licensed under the MIT License.