version: 1.1.5 date: 2020-07-27 authors: Luciano Bestia
Lines of code for Rust projects
Lines of code are not a "perfect" measurement of anything.\ Anybody can write a very big number of lines of useless code and comments.\ But for 95% of the cases they are good enough.\ Most of the developers use some "standard" coding practices and that is quantifiable and comparable.
The src_code_lines is the most important count.\
That is actual code written for that project without doc comments, comments, unit tests, integration tests and examples.\
Sometimes is great to see a big number here. It means there was a lot of work invested. But other times we want to see a small number. It means the developer understands the problem very well and don't try to solve anything outside that scope.
The src_doc_comment_lines counts doc comments. They will eventually become docs. The count of lines shows how many documentation is written.
The src_comment_lines counts code comments. Code comments are important to understand the code. The count of lines shows how understandable is the code.
The tests_lines counts lines in tests and shows how good is the code tested. Here are the unit tests and integration test combined.
The examples_lines counts lines in examples and shows how good is explained how to use the code.
The folder structure of a single Rust project is simple.\ The project starts in the folder that contains cargo.toml.\ The /src/ folder contains all the rust *.rs files.\ The /tests/ folder contains integration tests.\ The /examples/ folder contains examples.\ Inside a rs file the doc comment line start with /// or //!.\ The normal comments start with // or /!.\ I will ignore the block comments. They are usually NOT used for comments, but to temporarily disable a piece of code. So I count this as code and not comments.
The src/*.rs file can contain unit tests that start with #[cfg(test)]. I assume that these are always at the end of the file. There should not be any normal code after #[cfg(test)], only tests.
All other files: md, toml, html, js, ... are not counted.
Workspaces have member projects, that are written in cargo.toml.\ The program counts lines of every project and sums them together.
The output is markdown text for a table and markdown text for shield badges.\ Just copy/paste it into README.md.
cargo install lmake_lines_of_code
Run in the Rust project folder, where cargo.toml is:
lmake_lines_of_code
Documentation:\
https://lucianobestia.github.io/lmake_lines_of_code\
List of prepared make tasks for development: build, run, doc, publish,...\
clear; cargo make
I splitted the project into a lib and bin, so it could be used also as a lib.
Please, spread this info.\
Open source code needs a community effort to express trustworthiness.\
Start with reading the reviews of the crates you use.Example: web.crev.dev/rust-reviews/crate/num-traits/
Than install the CLI cargo-crev. Read the Getting Started guide.
On your Rust project, verify the trustworthiness of all dependencies, including transient dependencies with cargo crev verify\
Write a new review for the crates you trust. Or for the crate versions you think are dangerous.\
Help other developers, inform them and share your opinion.\
Use this webpage to help you: web.crev.dev/rust-reviews/review_new