feat: Path - add linkTo and linkToSync

src/path.test.ts

@@ -435,6 +435,30 @@ Deno.test("symlinkToSync", async () => {
   });
 });
 
+Deno.test("linkTo", async () => {
+  await withTempDir(async () => {
+    const destFile = createPath("temp.txt").writeTextSync("data");
+
+    // async
+    {
+      const hardlinkFile = destFile.parentOrThrow().join("other.txt");
+      await hardlinkFile.linkTo(destFile);
+      const stat = hardlinkFile.statSync();
+      assertEquals(stat!.isFile, true);
+      assertEquals(stat!.isSymlink, false);
+      assert(!hardlinkFile.isSymlinkSync());
+      assertEquals(hardlinkFile.readTextSync(), "data");
+    }
+
+    // sync
+    {
+      const hardlinkFile = destFile.parentOrThrow().join("sync.txt");
+      hardlinkFile.linkToSync(destFile);
+      assertEquals(hardlinkFile.readTextSync(), "data");
+    }
+  });
+});
+
 Deno.test("readDir", async () => {
   await withTempDir(async () => {
     const dir = createPath(".").resolve();

src/path.ts

@@ -571,6 +571,26 @@ export class Path {
     }
   }
 
+  /**
+   * Creates a hardlink to the provided target path.
+   */
+  async linkTo(
+    targetPath: string | URL | Path,
+  ): Promise<void> {
+    const targetPathRef = ensurePath(targetPath).resolve();
+    await Deno.link(targetPathRef.toString(), this.resolve().toString());
+  }
+
+  /**
+   * Synchronously creates a hardlink to the provided target path.
+   */
+  linkToSync(
+    targetPath: string | URL | Path,
+  ): void {
+    const targetPathRef = ensurePath(targetPath).resolve();
+    Deno.linkSync(targetPathRef.toString(), this.resolve().toString());
+  }
+
   /** Reads the entries in the directory. */
   async *readDir(): AsyncIterable<WalkEntry> {
     const dir = this.resolve();