polyfills, and extensions, of the core fs module.

• fs.cp polyfill for node < 16.7.0
• fs.withTempDir added
• fs.readdirScoped added
• fs.moveFile added

• root: the directory in which to create the temporary directory
• fn: a function that will be called with the path to the temporary directory
• options
  • tmpPrefix: a prefix to be used in the generated directory name

The withTempDir function creates a temporary directory, runs the provided function (fn), then removes the temporary directory and resolves or rejects based on the result of fn.

const fs = require('@npmcli/fs')
const os = require('os')
// this function will be called with the full path to the temporary directory
// it is called with `await` behind the scenes, so can be async if desired.
const myFunction = async (tempPath) => {
 return 'done!'
}
const main = async () => {
 const result = await fs.withTempDir(os.tmpdir(), myFunction)
 // result === 'done!'
}
main()

• root: the directory to read

Like fs.readdir but handling @org/module dirs as if they were a single entry.

const { readdirScoped } = require('@npmcli/fs')
const entries = await readdirScoped('node_modules')
// entries will be something like: ['a', '@org/foo', '@org/bar']

A fork of move-file with support for Common JS.

• Promise API.
• Supports moving a file across partitions and devices.
• Optionally prevent overwriting an existing file.
• Creates non-existent destination directories for you.
• Automatically recurses when source is a directory.

• source: File, or directory, you want to move.
• dest: Where you want the file or directory moved.
• options
  • overwrite (boolean, default: true): Overwrite existing destination file(s).

The built-in fs.rename() is just a JavaScript wrapper for the C rename(2) function, which doesn't support moving files across partitions or devices. This module is what you would have expected fs.rename() to be.

const { moveFile } = require('@npmcli/fs');
(async () => {
	await moveFile('source/unicorn.png', 'destination/unicorn.png');
	console.log('The file has been moved');
})();