Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
nomino
Batch rename utility for developers
How to install
Pre-Compiled
You can download a pre-compiled executable for Linux, MacOS and Windows operating systems, then you should copy that executable to a location from your $PATH env:
You might run chmod +x nomino-linux-64bit or chmod +x nomino-macos-64bit.
Arch Linux
You can use nominoAUR or nomino-binAUR packages to install nomino in Arch Linux.
The nominoAUR package depends on rust package, if you have installed rust using rustup, then use makepkg -dsi to install it by ignoring dependencies.
Build Manually
If you prefer to build nomino manually, or a pre-compiled executable is not provided for your target, then you can build nomino from scratch:
- Install Rust:
curl -sSf https://sh.rustup.rs | sh - Run
cargo install nomino
Usage
)
)
<OUTPUT> Output
Map file format
Output
The output is necessary when using --sort or --regex options.
Regex
The accepted syntax of regex pattern is RE2.
Placeholders
- Placeholders have the format of
{I:P}whereIis the index of captured group andPis the padding of digits with0. For example,{2:3}means the third captured group with a padding of 3, i.e.1is formatted as001. - Indices start from
0, and{0}means the filename. - The index
Icould be dropped, i.e.{}or{:3}. In this case an auto incremental index is used which starts from1. For example,{} {}equals{1} {2}. {and}characters could be escaped using\character, i.e.\\{and\\}in cli.- Padding is only used for positive numbers, e.g. the formatted result of
{:3}for1is001, for-1is-1and foraisa. - If
--sortoption is used, the first index{0}is the filename and the second index{1}or first occurrence of{}is the enumerator index.
Example
Consider the following directory:
)
)
)
)
)
Note that -p flag is used to print the table and -e flag is used to preserve the extension of input.
- Rename files using
regexoption:
| | |
| ) | |
| ) | |
| ) | |
| ) | |
| ) | |
- Rename files using
sortoption:
| | |
| ) | |
| ) | |
| ) | |
| ) | |
| ) | |
| | |
| ) | |
| ) | |
| ) | |
| ) | |
| ) | |
- Rename files using the following
map.jsonfile:
| | |
| ) | |
| ) | |
| ) | |
| ) | |
| ) | |
- Undo renaming files: rename files by creating a map file using
-goption, then use that map file to undo renaming:
| | |
| ) | |
| ) | |
| ) | |
| ) | |
| ) | |
| | |
| | ) |
| | ) |
| | ) |
| | ) |
| | ) |
Benchmark
Please refer to wiki for benchmark results of similar tools.