regex-replace

A simple CLI/Module for regex replacing strings in files & renaming files recursively

Getting Started

This library can be used both locally as a module or globally as a CLI. Simply choose which you'd like via the install command below.

local: npm install regex-replace

global: npm install -g regex-replace

Code Example

CLI Example

Replace filenames and file contents

1regex-replace 'search string' 'replace string' './path/to/recursively/replace'

Replace file content only

1regex-replace 'search string' 'replace string' './path/to/recursively/replace' --filecontents

Replace filenames only

1regex-replace 'search string' 'replace string' './path/to/recursively/replace' --filenames

Version

1regex-replace -v

Module Example

1import regexReplace from 'regex-replace';
2
3const searchString = 'string to search for';
4const replaceString = 'string to replace with';
5const path = './some/path/to/recursively/replace';
6
7const options = {
8    filenamesOnly: false, //default
9    fileContentsOnly: false //default
10};
11
12//promise
13regexReplace(searchString, replaceString, path, options)
14    .then(() => {
15        //do something after successful regex replace
16    })
17    .catch((err) => {
18        //handle errors
19    });
20
21//async/await
22const doRegexReplace = async function() {
23    try {
24        await regexReplace(searchString, replaceString, path, options);
25    } catch (err) {
26        console.error('err > regexReplace > testing', err);
27    }
28}
29
30//callback (no support for callbacks currently)

Prerequisites

• Node JS >= 6.x.x
• Yarn (optional but recommended)

API Reference

CLI Example

• regex-replace searchString replaceString path
• Flags:
  • --filename or --filenames For filenames only
  • --filecontent or --filecontents For file contents only

Module Example

1regexReplace(searchString, replaceString, path, options)

• Returns promise
• Options:
  • filenamesOnly: false default
  • fileContentsOnly: false default

Running the tests

• Fork or clone
• cd into regex-replace
• run yarn or npm install
• npm test

Contributing

Please read CONTRIBUTING.md for details on code of conduct, and the process for submitting pull requests.

Versioning

SemVer is used for versioning. For the versions available, see the releases on this repository.

Authors

• Don Mclean

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT license.

Acknowledgments

• replace
• fs-extra