standardform-rs

Effortlessly operate on numbers like 2e19 or 2*10^4 and more with this Rust implementation of standard form. Simplify, convert, and manipulate large numerical expressions with ease.

Features

• Create and manipulate numbers in standard form.
• Perform arithmetic operations on numbers with different exponents.
• Easily compare numbers in standard form.
• Clone and debug derive implementations for StandardForm struct.
• Integrate it with num_traits crate as well.
• no-std available as well.
• Bindings to other languages available (enable 'lang name'` feature to use bindings).

Usage

Add this library to your Cargo.toml:

[dependencies]
standardform = "0.2.1" # Version  

To enable intergation it with nom , enable nom feature:

[dependencies]
standardform = { version = "0.2.1" , features = ["nom"] }

Then

use standardform::StandardForm;

// Create a new StandardForm instance
let number = StandardForm::new(2.0, 19);

// Perform arithmetic operations
let result = number * StandardForm::new(1.5, -3);

// Compare numbers
if result > StandardForm::new(1.0, 10) {
    println!("Result is greater than 1*10^108.");
}

Please note that the examples provided here are simplified and serve as a starting point. For comprehensive documentation of the crate, please visit the crate documentation for a better understanding of the crate's functionalities and APIs. Additionally, you can explore a website showcasing a subset of its features.

Python Integration

For seamless integration between Rust and Python use the following command to install the library with python bindings

pip install standardform

For Developement

Use the following commands

python -m venv .venv 
source .venv/bin/activate
pip install maturin
pip freeze
maturin develop --features python

JavaScript Integration

For seamless integration between Rust and JavaScript, this library supports WebAssembly (Wasm). Follow these steps to update bindings when the Rust code changes:

1. Ensure you have wasm-pack installed:

   cargo install wasm-pack
   

2. Build the Wasm package:

   wasm-pack build --target web --out-dir ./website
   

3. If you make changes to your Rust code, rebuild the Wasm package to update the bindings

This ensures that your JavaScript bindings stay synchronized with any changes made to your Rust code. Remember to update the bindings whenever you modify your Rust implementation to maintain a consistent integration between the two languages.

Pre-Made

If you prefer not to build the JavaScript bindings yourself, you can download a pre-built version of the pkg directory from the releases page. Follow these instructions to use the pre-built 'js' bindings:

1. Download the pre-built pkg directory from the releases page.

2. Extract the contents of the downloaded archive.

3. Ensure your HTML file references the pre-built JavaScript file. Add the following script tag to your HTML file:

   <script type="module">
       import init , { StandardForm } from '/path-to-pkg/standardform.js';
   
       await init()
   </script>
   

   Replace '/path-to-pkg/standardform.js' with the correct path to the downloaded 'standardform.js' file.

4. Your library is now ready to be used in your JavaScript code.

In case you are using webpack , follow this guide

Here are the guides to use this code with different methods of deployment and integration

Note: While using pre-built bindings is convenient, it's recommended to build the bindings yourself if you plan on making changes to the Rust code, as explained below

Contributing

Contributions are welcome! If you find a bug or have an enhancement in mind, feel free to open an issue or submit a pull request.