|
1 | | -# Title of the projects |
| 1 | +# Rust Repository Template |
2 | 2 |
|
3 | 3 | [](https://github.com/runtime-machines/rust-template/actions) |
4 | | -[](https://codecov.io/github/runtime-machines/rust-template) |
5 | 4 |
|
6 | | -## Description and scope of the project |
7 | | - |
8 | | -Use this repository as a production ready starting point for developing bug-free, well formatted, rust projects :) |
9 | | - |
10 | | -### What does this repository do: |
11 | | - |
12 | | -Workflows: |
13 | | - |
14 | | -- CI Workflows: |
15 | | - - Test |
16 | | - - Format check |
17 | | - - Clippy |
18 | | - - Docs |
19 | | - - Publish |
20 | | - - Code coverage report on PR |
21 | | - |
22 | | -- CD Workflows: \ |
23 | | - Release artifacts on Cargo and Github for: |
24 | | - - os: macos-latest |
25 | | - target: x86_64-apple-darwin |
26 | | - - os: ubuntu-latest |
27 | | - target: x86_64-unknown-linux-gnu |
28 | | - - os: windows-latest |
29 | | - target: x86_64-pc-windows-msvc |
30 | | - - os: ubuntu-latest |
31 | | - target: aarch64-unknown-linux-gnu |
32 | | - - os: ubuntu-latest |
33 | | - target: i686-unknown-linux-gnu |
34 | | - |
35 | | -- Security: |
36 | | - - Audit everyday at 00.00 UTC |
37 | | - - dependabot to update dependencies weekly |
38 | | - |
39 | | -Templates: |
40 | | -- Issue Templates |
41 | | -- Pull Request Template |
42 | | - |
43 | | -## Installation |
44 | | - |
45 | | -Click the "Use this template" button in the repo mainpage\ |
46 | | -Change "rust-template" with your repository name everywhere |
| 5 | +⭐ `Star` this repository if you find it valuable and worth maintaining. |
| 6 | + |
| 7 | +👁 `Watch` this repository to get notified about new releases, issues, etc. |
| 8 | + |
| 9 | +## Description |
| 10 | + |
| 11 | +This is a GitHub repository template for a Go application. |
| 12 | +You can use it: |
| 13 | + |
| 14 | +- to create a new repoisitory with automation and environment setup, |
| 15 | +- as reference when improving automation for an existing repository. |
| 16 | + |
| 17 | +It includes: |
| 18 | + |
| 19 | +- continuous integration via [GitHub Actions](https://github.com/features/actions) |
| 20 | + - CI Workflows: |
| 21 | + - Test |
| 22 | + - Format check |
| 23 | + - Clippy |
| 24 | + - Docs |
| 25 | + - Publish |
| 26 | + - Code coverage report on PR |
| 27 | + - CD Workflows (Release artifacts on Cargo and Github): |
| 28 | + - os: macos-latest |
| 29 | + target: x86_64-apple-darwin |
| 30 | + - os: ubuntu-latest |
| 31 | + target: x86_64-unknown-linux-gnu |
| 32 | + - os: windows-latest |
| 33 | + target: x86_64-pc-windows-msvc |
| 34 | + - os: ubuntu-latest |
| 35 | + target: aarch64-unknown-linux-gnu |
| 36 | + - os: ubuntu-latest |
| 37 | + target: i686-unknown-linux-gnu |
| 38 | + - Security: |
| 39 | + - Audit everyday at 00.00 UTC |
| 40 | + - dependabot to update dependencies weekly |
| 41 | +- build automation via [Cargo](https://doc.rust-lang.org/cargo/commands/cargo-build.html), |
| 42 | +- dependency management using [Cargo Modules](https://doc.rust-lang.org/book/ch07-00-managing-growing-projects-with-packages-crates-and-modules.html), |
| 43 | +- code formatting using [rust fmt](https://rust-lang.github.io/rustfmt/), |
| 44 | +- linting with [clippy](https://github.com/rust-lang/rust-clippy), |
| 45 | +- code coverage [HTML report](https://docs.codecov.com/docs) and tests |
| 46 | +- releasing using [Github Release](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) and [Cargo publish](https://doc.rust-lang.org/cargo/commands/cargo-publish.html), |
| 47 | +- dependencies scanning and updating thanks to [Dependabot](https://dependabot.com), |
| 48 | +- security code analysis using [Audit-check](https://github.com/actions-rs/audit-check), |
| 49 | + |
| 50 | + |
| 51 | +## Usage |
| 52 | + |
| 53 | +1. Sign up on [Codecov](https://codecov.io/) and configure |
| 54 | + [Codecov GitHub Application](https://github.com/apps/codecov) for all repositories. |
| 55 | +1. Click the `Use this template` button (alt. clone or download this repository). |
| 56 | +1. Replace all occurrences of `runtime-machines/rust-template` to `your_org/repo_name` in all files. |
| 57 | +1. Update the following files: |
| 58 | + - [CHANGELOG.md](CHANGELOG.md) |
| 59 | + - [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |
| 60 | + - [LICENSE](LICENSE) (when defined) |
| 61 | + - [README.md](README.md) |
47 | 62 |
|
48 | 63 | ## License |
49 | 64 |
|
|
0 commit comments