Add cwd option

index.d.ts

@@ -15,6 +15,15 @@ declare namespace cpFile {
 		@default 0o777
 		*/
 		readonly directoryMode?: number;
+
+		/**
+		Base directory to find the source file and copy it to this directory.
+
+		`cwd` works by being prepended with source, destination path.
+
+		@default process.cwd()
+		*/
+		readonly cwd?: string;
 	}
 
 	interface ProgressData {

index.js

@@ -52,11 +52,25 @@ const cpFileAsync = async (source, destination, options, progressEmitter) => {
 	}
 };
 
-const cpFile = (sourcePath, destinationPath, options) => {
+const resolvePath = (cwd, sourcePath, destinationPath) => {
+	sourcePath = path.resolve(cwd, sourcePath);
+	destinationPath = path.resolve(cwd, destinationPath);
+
+	return {
+		sourcePath,
+		destinationPath
+	};
+};
+
+const cpFile = (sourcePath, destinationPath, options = {}) => {
 	if (!sourcePath || !destinationPath) {
 		return Promise.reject(new CpFileError('`source` and `destination` required'));
 	}
 
+	if (options && options.cwd) {
+		({sourcePath, destinationPath} = resolvePath(options.cwd, sourcePath, destinationPath));
+	}
+
 	options = {
 		overwrite: true,
 		...options
@@ -85,23 +99,27 @@ const checkSourceIsFile = (stat, source) => {
 	}
 };
 
-module.exports.sync = (source, destination, options) => {
-	if (!source || !destination) {
+module.exports.sync = (sourcePath, destinationPath, options = {}) => {
+	if (!sourcePath || !destinationPath) {
 		throw new CpFileError('`source` and `destination` required');
 	}
 
+	if (options && options.cwd) {
+		({sourcePath, destinationPath} = resolvePath(options.cwd, sourcePath, destinationPath));
+	}
+
 	options = {
 		overwrite: true,
 		...options
 	};
 
-	const stat = fs.statSync(source);
-	checkSourceIsFile(stat, source);
-	fs.makeDirSync(path.dirname(destination), {mode: options.directoryMode});
+	const stat = fs.statSync(sourcePath);
+	checkSourceIsFile(stat, sourcePath);
+	fs.makeDirSync(path.dirname(destinationPath), {mode: options.directoryMode});
 
 	const flags = options.overwrite ? null : fsConstants.COPYFILE_EXCL;
 	try {
-		fs.copyFileSync(source, destination, flags);
+		fs.copyFileSync(sourcePath, destinationPath, flags);
 	} catch (error) {
 		if (!options.overwrite && error.code === 'EEXIST') {
 			return;
@@ -110,5 +128,5 @@ module.exports.sync = (source, destination, options) => {
 		throw error;
 	}
 
-	fs.utimesSync(destination, stat.atime, stat.mtime);
+	fs.utimesSync(destinationPath, stat.atime, stat.mtime);
 };

readme.md

@@ -59,6 +59,15 @@ Default: `true`
 
 Overwrite existing destination file.
 
+##### cwd
+
+Type: `string`\
+Default: `process.cwd()`
+
+Base directory when you use relative path to the source, destination paths.
+
+`cp-file` finds the source file from this path, and copy it to this directory.
+
 ##### directoryMode
 
 Type: `number`\

test/async.js

@@ -269,3 +269,12 @@ test.serial('rethrow read after open errors', async t => {
 
 	Object.assign(fs, {createWriteStream, createReadStream});
 });
+
+test('cwd option', async t => {
+	const error = await t.throwsAsync(cpFile('sync.js', t.context.destination));
+
+	t.is(error.name, 'CpFileError');
+	t.is(error.code, 'ENOENT');
+
+	await t.notThrowsAsync(cpFile('sync.js', t.context.destination, {cwd: 'test'}));
+});

test/sync.js

@@ -218,3 +218,16 @@ test('rethrow utimes errors', t => {
 
 	fs.utimesSync.restore();
 });
+
+test('cwd option', t => {
+	const error = t.throws(() => {
+		cpFile.sync('sync.js', t.context.destination);
+	});
+
+	t.is(error.name, 'CpFileError');
+	t.is(error.code, 'ENOENT');
+
+	t.notThrows(() => {
+		cpFile.sync('sync.js', t.context.destination, {cwd: 'test'});
+	});
+});