Skip to content

Commit

Permalink
run markdownlint
Browse files Browse the repository at this point in the history
  • Loading branch information
0xalpharush committed Nov 15, 2023
1 parent 1ab81db commit 17cd609
Showing 1 changed file with 8 additions and 3 deletions.
11 changes: 8 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
`roundme` is a human-assisted rounding analyzer. It helps its operator determine whether an arithmetic operation should round up or down.

## Features

- Recommends whether an arithmetic operation needs to round up or down
- Generates LaTeX-based reports in PDF

Expand All @@ -12,16 +13,16 @@

- `A + B => rounding(A), rounding(B)` (addition does not change the rounding direction)
- `A - B => rounding(A), ! rounding(B)` (the rounding direction of the substracted element is inverse of the expected rounding)
- `A * B => rounding(A), rounding(B), rounding(*) ` (multiplication does not change the rounding direction)
- `A * B => rounding(A), rounding(B), rounding(*)` (multiplication does not change the rounding direction)
- `A / B => rounding(A), ! rounding(B), rounding(/)` (the rounding direction of the denominator is the inverse of the expected rounding)
- `A ** B`
- `If A>=1 => rounding(A), rounding(B)`
- `If A<1 => rounding(A), ! rounding(B)` (if A is below 1, the rounding direction of the exponent is the inverse of the expected rounding)

## How to use

- Run `roundme init` to generate a default configuration file.
- Run `roundme config` to generate user configuration file.
- Run `roundme init` to generate a default configuration file.
- Run `roundme config` to generate user configuration file.
- Run `roundme analyze` to analyze the configuration file
- Run `roundme pdf` to generate a PDF (require `latexmk`)

Expand All @@ -31,12 +32,14 @@ Running `roundme pdf` on the default configuration will generate the following:
### Configuration

`roundme` relies on a configuration file:

```yaml
formula: a * b / c
round_up: true
less_than_one: ["a * b"] # optional
greater_than_one: ["c"] # optional
```
- `formula` contains the formula to be analyze
- `round_up` determines if the result of the formula should round up or down
- `less_than_one` is used for the `**` [rules](#rules) *(raw string comparison and sensible to space)*
Expand All @@ -47,11 +50,13 @@ See the [balancer V2](./examples/balancer/README.md) example.
## Install

Install with

```bash
cargo install roundme
```

To install the latest GitHub version

```bash
git clone git@github.com:crytic/roundme.git
cd roundme
Expand Down

0 comments on commit 17cd609

Please sign in to comment.