1. read-glob
Search files with glob pattern and read them, Observable way
read-glob
Package: read-glob
Created by: shinnn
Last modified: Sun, 26 Jun 2022 09:13:34 GMT
Version: 3.0.0
License: ISC
Downloads: 7,282
Repository: https://github.com/shinnn/node-read-glob

Install

npm install read-glob
yarn add read-glob

read-glob

npm version
Build Status
Build status
Coverage Status

Search files with glob pattern and read them, Observable way

 const readGlob = require('read-glob');

readGlob('src/*.js').subscribe({
  start() {
    console.log('Glob started.');
  },
  next(result) {
    result.cwd; //=> '/Users/shinnn/exmaple'
    result.path; //=> 'src/a.js'
    result.contents; //=> <Buffer ... >
  },
  complete() {
    console.log('Glob completed.');
  }
});

Installation

Use npm.

npm install read-glob

API

 const readGlob = require('read-glob');

readGlob(pattern [, options])

pattern: string (glob pattern)
options: Object (node-glob and fs.readFile options) or string (encoding)
Return: Observable (zenparsing's implementation)

When the Observable is subscribed, it starts to search files matching the given glob pattern, read their contents and successively send results to its Observer.

Results

Each result is the same Object as glob-observable's with the additional contents property, a Buffer or string of the matched file contents.

contents is a string when the encoding option is specified, otherwise it's a Buffer.

 readGlob('hi.txt').subscribe(result => {
  result.contents; //=> <Buffer 48 69>
});

readGlob('hi.txt', 'utf8').subscribe(result => {
  result.contents; //=> 'Hi'
});

readGlob('hi.txt', 'base64').subscribe(result => {
  result.contents; //=> 'SGk='
});

options

The option object will be directly passed to node-glob and fs.readFile, or the encoding string sets the encoding of fs.readFile.

Unlike the original node-glob API,

  • silent and strict options are true by default.
  • nodir and mark options are not supported as it ignores directories by default.
 const readGlob = require('read-glob');

// ./directory/.dot.txt: 'Hello'

readGlob('*.txt', {
  cwd: 'directory',
  dot: true
}).subscribe(({contents}) => {
  contents.toString(); //=> 'Hello'
});

License

ISC License © 2017 - 2018 Shinnosuke Watanabe

RELATED POST

10 Must-Know Windows Shortcuts That Will Save You Time

10 Must-Know Windows Shortcuts That Will Save You Time

Arrays vs Linked Lists: Which is Better for Memory Management in Data Structures?

Arrays vs Linked Lists: Which is Better for Memory Management in Data Structures?

Navigating AWS Networking: Essential Hacks for Smooth Operation

Navigating AWS Networking: Essential Hacks for Smooth Operation

Achieving Stunning Visuals with Unity's Global Illumination

Achieving Stunning Visuals with Unity's Global Illumination

Nim's Hidden Gems: Lesser-known Features for Writing Efficient Code

Nim's Hidden Gems: Lesser-known Features for Writing Efficient Code