Skip to content

A base for me to use as the starting point of my projects written in Rust.

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.md
MIT
LICENSE-MIT.md

hashcatHitman/rust_project_template

Rust Project Template

unsafe forbidden dependency badge CI status CodeQL


This project serves as a base for my projects in Rust. It isn't really meant to be used by others, but you're welcome to use it if you find it helpful. If you decide to use it, it IS licensed under the dual Apache 2.0/MIT licensing.

The CONTRIBUTING.md is also not exactly meant for this project, but if you do want to contribute, that's more than welcome - just bear in mind I'm unlikely to accept contributions that don't make the project more useful for me.

Also, the .cargo folder was included intentionally. It won't be in actual projects. The sections that were commented out were commented out so CI could pass (not that it really matters for a template).

The rest of the information in this README is boilerplate.

Getting Started

You'll need to install Rust and its package manager, Cargo, on your system. Please refer to the official recommended Rust installation method for your system.

You should also have some version of git installed. You can refer to the Git documentation if you need help with that.

Clone the repository and navigate inside it:

git clone https://github.com/hashcatHitman/rust_project_template.git
cd rust_project_template

If you'd like to read the documentation, the recommended way to do so is with:

cargo doc --document-private-items --open

Which will open the documentation in your browser.

To build the project, you can do:

cargo build --profile release --locked

Cargo will download the dependencies and compile the project. It will probably be located at ./target/release/rust_project_template or ./target/release/rust_project_template.exe, depending on your system.

MSRV Policy

Our current Minimum Supported Rust Version (MSRV) is 1.89.

We may increase the patch level of the MSRV on any release.

Otherwise, we will not increase MSRV on PATCH releases, though our dependencies might.

We won't increase MSRV just because we can: we'll only do so when we have a reason. (We don't guarantee that you'll agree with our reasoning; only that it will exist.)

About

A base for me to use as the starting point of my projects written in Rust.

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.md
MIT
LICENSE-MIT.md

Contributing

Security policy

Stars

Watchers

Forks

Languages