Skip to content

Commit 0814575

Browse files
committed
Readme
1 parent 8d94896 commit 0814575

File tree

3 files changed

+60
-46
lines changed

3 files changed

+60
-46
lines changed

Cargo.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
11
[package]
22
name = "rust_template"
3-
version = "0.1.7"
3+
version = "0.1.0"
44
edition = "2021"
55
description = "Example of Rust GitHub template"
66
repository = "https://github.com/runtime-machines/rust-template"
7-
license = "MIT OR Apache-2.0"
87

98
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
109

README.md

Lines changed: 58 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,64 @@
1-
# Title of the projects
1+
# Rust Repository Template
22

33
[![CI](https://github.com/runtime-machines/rust-template/workflows/CI/badge.svg)](https://github.com/runtime-machines/rust-template/actions)
4-
[![codecov](https://codecov.io/github/runtime-machines/rust-template/branch/main/graph/badge.svg?token=ROR5OUTHJ5)](https://codecov.io/github/runtime-machines/rust-template)
54

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)
4762

4863
## License
4964

0 commit comments

Comments
 (0)