aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
blob: f8de6cc8f986c79c24d6e111f7fd6dc04282e9d7 (plain) (blame)
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
# Contributing to Diplonat 

## Development guidelines

### Code formatting 

[Our CI pipeline](./.drone.yml) features a verification of the code format, using [rustfmt](https://github.com/rust-lang/rustfmt).

#### Installing rustfmt

You can run `rustfmt` with Rust 1.24 and above.

To install: 

```
rustup component add rustfmt
```

#### Usage 

To run on Diplonat, launch the following in the root directory:

```
cargo fmt --all
``` 

This will format the whole repository using the settigs defined in [`.rustfmt.toml`](./.rustfmt.toml): soft tabs of 2 spaces.

#### Auto-format code

You can automate formatting in a number of ways:

* [Setup your IDE to use `rustfmt`](https://github.com/rust-lang/rustfmt#running-rustfmt-from-your-editor).
* Setup a git hook to run `rustfmt` before each commit.