A powerful, modular calculator engine library written in Python.
Designed to make it easy to add a calculator into another Python application, with the specific features required. Adding custom features is possible.
For syntax and other topics for the default feature set, see the modularcalculator wiki.
- Linux
- Python 3.6+
sudo pip3 install .
sudo pip3 uninstall modularcalculator
Import the ModularCalculator class:
from modularcalculator.modularcalculator import ModularCalculator
You can initialise the object with the name of a preset, which will auto-install all features associated with the preset:
c = ModularCalculator('Advanced')
See what presets are available and their features in features/presets.py.
Otherwise, initialise an empty ModularCalculator and add the features you want, using each feature's id field.
c = ModularCalculator()
c.install_features(['numerical.basicarithmetic', 'numerical.decimalnumbers', 'structure.operators'])
Each feature's dependencies will also be installed automatically. The order of the features doesn't matter, if each feature's dependencies and installation order hints have been defined correctly they will be installed in the correct order. Because installation order matters, it is best to install all your features in one call to install_features().
Then, call calculate() with the expression to be calculated. This returns a response object, containing a list of results. Since this is a single statement, there is only one result here.
In order to convert a value to a string, you need to call .to_string(calculator) on it to use the calculator's rounding options when rendering it.
response = c.calculate('2+3')
print(response.results[0].value.to_string(c))
These examples are available in examples/basic_integration.py. See examples/advanced_integration.py for a guide to adding custom features.