blob: cb7d9a50e696aa825f7f23b33ee1d0df4748fd33 (
plain)
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
# perc
A simple vibe-coded command-line percentage calculator written in Go.
## Installation
```bash
go install codeberg.org/snonux/perc/cmd/perc@latest
```
Or using mage:
```bash
mage install
```
## Usage
`perc` supports various percentage calculation formats and RPN (Reverse Polish Notation) stack calculations.
### Percentage Calculations
#### Calculate X% of Y
```bash
perc 20% of 150
# Output:
# 20.00% of 150.00 = 30.00
# Steps: (20.00 / 100) * 150.00 = 0.20 * 150.00 = 30.00
perc what is 20% of 150
# Output:
# 20.00% of 150.00 = 30.00
# Steps: (20.00 / 100) * 150.00 = 0.20 * 150.00 = 30.00
```
#### Find what percentage X is of Y
```bash
perc 30 is what % of 150
# Output:
# 30.00 is 20.00% of 150.00
# Steps: (30.00 / 150.00) * 100 = 0.20 * 100 = 20.00%
```
#### Find the whole when X is Y% of it
```bash
perc 30 is 20% of what
# Output:
# 30.00 is 20.00% of 150.00
# Steps: (30.00 / 20.00) * 100 = 1.50 * 100 = 150.00
```
### RPN (Reverse Polish Notation) Calculations
RPN (postfix notation) uses a stack-based approach where operators follow their operands. No parentheses needed!
#### Basic Arithmetic
```bash
perc calc 3 4 + # 3 + 4 = 7
# → 7
perc calc 3 4 - # 3 - 4 = -1
# → -1
perc calc 5 6 * # 5 * 6 = 30
# → 30
perc calc 20 4 / # 20 / 4 = 5
# → 5
perc calc 2 3 ^ # 2^3 = 8
# → 8
perc calc 10 3 % # 10 % 3 = 1 (modulo)
# → 1
```
#### Expression Chaining
```bash
perc calc 3 4 + 4 4 - * # (3+4) * (4-4) = 0
# → 0
perc calc 1 2 + 3 * # (1+2) * 3 = 9
# → 9
```
#### Variables
```bash
perc calc x 5 = # Assign x = 5
# → x = 5
perc calc x 5 = x x + # x + x = 10
# → 10
perc calc pi 3.14159 = pi 2 * # 2 * π
# → 6.28318
# Note: Variable assignment only works with calc/rpn subcommand:
# perc calc x 5 = x x + (works)
# perc x 5 = (won't work in bare mode - use "perc calc x 5 =")
```
#### Variable Management
```bash
perc calc vars # List all variables
# x = 5
perc calc name d # Delete variable
# Variable removed
perc calc clear # Clear all variables
# All variables cleared
```
#### Stack Operations
```bash
perc calc 1 2 3 dup # Duplicate top value
# → 1 2 3 3
perc calc 1 2 swap # Swap top two values
# → 2 1
perc calc 1 2 3 pop # Remove top value
# → 1 2
perc calc 1 2 3 show # Show stack without modifying
# → 1 2 3
```
## Building
Using mage:
```bash
mage build
```
Or using go directly:
```bash
go build -o perc ./cmd/perc
```
## Testing
```bash
mage test
```
Or for RPN-specific tests:
```bash
mage testRPN
```
## License
See LICENSE file for details.
|
