abacus

Parses and evaluates mathematical expressions in Elixir. Inspired by math.js

Monthly Downloads: 15,005

Programming language: Elixir

License: MIT License

Tags: Text And Numbers    

README

Abacus

A parser for mathematical expressions.

https://hex.pm/packages/abacus

Usage

Abacus.eval(expression, scope)

Parses and evaluates the given expression. Variables can be supplied as a map of binaries in the scope.

Examples

iex> Abacus.eval("1 + 1")
{:ok, 2}
iex> Abacus.eval("sin(floor(3 + 2.5)) / 3")
{:ok, -0.3196414248877128}
iex> Abacus.eval("a * b", %{"a" => 10, "b" => 10})
{:ok, 100}

Abacus.parse(expression)

Parses the expression and returns the syntax tree.

Features

An incomplete list of supported and planned features

• [x] basic operators (+, -, *, /, ^)
• [x] factorial (!)
• [x] bitwise operators (|, &, >>, <<, ~, |^ (xor))
• [x] support for functions
  • [x] trigonometric functions(sin, cos, tan)
  • [x] floating point manipulation(ceil, floor, round)
• [x] support for variables
• [ ] support for parsing units
• [ ] support for converting units

Installation

1. Add abacus to your list of dependencies in mix.exs:

   def deps do
     [{:abacus, "~> 0.4.2"}]
   end
   

2. Ensure abacus is started before your application:

   def application do
     [applications: [:abacus]]
   end