Álvaro González 1d339653d5 feat: add formula data classes with strict JSON parsing

- Add VariableSpec class with magnitude field validation
- Add Formula class supporting multiple input/output variables
- Support d4rt_code as string or object with code field
- Add comprehensive tests for parsing and serialization
- Fix broken test import in pruebas_d4rt_test.dart

Follows README.md format requirements exactly

2025-08-21 17:15:00 +02:00

2.1 KiB

Raw Blame History

Math Formulae Manager

A comprehensive command-line application for managing and computing mathematical formulas across various disciplines including mathematics, physics, medicine, and engineering.

This project uses dart language, and flutter framework. It leverages d4rt library to execute formulas.

Development guidelines

If you are a contributor or an agent, please follow CLAUDE.md for development guidelines.

Formula file description

The file is a json array of formulas.

[
    {
        "name": "Newton's second law (scalar)",
        "input": {
            "m" : {
               "magnitude": "mass"
            },
            "a" : {
               "magnitude": "acceleration"
            }
        },
        "output": {
            "F" : {
                "magnitude" : "Force"
            }
        },
        "d4rt_code":{
            "return m*a;"
        }
    }

]

Features

Formula Search and Computation

Search through a vast collection of formulas from multiple domains:
- Mathematics
- Physics
- Medical sciences
- Engineering
- And more!
Input values for formula variables
Get computed results with proper units

Unit Management

Each data value includes its magnitude and unit
Convert between different units seamlessly
Automatic unit validation and conversion

Formula Editor

Built-in formula editor using the d4rt interpreter
Create and modify formulas with ease
Syntax highlighting and validation

Share formulas with other users
Import formulas from the community
Collaborative formula database

Rich Formula Documentation

Each formula includes:

The formula itself - Mathematical expression
Explanation - Detailed description in Markdown format
Images - Visual diagrams, graphs, or illustrations
Examples - Sample calculations and use cases

Project Structure

bin/ - Main executable and entry point
lib/ - Core library code and formula engine
test/ - Unit tests and formula validation tests

Getting Started

[Installation and usage instructions to be added]

Contributing

[Contribution guidelines to be added]

2.1 KiB Raw Blame History