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
``bash
regex-replace 'search string' 'replace string' './path/to/recursively/replace'
`

Replace file content only
`bash
regex-replace 'search string' 'replace string' './path/to/recursively/replace' --filecontents
`

Replace filenames only
`bash
regex-replace 'search string' 'replace string' './path/to/recursively/replace' --filenames
`

Version
`bash
regex-replace -v
`

###### Module Example
`javascript
import regexReplace from 'regex-replace';

const searchString = 'string to search for';
const replaceString = 'string to replace with';
const path = './some/path/to/recursively/replace';

const options = {
filenamesOnly: false, //default
fileContentsOnly: false //default
};

//promise
regexReplace(searchString, replaceString, path, options)
.then(() => {
//do something after successful regex replace
})
.catch((err) => {
//handle errors
});

//async/await
const doRegexReplace = async function() {
try {
await regexReplace(searchString, replaceString, path, options);
} catch (err) {
console.error('err > regexReplace > testing', err);
}
}

//callback (no support for callbacks currently)
`

$3

- 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
`javascript
regexReplace(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