ariprog 0.1.1

🧮 Need a powerful and simple library to work with arithmetic progressions in Rust? You should definitively try ariprog out!
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

# Ariprog

> 🧮 Need a powerful and simple library to work with arithmetic progressions in Rust? You should definitively try ariprog out!

![GitHub top language](https://img.shields.io/github/languages/top/kauefraga/ariprog)
![ariprog](https://img.shields.io/badge/ariprog-b7410e)
![GitHub's license](https://img.shields.io/github/license/kauefraga/ariprog)
![GitHub last commit (branch)](https://img.shields.io/github/last-commit/kauefraga/ariprog/main)

## Features

Here's a list of what **ariprog** is capable of.

- [x] Solve AP problems with `get_common_difference`, `get_first_term`, `get_nth_term` and `insert_arithmetic_means`.
- [ ] Store an AP (`new`) and solve problems with methods.

In the next section, I'll explain how to install and use it.

## Usage

### Installation

1. Create a new Rust project or open an existing one
2. Add [**ariprog**](https://crates.io/crates/ariprog) as a dependency

```bash
# (1)
cargo new testing-ariprog
cd testing-ariprog

# or
cd existing-project

# (2)
cargo add ariprog
```

See below the latest ariprog version.

![Crates.io Version](https://img.shields.io/crates/v/ariprog)

### Getting started

```rust
use ariprog::{get_common_difference, get_nth_term};

fn main() {
    let common_diff = get_common_difference(6.0, 2.0); // expected 4.0

    println!(
        "The common difference in the AP [2.0, 6.0, 10.0, 14.0] is {}",
        common_diff
    );

    println!(
        "The seventeenth term of the AP [2.0, 6.0, 10.0, 14.0, ...] is {}",
        get_nth_term(2.0, common_diff, 17.0)
    ); // expected 66.0
}
```

### API

Coming soon...

## Contributing

Feel free to fork it, make a change and open a pull request. Same for issues, suggest an API change, an improvement, a feature or report a bug.

### How to contribute

1. Fork this repository
2. Clone your fork on your machine
3. Make your changes, commit and push these
4. Open a pull request (write a descriptive message about what you changed)

### How to run and where to create tests

To test ariprog, with the project in your machine, run `cargo test`.

You should create tests in [`tests/unit_test.rs`](tests/unit_test.rs), however if you think that your tests should be in other module, do it and explain why in the PR.

## License

This project is licensed under the MIT License - See the [LICENSE](https://github.com/kauefraga/ariprog/blob/main/LICENSE) for more information.

---

Made with ❤ and 🦀 by Kauê Fraga Rodrigues.