4 releases
0.2.1 | Jul 28, 2023 |
---|---|
0.2.0 | Jul 16, 2023 |
0.1.1 | Apr 28, 2023 |
0.1.0 | Apr 28, 2023 |
#490 in Filesystem
39KB
791 lines
bumv, a Bulk File Renaming Utility
bumv
(bulk move) lets you use your favorite editor to rename files.
It was created becuase the author found bulk file renaming very tedious compared to editing strings in modern editors. Editors provide powerful search and replace functionality as well as multi cursor editing, all of which are helpful for bulk file renaming.
Usage
By default, bumv
will let you rename the files in the current directory non-recursively, respecting git ignore definitions and .ignore
files.
Invoked on this project directory, it would open the following list of files in EDITOR
(defaulting to VS Code):
./Cargo.lock
./Cargo.toml
./LICENSE.txt
./README.md
Assume you edit the file as follows, save it and close your editor:
./Cargo.lock
./Cargo.toml
./LICENSE.txt
./README_CAREFULLY.md
bumv
will prompt you for confirmation and then rename README.md
to README_CAREFULLY.md
.
Warning
Race conditions or unforseen edge cases could lead to undesired behavior. Use at your own risk and only on files you have backed up.
Safety checks
The following safety checks are implemented and tested:
- Inputs are only accepted if they have the same number of lines.
- Inputs that will obviously lead to overwriting of files are rejected right away.
- To avoid overwriting existing of files due to race conditions or renaming order,
bumv
verifies before each renaming operation that a file with the target filename does not exist. - Before renaming is performed,
bumv
verifies that the file list presented to the user still exactly matches what is present on the file system.
Notes
- If a part of the parent directory hierarchy of a file is changed when editing the mapping, the file will be moved to the specified location, but empty directories will not be deleted.
- If a renaming would lead to a conflict if done naively, e.g.
file1 <-> file2
, a temporary file will be used to enable the renaming.
Options
-n, --no-ignore Do not observe ignore files
--no-log Do not write a log file
-r, --recursive Recursively rename files in subdirectories
-c, --use-vscode Use VS Code as editor
Installation
cargo install bumv
About This Project
This project was done as a playground for AI-assisted programming. The original code was written by ChatGPT 4 based on a loose specification and surprisingly both compiled and worked right away.
The generated unit tests were insufficient. Thus, the code had to be refactored for testability, and a lot of tests were written by hand.
Several safeguards and improvements had to be added manually based on outcomes of local testing and thinking carefully about program behavior.
GitHub Copilot was very helpful when extending the code and adding comments.
Dependencies
~11–22MB
~320K SLoC