3 releases
0.1.2 | Jul 30, 2024 |
---|---|
0.1.1 | Jul 23, 2024 |
0.1.0 | Jul 23, 2024 |
#290 in Command line utilities
50 downloads per month
18KB
421 lines
cargo-align
A simple tool for aligning text in code.
Installation
cargo install cargo-align
Usage
In the crate you want to align run cargo align
and all files from the workspace root will be aligned.
A specific file/folder can be aligned by passing it as the first argument, ie cargo align -- path/to/file/or/folder
Writing the string align_by stop
anywhere in a file will make the rest of the file be skipped.
Writing the string align_by ""
will have the contents of the following lines aligned, until the first line that doesn't match the quote contents.
The matching aligned lines can be sorted after alignment by writing align_by sort ""
.
The alignment markers are space seperated, align_by "= ;"
will first align by =
, then by ;
, left to right.
Alignment markers are only used once. This means align_by "="
will only align on the first found =
per line, and ignore subsequent ones.
Double quotes can be aligned on using an escaping \
. align_by "\""
Limitations, Rationale, and Current State
This tool has been developed primarilly for my own projects. It currently has just enough features to support my use cases. Issues/pull requests are welcome if you would like to see it support yours.
Currently it is hardcoded to use the workspace path of cargo metadata
for ease of implementation.
I chose the align_by sort ""
syntax since outside of comments and strings it is invalid Rust and TOML syntax, making conflicts with existing code highly unlikely. Since there is no special checks for if the alignment statement is inside a Rust/TOML comment, it will work on any programming language.
It is inspired by the VSCode extention align-by-regex
, though as of now the regex part has been dropped for ease of implementation.
Thanks to the extremely basic implementation I had to add align_by stop
otherwise it's almost impossible to write about/test.
Examples
Unaligned
align_by "= ;"
let a = 111;
let bbb = 2;
Aligned
align_by "= ;"
let a = 111;
let bbb = 2;
More examples can be found in the tests.
Without cargo install
Ensure you have Rust installed.
git clone https://github.com/MeGaGiGaGon/cargo-align.git
cd cargo-align
cargo build --release
In the crate you want to align run path_you_cloned_to/target/release/cargo-align.exe
, or pass in a specific file or folder path_you_cloned_to/target/release/cargo-align.exe target/path
.
License
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~135KB