diff --git a/pages/common/repren.md b/pages/common/repren.md new file mode 100644 index 000000000..06a902a4f --- /dev/null +++ b/pages/common/repren.md @@ -0,0 +1,23 @@ +# repren + +> Multi-pattern string replacement and file renaming tool. + +- Do a dry-run renaming a folder of pngs with a literal string replacement: + +`repren --dry-run --rename --literal --from '{{find_string}}' --to '{{replacement_string}}' {{*.png}}` + +- Do a dry-run renaming a folder of jpegs with a regular expression: + +`repren --rename --dry-run --from '{{regular_expression}}' --to '{{replacement_string}}' {{*.jpg}} {{*.jpeg}}` + +- Do a find-and-replace on the contents of a folder of csv files: + +`repren --from '{{([0-9]+) example_string}}' --to '{{replacement_string \1}}' {{*.csv}}` + +- Do both a find-and-replace and a rename operation at the same time, using a pattern file: + +`repren --patterns {{path/to/patfile.ext}} --full {{*.txt}}` + +- Do a case-insensitive rename: + +`repren --rename --insensitive --patterns {{path/to/patfile.ext}} *`