Grace

Image author: Мельк

CLI tool for processing files and strings.

Grace helps you organize your files by converting them to the proper case and clearing out unnecessary characters such as ` ' [ ] and many others.

Grace can also rename strings to the correct case and clear them of unnecessary characters.

Now Grace can renames files, directories and strings into a lot of cases, such as

• Alternating -> tHiS wAy
• Snake -> this_way
• Camel -> thisWay
• Kebab -> this-way
• Dot -> this.way
• Header -> This-Way
• Normal -> this way
• Original -> "this way" (returns the string as it was)
• Pascal -> ThisWay
• Path -> this/way
• Sentence -> This way
• Title -> This Way
• UpperSnake -> THIS_WAY
• WindowsPath -> this\way

How To

How to install Grace

You can download suitable executable from https://github.com/meinbaumm/grace/releases and copy it in some directory that is listed in your PATH (e.g. ~/bin).

You may also use cargo to install grace from crates.io:

cargo install grace-cli

How to build Grace

Grace is written in Rust. You may build it yourself with the help of cargo. Just clone this repository and execute the cargo build command in its main directory:

cargo build --release

How to use grace instead of grace-cli

Grace now has the name grace-cli in crates.io. But I prefer just grace more. To avoid writing grace-cli every time, you can add an alias to your .bashrc or .zshrc file.

If you installed grace with cargo:

bash which grace-cli

Then copy the output and in your .bashrc or .zshrc file write

bash alias grace="~/./.cargo/bin/grace-cli"

Next source file like. And use with pleasure :)

bash source .zshrc

Command overview

Help command

bash grace-cli --help

```plain CLI tool for processing files and strings.

Usage: grace-cli

Commands: recase Recase string, file, or directory of files sanitize Sanitize string of unnecessary characters help Print this message or the help of the given subcommand(s)

Options: -h, --help Print help -V, --version Print version ```

Recase file

bash grace-cli recase file -f example\ file\ \[2023\].pdf -i snake --sanitize

Will recase example file [2023].pdf file into snake case example_file_2023.pdf, removing redundant symbols.

Recase many files

bash grace-cli recase files -d test-dir/ -i camel

Will recase all files in provided directory into camelCase. If you wand recase only files with specific extension, use -f/--formats flag.

bash grace-cli recase files -d test-dir/ -i camel -f "pdf, epub"

If you wand recase directories too, you can write

bash grace-cli recase files -d test-dir/ -i camel -d

Rename files recursively

Grace also can rename files recursively, just provide -r/--recursive flag.

bash grace-cli recase files -d test-dir/ -i camel -r

Will recase all files in provided directories and files in subdirectories.

Unfortunately, recursively renaming directories is not supported now.

Recase directory

bash grace-cli recase dir -f test-dir/ -i snake

Will recase test-dir/ into snake case.

Recase strings

bash grace-cli recase string "Some Long String You Want To Recase Into Sentence" -i sentence

Will return

plain Some long string you want to recase into sentence

Additional projects

1. spider-web-search A tool for web search on your favorite sites.
2. AL CLI tool for open/close your apps and web URLs.