Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

lineder

jasonbellamy28MIT0.1.1

Finds and returns information on each line of the file that matches a regular expression,

line, find, search, regex

readme

Lineder Build Status

Finds and returns information on each line of the file that matches a regular expression.

Features

Lineder finds and returns information on each line of the file that matches your search.

  • Search with regular expressions.
  • Get the line number(s) that the matched result was found on.
  • Get the entire line(s) that the matched result was found in.

Getting Started

  • Install with NPM - npm install --save lineder

Usage

var lineder = require( "lineder" );

/* file.txt
   1. this is the text for line one.
   2. this is the text for line two.
   3. this is the text for line three.
*/

lineder( "file.txt", "line two", function( err, results ) {
  //=> [ { line: 2, value "this is the text for line two." } ]
});

API

lineder( path )

Name Type Argument Description
path string <required> the path of the file to be searched.

lineder.find( regex, callback )

Name Type Argument Description
regex `string regex` <required>
callback function <required> callback that returns the results of the search

callback( error, results )

Name Type Argument Description
error error <required> any errors that may have occured.
results array <required> an array of objects containg the line number and values from the results of the search.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.

License

Copyright (c) 2015 Jason Bellamy
Licensed under the MIT license.