printfn / fend Goto Github PK

View Code? Open in Web Editor NEW

614.0 10.0 50.0 3.13 MB

Arbitrary-precision unit-aware calculator

Home Page: https://printfn.github.io/fend

License: MIT License

Rust 94.25% Shell 2.41% HTML 0.17% CSS 0.20% JavaScript 0.87% PowerShell 0.49% TypeScript 1.61%

calculator rust units-of-measure hacktoberfest

fend's Introduction

fend

fend is an arbitrary-precision unit-aware calculator.

Unique features:

Arbitrary-precision arithmetic using rational numbers
Full support for complex numbers
D&D-style dice rolls
Variables
Binary, octal, hexadecimal and all other bases between 2 and 36
Keep track of units, with support for SI, US and UK customary and many historical units
Emacs-style CLI shortcuts
Trigonometric functions
Lambda calculus

See the manual for more information.

Web Interface

fend is available on the web at printfn.github.io/fend.

Installation

The easiest way to install fend locally is via your package manager:

Package Manager	Command
Homebrew	`brew install fend`
MacPorts	`sudo port install fend`
AUR (Arch Linux)	`yay -Syu aur/fend-bin`
AOSC OS	`oma install fend`
Xbps (Void Linux)	`xbps-install fend`
Nix	`nix-env -iA nixpkgs.fend`
Cargo	`cargo install fend`
Windows Package Manager	`winget install fend`
Chocolatey	`choco install fend`
Scoop	`scoop install fend`
Pkgx	`pkgx fend`

Alternatively, you can manually download the latest stable binaries here.

Once fend is installed, run fend to start a REPL session:

$ fend
> 1 ft to cm
30.48 cm
>

Packages

Examples

> 5'10" to cm
177.8 cm

> cos (pi/4) + i * (sin (pi/4))
approx. 0.7071067811 + 0.7071067811i

> 0b1001 + 3
0b1100

> 0xffff to decimal
65535

> 100 C to F
210 °F

> temperature = 30 °C
30 °C
> temperature to °F
86 °F

> roll d20
8
> roll 4d6
17

Projects using fend

These are some projects making use of fend:

Feel free to make a pull request to add your own!

License

fend is available under the MIT license. See LICENSE.md for more information.

fend's People

Contributors

Stargazers

Watchers

fend's Issues

Add golden ration constant - φ

Please, consider adding support for the golden ratio constant - phi.
P.S. Thank you for the great tool!

kph is considered equivalent to m s, not m s^-1

Scientific notation in output

Allow configuration of the output format (as done with to exact/20dp/etc) but for scientific notation.

This might be possible already, but I can't figure out how to do this.

We might also allow for other notations, like those mentioned in the above Wikipedia article. I would be willing to put some work into this.

Thank You!

Remove unnecessary parentheses when printing functions

Support unicode symbols like × and −

Missing parentheses for rational numbers with units

0m/s + 1 km/hr => 5/18 m / s, but it should be (5/18) m / s

Collision between fahrenheit (temperature) and farad (capacitance) suffixes

The "F" suffix is used 2 times. Once for fahrenheit and once for farad.

Also the "C" suffix is used two times. Once for celsius and once for coulomb this lead to funny units like

!debug 1 micro farad
1/1000000 farad (= 1 ampere celsius kilogram^-1 meter^-2 second^3) (base 10, auto, simplifiable)

Ambiguous output for large bases and complex numbers

For large bases, 'i' needs to be separated form the main number if it is part of a complex number.

Current behaviour:

> 36#fi i
36#fii

Expected:

> 36#fi i
36#fi i

Mixed fractions parsing is too eager

These should result in errors:

1/1 2/3
(x:2x) 1 1/2
pi 1 1/2

Fix parsing of log10 and log2

Currently these are not handled correctly by the lexer.

Publish artifacts using GitHub actions

Remove GNU-specific parsing and eval code

Incorrect error message for unknown idents in function calls

sqrt(abcdefghi)
> Error: unknown identifier 'x'

Incorrect auto-simplifications between percentages and radians

1% * 5 radian becomes 500%^2

5 radian * 1% becomes 0.05 radians^2

log10 of numbers with cancelled units fails

> log10 (1m / (1m
Error: expected a unitless number
> version
0.1.27

Suggest/autocorrect identifiers with wrong capitalisation

Currently 1KM is an error, but since it's unambiguous it should automatically be treated as 1km.
Ambiguous cases like 1gib should list possible alternatives (i.e. GiB, Gib).

Support cancelling long-running operations with ^C

Currently this kills the entire program.

Feature: `at`-styled time arithmetic operations

Description

I frequently use the Unix at command for scheduling jobs to start during dynamic time windows. Often times, it's important to delay the time windows by grouped time deltas. Could I humbly request help from fend to make this easier in shell scripting? Adding time blocks (like at this website ) would make a big QoL improvement for me.

Does this seem like something that is an appropriate feature request?

Add apple silicon binaries

Incorrect output for recurring digits in senary

6#1 / 7 -> float results in 6#0.0(5), but it should be 6#0.(05).

> 0 + 6#1 / 7 -> 10dp
0.1428571428
> 0 + 6#1 / 6 -> 10dp
0.1666666666
> 6#0 + 6#1 / 7 -> 10dp
6#0.0505050505
> 6#0 + 6#1 / 7 -> float
6#0.0(5)

Use $ in identifiers

I would like to be able to use $ in fend like $200/3 to 2dp to print approx. $66.66.

Support academic lambda function syntax

Example:

(λa.(λb.(λc.(λd.(λe.(λf.((((a λg.(λh.(((b (g (d h))) (g (e h)))))) λg.((c g))) f))))))) λa.(λb.((a (a (a b))))))

Fix `1.550519768*10^-8 to ms/year`

Conversion from ml to oz or vice versa does not work

800 ml to oz
32 oz to ml
Not working.
However, it works for ounce-force as a measure for weight. The fluid-ounce, which is a measure of volume, doesn't work.

Celsius and Fahrenheit

Logs

Add support for logarithms

Units with powers of pi lose precision

kg^(2pi) / kg^(2pi) to 1 results in approx. 1 when it should be exact.

Rethink order of operations (multiplication/division)

Consider the three operators:

multiplication *
division /
function application/implicit multiplication/implicit addition (used in sin pi, 3 kg, (2)(4) or 1 1/2).

Current these are all parsed mostly left-to-right, with mostly the same precedence (and a bunch of special cases).

These calculations are correct and should continue working as they do now:

1 3/8 inches
1/2 kg
3pi/2 radians to degrees
-sin (pi/2)
5 feet 2 inches

These examples don't do what the user might expect:

1 meter / 5 seconds (parsed as (1 meter / 5) * seconds)
sin pi/2 (parsed as (sin pi)/2)

This calculation can't be parsed at all:

3sin 5 (should be equivalent to 3 * (sin 5))

It would be nice to come up with a consistent solution for all these expressions, preferably not involving whitespace.

Avoid printing large fractions with the 'auto' formatter

Currently psi to kPa prints 8896443230521/1290320000000 kPa, which is not very useful.

'degrees C' doesn't do what the user expects

> !debug degrees C
1 degree (degrees, = 2/360 * pi) * °C (= 1 celsius) (base 10, auto)
> !debug °C
1 °C (= 1 celsius) (base 10, auto)

Improve interactive/noninteractive UI

Interactive:

Allow Ctrl+C when waiting for input only when no input has been typed yet
Add to history incrementally
Exit with Ctrl+D
Exit with an error only if the last command caused an error (regardless of its result)
Cancel a slow calculation with Ctrl+C

Noninteractive:

Used if stdin is a file/pipe/other program, or if there are any command-line arguments
Still potentially evaluate stdin
- echo "1+1"|fend => 2
- Maybe echo "1+2"|fend "*2" => 6
Set error code based on result value (0 is falsy)
Don't add to history

Shorthand for feet and inches: e.g. `6'1`

It would be good to support e.g. 6'1 as a shorthand for 6'1"

Allow empty statements and trailing semicolons

Invalid output for `1.(3)i`

This currently outputs 1 i/3 when it should output 4i/3

Allow mixed fractions with units

1 1/2" currently results in a parse error

Date/Time support

Use 'per' in output

7500 per month to per hour should give an answer as per hour instead of hour^-1

Add differentiation

Windows: raw color escape codes are shown in `cmd` on Windows 10 (21H2)

Colors probably need to be disabled by default in this case. Note that colors do display correctly in the new Windows Terminal (both in Powershell and Command Prompt tabs).

Version: 0.1.29

Fix 'exact' formatting for fractions of pi

e.g. 2pi/3 to exact produces approx. 2.094395102393195492 when it should be 2π/3.

Negative compound fractions

-8 1/2 currently returns an error, but it should be parsed as -8.5.

Change precedence for division

5kg/3m should parse as (5kg)/(3m) instead of ((5kg)/3)m. But 2pi/3 radians should be unchanged.

Trigonometry functions

Add support for sin, cos, tan, asin etc.

Support parsing recurring decimals

Lambdas are being evaluated incorrectly

Input: ((λa.(λb.(λc.(λd.(λe.(λf.(((a (λg.(λh.((b (g (d h))) (g (e h)))))) (λg.(c g))) f))))))) (λa.(λb.(a (a (a b))))))

Expected: (λb.(λc.(λd.(λe.(λf.((b ((b ((b (c (d (d (d f))))) (c (e (d (d f)))))) ((b (c (d (e (d f))))) (c (e (e (d f))))))) ((b ((b (c (d (d (e f))))) (c (e (d (e f)))))) ((b (c (d (e (e f))))) (c (e (e (e f))))))))))))

Actual: \b.(\c.(\d.(\e.(\f.((((((a ((\g.(\h.((((b (((g (((d (h))))))))) (((g (((e (h)))))))))))))) ((\g.((c (g))))))) (f)))))))

The issue is probably that fend’s associativity is wrong (lambdas are supposed to be left-assoc while application is meant to be right-assoc).

Probably relates to #76

“b” is a short-hand for “bar” instead of “bit”

e.g. Gib should refer to gibibit.