2020-01-02 15:13:47 -05:00
|
|
|
// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
|
2019-09-02 17:07:11 -04:00
|
|
|
import { sendSync, sendAsync } from "./dispatch_json.ts";
|
|
|
|
import { FileInfo, FileInfoImpl } from "./file_info.ts";
|
2018-09-11 15:38:53 -04:00
|
|
|
|
2020-02-28 11:05:40 -05:00
|
|
|
/** @internal */
|
2019-08-26 10:18:42 -04:00
|
|
|
export interface StatResponse {
|
|
|
|
isFile: boolean;
|
|
|
|
isSymlink: boolean;
|
|
|
|
len: number;
|
|
|
|
modified: number;
|
|
|
|
accessed: number;
|
|
|
|
created: number;
|
|
|
|
name: string | null;
|
2020-01-16 09:46:32 -05:00
|
|
|
// Unix only members
|
|
|
|
dev: number;
|
|
|
|
ino: number;
|
|
|
|
mode: number;
|
|
|
|
nlink: number;
|
|
|
|
uid: number;
|
|
|
|
gid: number;
|
|
|
|
rdev: number;
|
|
|
|
blksize: number;
|
|
|
|
blocks: number;
|
2019-03-09 12:30:38 -05:00
|
|
|
}
|
|
|
|
|
2020-03-06 11:29:23 -05:00
|
|
|
/** Resolves to a `Deno.FileInfo` for the specified `path`. If `path` is a
|
2020-03-02 10:19:42 -05:00
|
|
|
* symlink, information for the symlink will be returned.
|
2018-09-11 15:38:53 -04:00
|
|
|
*
|
2019-02-12 10:08:56 -05:00
|
|
|
* const fileInfo = await Deno.lstat("hello.txt");
|
2018-10-14 16:29:50 -04:00
|
|
|
* assert(fileInfo.isFile());
|
2020-03-02 10:19:42 -05:00
|
|
|
*
|
|
|
|
* Requires `allow-read` permission. */
|
2020-03-06 11:29:23 -05:00
|
|
|
export async function lstat(path: string): Promise<FileInfo> {
|
2020-02-25 09:14:27 -05:00
|
|
|
const res = (await sendAsync("op_stat", {
|
2020-03-06 11:29:23 -05:00
|
|
|
path,
|
2019-08-26 10:18:42 -04:00
|
|
|
lstat: true
|
|
|
|
})) as StatResponse;
|
|
|
|
return new FileInfoImpl(res);
|
2018-09-11 15:38:53 -04:00
|
|
|
}
|
|
|
|
|
2020-03-06 11:29:23 -05:00
|
|
|
/** Synchronously returns a `Deno.FileInfo` for the specified `path`. If
|
|
|
|
* `path` is a symlink, information for the symlink will be returned.
|
2018-09-11 15:38:53 -04:00
|
|
|
*
|
2019-02-12 10:08:56 -05:00
|
|
|
* const fileInfo = Deno.lstatSync("hello.txt");
|
2018-10-14 16:29:50 -04:00
|
|
|
* assert(fileInfo.isFile());
|
2020-03-02 10:19:42 -05:00
|
|
|
*
|
|
|
|
* Requires `allow-read` permission. */
|
2020-03-06 11:29:23 -05:00
|
|
|
export function lstatSync(path: string): FileInfo {
|
2020-02-25 09:14:27 -05:00
|
|
|
const res = sendSync("op_stat", {
|
2020-03-06 11:29:23 -05:00
|
|
|
path,
|
2019-08-26 10:18:42 -04:00
|
|
|
lstat: true
|
|
|
|
}) as StatResponse;
|
|
|
|
return new FileInfoImpl(res);
|
2018-09-11 15:38:53 -04:00
|
|
|
}
|
|
|
|
|
2020-03-06 11:29:23 -05:00
|
|
|
/** Resolves to a `Deno.FileInfo` for the specified `path`. Will always
|
|
|
|
* follow symlinks.
|
2018-09-11 15:38:53 -04:00
|
|
|
*
|
2019-02-12 10:08:56 -05:00
|
|
|
* const fileInfo = await Deno.stat("hello.txt");
|
2018-10-14 16:29:50 -04:00
|
|
|
* assert(fileInfo.isFile());
|
2020-03-02 10:19:42 -05:00
|
|
|
*
|
|
|
|
* Requires `allow-read` permission. */
|
2020-03-06 11:29:23 -05:00
|
|
|
export async function stat(path: string): Promise<FileInfo> {
|
2020-02-25 09:14:27 -05:00
|
|
|
const res = (await sendAsync("op_stat", {
|
2020-03-06 11:29:23 -05:00
|
|
|
path,
|
2019-08-26 10:18:42 -04:00
|
|
|
lstat: false
|
|
|
|
})) as StatResponse;
|
|
|
|
return new FileInfoImpl(res);
|
2018-09-11 15:38:53 -04:00
|
|
|
}
|
|
|
|
|
2020-03-06 11:29:23 -05:00
|
|
|
/** Synchronously returns a `Deno.FileInfo` for the specified `path`. Will
|
2020-03-02 10:19:42 -05:00
|
|
|
* always follow symlinks.
|
2018-09-11 15:38:53 -04:00
|
|
|
*
|
2019-02-12 10:08:56 -05:00
|
|
|
* const fileInfo = Deno.statSync("hello.txt");
|
2018-10-14 16:29:50 -04:00
|
|
|
* assert(fileInfo.isFile());
|
2020-03-02 10:19:42 -05:00
|
|
|
*
|
|
|
|
* Requires `allow-read` permission. */
|
2020-03-06 11:29:23 -05:00
|
|
|
export function statSync(path: string): FileInfo {
|
2020-02-25 09:14:27 -05:00
|
|
|
const res = sendSync("op_stat", {
|
2020-03-06 11:29:23 -05:00
|
|
|
path,
|
2019-08-26 10:18:42 -04:00
|
|
|
lstat: false
|
|
|
|
}) as StatResponse;
|
|
|
|
return new FileInfoImpl(res);
|
2018-09-11 15:38:53 -04:00
|
|
|
}
|