diff options
author | adrien <adrien@luxeylab.net> | 2021-09-11 16:34:03 +0200 |
---|---|---|
committer | adrien <adrien@luxeylab.net> | 2021-09-11 16:34:03 +0200 |
commit | f7200709059c00e74cb25f5d8967d81a834f6bb8 (patch) | |
tree | dab43a23074cbdf41f2ce3740532957f604af779 /CONTRIBUTING.md | |
parent | fa25c54e47decf9f323ba0c614f4d9de106626d5 (diff) | |
download | diplonat-f7200709059c00e74cb25f5d8967d81a834f6bb8.tar.gz diplonat-f7200709059c00e74cb25f5d8967d81a834f6bb8.zip |
added rustfmt: a rustfmt.toml file diescribing syntax (soft tabs of 2 spaces), a CONTRIBUTING.md file to explain how to use rustfmt, a .drone.yml file to add code style checks in CI, 2 lines in README.md to present CONTRIBUTING.md, and applied rustfmt on the source
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r-- | CONTRIBUTING.md | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..f8de6cc --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,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. |