Copy files

• Fast by using streams.
• Resilient by using graceful-fs.
• User-friendly by accepting globs and creating non-existant destination directories.
• User-friendly error messages.

$ npm install --save cpy

const cpy = require('cpy');

cpy(['src/*.png', '!src/goat.png'], 'dist').then(() => {
	console.log('files copied');
});

Type: string Array

Files to copy.

Type: string

Destination directory.

Type: Object

Options are passed to cp-file and glob.

Type: string
Default: process.cwd()

Working directory to find source files.

Type: boolean
Default: false

Preserve path structure.

Type: string Function

Filename or function returning a filename used to rename every file in files.

cpy('foo.js', 'destination', {
	rename: basename => `prefix-${basename}`
});

Type: Function

{
	completedFiles: Number,
	totalFiles: Number,
	completedSize: Number
}

• completedSize is in bytes
• percent is a value between 0 and 1

Note that the .on() method is available only right after the initial cpy call, so make sure you add a handler before calling .then():

cpy(src, dst).on('progress', progress => {
	// …
}).then(() => {
	// …
})

• cpy-cli - CLI for this module
• cp-file - Copy a single file
• make-dir - Make a directory and its parents if needed

MIT © Sindre Sorhus