filesystem utilities for the npm cli
npm install @npmcli/fspolyfills, and extensions, of the core fs module.
- fs.cp polyfill for node < 16.7.0
- fs.withTempDir added
- fs.readdirScoped added
- fs.moveFile added
fs.withTempDir(root, fn, options) -> Promise- 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.
``js
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.
`javascript`
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'tfs.rename()
support moving files across partitions or devices. This module is what you
would have expected to be.
`js
const { moveFile } = require('@npmcli/fs');
(async () => {
await moveFile('source/unicorn.png', 'destination/unicorn.png');
console.log('The file has been moved');
})();
``