@npmcli/fs
filesystem utilities for the npm cli
Last updated 2 years ago by lukekarrys .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ gnpm install @npmcli/fs 
SYNC missed versions from official npm registry.

@npmcli/fs

polyfills, and extensions, of the core fs module.

Features

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

fs.withTempDir(root, fn, options) -> Promise

Parameters

  • 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

Usage

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()

fs.readdirScoped(root) -> Promise

Parameters

  • root: the directory to read

Usage

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

const readdir = require('readdir-scoped-modules')
const entries = await readdir('node_modules')
// entries will be something like: ['a', '@org/foo', '@org/bar']

fs.moveFile(source, dest, options) -> Promise

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

Highlights

  • 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.

Parameters

  • 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).

Usage

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');
})();

Current Tags

  • 3.1.0                                ...           latest (2 years ago)

10 Versions

  • 3.1.0                                ...           2 years ago
  • 3.0.0                                ...           2 years ago
  • 2.1.2                                ...           2 years ago
  • 2.1.1                                ...           2 years ago
  • 2.1.0                                ...           3 years ago
  • 2.0.1                                ...           3 years ago
  • 2.0.0                                ...           3 years ago
  • 1.1.1                                ...           3 years ago
  • 1.1.0 [deprecated]           ...           3 years ago
  • 1.0.0                                ...           3 years ago
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (3)

Copyright 2013 - present © cnpmjs.org | Home |