Function copy

packages/hardhat-utils/src/fs.ts:872–908

(source: string, destination: string)

 * @throws FileSystemAccessError for any other error.
 */
export async function copy(source: string, destination: string): Promise<void> {
  // We must proactively check if the source is a directory.
  // On modern Linux kernels (6.x+), the `copy_file_range` system call used by
  // Node.js may return success (0 bytes copied) when the source is a directory
  // instead of throwing EISDIR. Node.js interprets this 0-byte success as a
  // completed operation, resulting in no error being thrown.
  if (await isDirectory(source)) {
    throw new IsDirectoryError(source, undefined);
  }

  try {
    await fsPromises.copyFile(source, destination);
  } catch (e) {
    ensureNodeErrnoExceptionError(e);
    if (e.code === "ENOENT") {
      if (!(await exists(source))) {
        throw new FileNotFoundError(source, e);
      }
      if (!(await exists(destination))) {
        throw new FileNotFoundError(destination, e);
      }
    }

    // On linux, trying to copy a directory will throw EISDIR,
    // on Windows it will throw EPERM, and on macOS it will throw ENOTSUP.
    if (e.code === "EISDIR" || e.code === "EPERM" || e.code === "ENOTSUP") {
      if (await isDirectory(source)) {
        throw new IsDirectoryError(source, e);
      }
      if (await isDirectory(destination)) {
        throw new IsDirectoryError(destination, e);
      }
    }

    throw new FileSystemAccessError(e.message, e);
  }
}

/**
 * Moves a file or directory from a source to a destination. If the source is a