To help you get started, we've collected the most common ways that cp-file is being used within popular public projects.

webtorrent / webtorrent-desktop / test / setup.js View on Github

function copy (pathFrom, pathTo) {
  try {
    cpFile.sync(pathFrom, pathTo)
  } catch (err) {
    // Windows lets us create files and folders under C:\Windows\Temp,
    // but when you try to `copySync` into one of those folders, you get EPERM
    // Ignore for now...
    if (process.platform !== 'win32' || err.code !== 'EPERM') throw err
    console.log('ignoring windows copy EPERM error', err)
  }
}

View more ways to use cp-file

cp-file

Copy a file

Highlights

• Fast by using streams in the async version and fs.copyFileSync() in the synchronous version.
• Resilient by using graceful-fs.
• User-friendly by creating non-existent destination directories for you.
• Can be safe by turning off overwriting.
• Preserves file mode, but not ownership.
• User-friendly errors.

Install

npm install cp-file

Usage

import {copyFile} from 'cp-file';

await copyFile('source/unicorn.png', 'destination/unicorn.png');
console.log('File copied');

API

copyFile(source, destination, options?)

Returns a Promise that resolves when the file is copied.

copyFileSync(source, destination, options?)

source

Type: string

The file you want to copy.

destination

Type: string

Where you want the file copied.

options

Type: object

overwrite

Type: boolean
Default: true

Overwrite existing destination file.

cwd

Type: string
Default: process.cwd()

The working directory to find source files.

The source and destination path are relative to this.

directoryMode

Type: number
Default: 0o777

Permissions for created directories.

It has no effect on Windows.

onProgress

Type: (progress: ProgressData) => void

The given function is called whenever there is measurable progress.

Only available when using the async method.

ProgressData

{
	sourcePath: string,
	destinationPath: string,
	size: number,
	writtenBytes: number,
	percent: number
}

• sourcePath and destinationPath are absolute paths.
• size and writtenBytes are in bytes.
• percent is a value between 0 and 1.

Notes

• For empty files, the onProgress callback function is emitted only once.

import {copyFile} from 'cp-file';

await copyFile(source, destination, {
	onProgress: progress => {
		// …
	}
});

Related

• cpy - Copy files
• cpy-cli - Copy files on the command-line
• move-file - Move a file
• make-dir - Make a directory and its parents if needed