rx-text-search
v1.0.0
Published
Node module for recursive directory search for text in files and obtain results as either RxJS observable or promise
Downloads
9,040
Maintainers
Readme
rx-text-search
Node module for recursive directory search for text in files and obtain results as either RxJS observable or promise
Features
rx-text-search carries out regex searches for text in files and returns matched results.
- Accepts regex search patterns for text search in files.
- Searches files under user provided directory(s) or process directory (process.cwd()).
- Returns results either as a RxJS observable or promise;
Getting Started
Install with NPM - npm install --save rx-text-search
Usage
Getting RxJS observable back
var TextSearch = require('rx-text-search');
// Find .txt files containing "sometext" in test/doc and all its sub-directories
TextSearch.find('sometext', '**/*.txt', {cwd: 'test/doc'})
.subscribe(
function (result) {
// do something with result
},
function (err) {
// handle error
}
);
Getting promise back
var TextSearch = require('rx-text-search');
// Find .txt files containing "sometext" in test/doc and all its sub-directories
TextSearch.findAsPromise('sometext', '**/*.txt', {cwd: 'test/doc'})
.then(function (result) {
// do something with result
})
.catch(function (err) {
// handle error
});
API
TextSearch.find(searchTextPattern, filesPattern, options)
Name | Type | Argument | Description
------------------|------------------|--------------|------------
searchTextPattern | string
/array
| <required>
| Text to be searched. Could be literal or regex pattern. Provide multiple in form of an array of strings.
filesPattern | string
/array
| | Files to be considered for search. String in glob format. Provide multiple in form of an array of strings. Pass null
or undefined
in case you don't want to provide it but need to provide options object. It defaults to '**' (all files) in such case.
options | object
| | It uses node-glob underneath and supports its options. One of the post important options is cwd. If provided, the relative file patterns are interpreted relative to it. You might want to use it most of the times.
Returns a RxJS observable that returns result object in following format -
Name | Type | Description
-----|-----------| ------------
file | string
| file name
line | integer
| line number that the matched result was found on.
term | string
| The search term
text | string
| the entire line(s) that the matched result was found in.
The returned observable emits an error in case of any exception (like invalid arguments or exception while reading file).
TextSearch.findAsPromise(searchTextPattern, filesPattern, options)
The input is same as above.
Returns a promise that is resolved with array of result objects with structure mentioned above. The returned promise is rejected in case any exception (like invalid arguments or exception while reading file).
Contributing
In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.
License
Copyright © 2015 Omkar Patil
Licensed under the MIT license.