# math_exam

A math exam prepared for my kids who are still in their elementary school.

This project is being built for learning purposes and will be watched and developed in my free time only.

This projects forms a library only. In order to use the full project you'll have three choices:
- Use the full application: [math_test](https://github.com/mj-nehme/math_test)
- Build your own client for the library.
- Use our PoC client [cli](https://github.com/mj-nehme/math_exam/tree/master/cli), which is part of the [math_exam](https://github.com/mj-nehme/math_exam) project.

## Description
The student can choose one exam out of six:
- Addition
- Subtraction
- Multiplication
- Division
- One Variable Equation
- Two Variables Equation

The student has the option to choose the complexity level up to level 10.

An exam is made up of 10 questions, and so a score is calculated out of 10.

An exam can be either solved from the console (`cargo run`) or can be prepared in a pdf file (`cargo run -- pdf`)

## Like to Contribute?
For contributing to this project, please have a look on our [CODE_OF_CONDUCT](https://github.com/mj-nehme/math_exam/blob/master/CODE_OF_CONDUCT.md) and [CONTRIBUTING](https://github.com/mj-nehme/math_exam/blob/master/CONTRIBUTING.md) guidlines.

## NOTE
The [math_exam crate](https://crates.io/crates/math_exam) would be frequently updated on major changes, but the [math_exam github repo](https://github.com/mj-nehme/math_exam) is to be updated on every (even minor) change.