@oazmi/build-tools
Version:
general deno build tool scripts which I practically use in all of my typescript repos
142 lines (141 loc) • 4.55 kB
JavaScript
// Copyright 2018-2025 the Deno authors. MIT license.
import * as dntShim from "../../../../../_dnt.shims.js";
import { isSubdir } from "./_is_subdir.js";
import { isSamePath } from "./_is_same_path.js";
const EXISTS_ERROR = new dntShim.Deno.errors.AlreadyExists("dest already exists.");
/**
* Asynchronously moves a file or directory (along with its contents).
*
* Requires `--allow-read` and `--allow-write` permissions.
*
* @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
* for more information on Deno's permissions system.
*
* @param src The source file or directory as a string or URL.
* @param dest The destination file or directory as a string or URL.
* @param options Options for the move operation.
* @throws {Deno.errors.AlreadyExists} If `dest` already exists and
* `options.overwrite` is `false`.
* @throws {Deno.errors.NotSupported} If `src` is a sub-directory of `dest`.
*
* @returns A void promise that resolves once the operation completes.
*
* @example Basic usage
* ```ts ignore
* import { move } from "@std/fs/move";
*
* await move("./foo", "./bar");
* ```
*
* This will move the file or directory at `./foo` to `./bar` without
* overwriting.
*
* @example Overwriting
* ```ts ignore
* import { move } from "@std/fs/move";
*
* await move("./foo", "./bar", { overwrite: true });
* ```
*
* This will move the file or directory at `./foo` to `./bar`, overwriting
* `./bar` if it already exists.
*/
export async function move(src, dest, options) {
const { overwrite = false } = options ?? {};
const srcStat = await dntShim.Deno.stat(src);
if (srcStat.isDirectory &&
(isSubdir(src, dest) || isSamePath(src, dest))) {
throw new dntShim.Deno.errors.NotSupported(`Cannot move '${src}' to a subdirectory of itself, '${dest}'.`);
}
if (overwrite) {
if (isSamePath(src, dest))
return;
try {
await dntShim.Deno.remove(dest, { recursive: true });
}
catch (error) {
if (!(error instanceof dntShim.Deno.errors.NotFound)) {
throw error;
}
}
}
else {
try {
await dntShim.Deno.lstat(dest);
return Promise.reject(EXISTS_ERROR);
}
catch {
// Do nothing...
}
}
await dntShim.Deno.rename(src, dest);
}
/**
* Synchronously moves a file or directory (along with its contents).
*
* Requires `--allow-read` and `--allow-write` permissions.
*
* @see {@link https://docs.deno.com/runtime/manual/basics/permissions#file-system-access}
* for more information on Deno's permissions system.
*
* @param src The source file or directory as a string or URL.
* @param dest The destination file or directory as a string or URL.
* @param options Options for the move operation.
* @throws {Deno.errors.AlreadyExists} If `dest` already exists and
* `options.overwrite` is `false`.
* @throws {Deno.errors.NotSupported} If `src` is a sub-directory of `dest`.
*
* @returns A void value that returns once the operation completes.
*
* @example Basic usage
* ```ts ignore
* import { moveSync } from "@std/fs/move";
*
* moveSync("./foo", "./bar");
* ```
*
* This will move the file or directory at `./foo` to `./bar` without
* overwriting.
*
* @example Overwriting
* ```ts ignore
* import { moveSync } from "@std/fs/move";
*
* moveSync("./foo", "./bar", { overwrite: true });
* ```
*
* This will move the file or directory at `./foo` to `./bar`, overwriting
* `./bar` if it already exists.
*/
export function moveSync(src, dest, options) {
const { overwrite = false } = options ?? {};
const srcStat = dntShim.Deno.statSync(src);
if (srcStat.isDirectory &&
(isSubdir(src, dest) || isSamePath(src, dest))) {
throw new dntShim.Deno.errors.NotSupported(`Cannot move '${src}' to a subdirectory of itself, '${dest}'.`);
}
if (overwrite) {
if (isSamePath(src, dest))
return;
try {
dntShim.Deno.removeSync(dest, { recursive: true });
}
catch (error) {
if (!(error instanceof dntShim.Deno.errors.NotFound)) {
throw error;
}
}
}
else {
try {
dntShim.Deno.lstatSync(dest);
throw EXISTS_ERROR;
}
catch (error) {
if (error === EXISTS_ERROR) {
throw error;
}
}
}
dntShim.Deno.renameSync(src, dest);
}