pit-require-cache 🐕

What is pit-require-cache? 🤷‍

pit-require-cache is a zero-configuration watcher that deletes require's cache for any updated file.

Case of use 🖌

Lets say that you are importing trought require a specific file and then serving that file trought a express server, then you update that file and as require cache the files already imported you need to stop the server and start it again. With pit-require-cache is not needed anymore, just instantiate the watcher once and then it will delete the cache for you making the changes appear all straight.

Instalation 🧱

npm install pit-require-cache

Usage 🐶

const { watcher } = require('pit-require-cache')
 
watcher()

Available Options 🧪

 
const options = {
  persistent: true,
 
  ignored: '*.txt',
  ignoreInitial: false,
  followSymlinks: true,
  cwd: '.',
  disableGlobbing: false,
 
  usePolling: true,
  interval: 100,
  binaryInterval: 300,
  alwaysStat: false,
  depth: 99,
  awaitWriteFinish: {
    stabilityThreshold: 2000,
    pollInterval: 100
  },
  ignorePermissionErrors: false,
  atomic: true
}
 
watcher(options)

Main options:

  directory        Directory to be watched           [default: ".", string or array of strings]
 
  persistent       Show version number               [default: true, boolean]
 
  ignored          Ignored files                     [default: '', string, example: '*.txt']
 
  ignoreInitial    Add/addDir events are also        [default: false, boolean]
                   emitted while instantiating
 
  followSymlinks   Watch followinf symbolic links    [default: true, boolean]
 
  cwd              Base directory                    [default: '.', string]
 
  usePolling       Whether to use fs.watchFile or    [default: false, boolean]
                   fs.watchtrue
 
  interval         Interval for polling              [default: 100, number]
 
  binaryInterval   Interval polling for binary files.[default: 300, number]
 
  depth            Limits how many levels of 
                   subdirectories will be traversed. [default: undefined, number]
 
  awaitWriteFinish Wait until the size of the file   [default: undefined, example: {
                   stays constant.                      stabilityThreshold: 2000,
                                                        pollInterval: 100
                                                      }, object]
  ignorePermissionErrors Silence the access errors   [default: false, boolean]

As we are using chokidar module for the watcher implementation, there are a couple more options that can be checked on chokidar's module docs https://www.npmjs.com/package/chokidar/v/2.0.4

Credits ❤️

Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY