mirror of
https://github.com/denoland/deno.git
synced 2025-02-03 05:05:35 -05:00
327 lines
13 KiB
TypeScript
327 lines
13 KiB
TypeScript
// Copyright 2018-2019 the Deno authors. All rights reserved. MIT license.
|
||
import { core } from "./core.ts";
|
||
import * as dispatch from "./dispatch.ts";
|
||
import { sendSync } from "./dispatch_json.ts";
|
||
import { assert } from "./util.ts";
|
||
import * as util from "./util.ts";
|
||
import { window } from "./window.ts";
|
||
import { OperatingSystem, Arch } from "./build.ts";
|
||
|
||
/** Check if running in terminal.
|
||
*
|
||
* console.log(Deno.isTTY().stdout);
|
||
*/
|
||
export function isTTY(): { stdin: boolean; stdout: boolean; stderr: boolean } {
|
||
return sendSync(dispatch.OP_IS_TTY);
|
||
}
|
||
|
||
/** Get the hostname.
|
||
* Requires the `--allow-env` flag.
|
||
*
|
||
* console.log(Deno.hostname());
|
||
*/
|
||
export function hostname(): string {
|
||
return sendSync(dispatch.OP_HOSTNAME);
|
||
}
|
||
|
||
/** Exit the Deno process with optional exit code. */
|
||
export function exit(code = 0): never {
|
||
sendSync(dispatch.OP_EXIT, { code });
|
||
return util.unreachable();
|
||
}
|
||
|
||
function setEnv(key: string, value: string): void {
|
||
sendSync(dispatch.OP_SET_ENV, { key, value });
|
||
}
|
||
|
||
function getEnv(key: string): string | undefined {
|
||
return sendSync(dispatch.OP_GET_ENV, { key })[0];
|
||
}
|
||
|
||
/** Returns a snapshot of the environment variables at invocation. Mutating a
|
||
* property in the object will set that variable in the environment for
|
||
* the process. The environment object will only accept `string`s
|
||
* as values.
|
||
*
|
||
* console.log(Deno.env("SHELL"));
|
||
* const myEnv = Deno.env();
|
||
* console.log(myEnv.SHELL);
|
||
* myEnv.TEST_VAR = "HELLO";
|
||
* const newEnv = Deno.env();
|
||
* console.log(myEnv.TEST_VAR == newEnv.TEST_VAR);
|
||
*/
|
||
export function env(): { [index: string]: string };
|
||
export function env(key: string): string | undefined;
|
||
export function env(
|
||
key?: string
|
||
): { [index: string]: string } | string | undefined {
|
||
if (key) {
|
||
return getEnv(key);
|
||
}
|
||
const env = sendSync(dispatch.OP_ENV);
|
||
return new Proxy(env, {
|
||
set(obj, prop: string, value: string): boolean {
|
||
setEnv(prop, value);
|
||
return Reflect.set(obj, prop, value);
|
||
}
|
||
});
|
||
}
|
||
|
||
interface Start {
|
||
cwd: string;
|
||
pid: number;
|
||
argv: string[];
|
||
mainModule: string; // Absolute URL.
|
||
debugFlag: boolean;
|
||
depsFlag: boolean;
|
||
typesFlag: boolean;
|
||
versionFlag: boolean;
|
||
denoVersion: string;
|
||
v8Version: string;
|
||
tsVersion: string;
|
||
noColor: boolean;
|
||
os: OperatingSystem;
|
||
arch: Arch;
|
||
}
|
||
|
||
// This function bootstraps an environment within Deno, it is shared both by
|
||
// the runtime and the compiler environments.
|
||
// @internal
|
||
export function start(preserveDenoNamespace = true, source?: string): Start {
|
||
core.setAsyncHandler(dispatch.asyncMsgFromRust);
|
||
const ops = core.ops();
|
||
// TODO(bartlomieju): this is a prototype, we should come up with
|
||
// something a bit more sophisticated
|
||
for (const [name, opId] of Object.entries(ops)) {
|
||
const opName = `OP_${name.toUpperCase()}`;
|
||
// Assign op ids to actual variables
|
||
// TODO(ry) This type casting is gross and should be fixed.
|
||
((dispatch as unknown) as { [key: string]: number })[opName] = opId;
|
||
}
|
||
// First we send an empty `Start` message to let the privileged side know we
|
||
// are ready. The response should be a `StartRes` message containing the CLI
|
||
// args and other info.
|
||
const startResponse = sendSync(dispatch.OP_START);
|
||
const { pid, noColor, debugFlag } = startResponse;
|
||
|
||
util.setLogDebug(debugFlag, source);
|
||
|
||
// pid and noColor need to be set in the Deno module before it's set to be
|
||
// frozen.
|
||
util.immutableDefine(window.Deno, "pid", pid);
|
||
util.immutableDefine(window.Deno, "noColor", noColor);
|
||
Object.freeze(window.Deno);
|
||
|
||
if (preserveDenoNamespace) {
|
||
util.immutableDefine(window, "Deno", window.Deno);
|
||
// Deno.core could ONLY be safely frozen here (not in globals.ts)
|
||
// since shared_queue.js will modify core properties.
|
||
Object.freeze(window.Deno.core);
|
||
// core.sharedQueue is an object so we should also freeze it.
|
||
Object.freeze(window.Deno.core.sharedQueue);
|
||
} else {
|
||
// Remove window.Deno
|
||
delete window.Deno;
|
||
assert(window.Deno === undefined);
|
||
}
|
||
|
||
return startResponse;
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's home directory.
|
||
* Requires the `--allow-env` flag.
|
||
*/
|
||
export function homeDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "home" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's cache directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ----------------------------------- | ---------------------------- |
|
||
* | Linux | `$XDG_CACHE_HOME` or `$HOME`/.cache | /home/alice/.cache |
|
||
* | macOS | `$HOME`/Library/Caches | /Users/Alice/Library/Caches |
|
||
* | Windows | `{FOLDERID_LocalAppData}` | C:\Users\Alice\AppData\Local |
|
||
*/
|
||
export function cacheDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "cache" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's config directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ------------------------------------- | -------------------------------- |
|
||
* | Linux | `$XDG_CONFIG_HOME` or `$HOME`/.config | /home/alice/.config |
|
||
* | macOS | `$HOME`/Library/Preferences | /Users/Alice/Library/Preferences |
|
||
* | Windows | `{FOLDERID_RoamingAppData}` | C:\Users\Alice\AppData\Roaming |
|
||
*/
|
||
export function configDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "config" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's data directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ---------------------------------------- | ---------------------------------------- |
|
||
* | Linux | `$XDG_DATA_HOME` or `$HOME`/.local/share | /home/alice/.local/share |
|
||
* | macOS | `$HOME`/Library/Application Support | /Users/Alice/Library/Application Support |
|
||
* | Windows | `{FOLDERID_RoamingAppData}` | C:\Users\Alice\AppData\Roaming |
|
||
*/
|
||
export function dataDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "data" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's local data directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ---------------------------------------- | ---------------------------------------- |
|
||
* | Linux | `$XDG_DATA_HOME` or `$HOME`/.local/share | /home/alice/.local/share |
|
||
* | macOS | `$HOME`/Library/Application Support | /Users/Alice/Library/Application Support |
|
||
* | Windows | `{FOLDERID_LocalAppData}` | C:\Users\Alice\AppData\Local |
|
||
*/
|
||
export function dataLocalDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "data_local" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's audio directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ------------------ | -------------------- |
|
||
* | Linux | `XDG_MUSIC_DIR` | /home/alice/Music |
|
||
* | macOS | `$HOME`/Music | /Users/Alice/Music |
|
||
* | Windows | `{FOLDERID_Music}` | C:\Users\Alice\Music |
|
||
*/
|
||
export function audioDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "audio" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's desktop directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | -------------------- | ---------------------- |
|
||
* | Linux | `XDG_DESKTOP_DIR` | /home/alice/Desktop |
|
||
* | macOS | `$HOME`/Desktop | /Users/Alice/Desktop |
|
||
* | Windows | `{FOLDERID_Desktop}` | C:\Users\Alice\Desktop |
|
||
*/
|
||
export function desktopDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "desktop" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's document directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ---------------------- | ------------------------ |
|
||
* | Linux | `XDG_DOCUMENTS_DIR` | /home/alice/Documents |
|
||
* | macOS | `$HOME`/Documents | /Users/Alice/Documents |
|
||
* | Windows | `{FOLDERID_Documents}` | C:\Users\Alice\Documents |
|
||
*/
|
||
export function documentDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "document" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's download directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ---------------------- | ------------------------ |
|
||
* | Linux | `XDG_DOWNLOAD_DIR` | /home/alice/Downloads |
|
||
* | macOS | `$HOME`/Downloads | /Users/Alice/Downloads |
|
||
* | Windows | `{FOLDERID_Downloads}` | C:\Users\Alice\Downloads |
|
||
*/
|
||
export function downloadDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "download" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's font directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ---------------------------------------------------- | ------------------------------ |
|
||
* | Linux | `$XDG_DATA_HOME`/fonts or `$HOME`/.local/share/fonts | /home/alice/.local/share/fonts |
|
||
* | macOS | `$HOME/Library/Fonts` | /Users/Alice/Library/Fonts |
|
||
* | Windows | – | – |
|
||
*/
|
||
export function fontDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "font" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's picture directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | --------------------- | ----------------------- |
|
||
* | Linux | `XDG_PICTURES_DIR` | /home/alice/Pictures |
|
||
* | macOS | `$HOME`/Pictures | /Users/Alice/Pictures |
|
||
* | Windows | `{FOLDERID_Pictures}` | C:\Users\Alice\Pictures |
|
||
*/
|
||
export function pictureDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "picture" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's public directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | --------------------- | ------------------- |
|
||
* | Linux | `XDG_PUBLICSHARE_DIR` | /home/alice/Public |
|
||
* | macOS | `$HOME`/Public | /Users/Alice/Public |
|
||
* | Windows | `{FOLDERID_Public}` | C:\Users\Public |
|
||
*/
|
||
export function publicDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "public" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's template directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ---------------------- | ---------------------------------------------------------- |
|
||
* | Linux | `XDG_TEMPLATES_DIR` | /home/alice/Templates |
|
||
* | macOS | – | – |
|
||
* | Windows | `{FOLDERID_Templates}` | C:\Users\Alice\AppData\Roaming\Microsoft\Windows\Templates |
|
||
*/
|
||
export function templateDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "template" });
|
||
}
|
||
|
||
/**
|
||
* Returns the current user's video directory.
|
||
* If the directory does not exist, an exception is thrown
|
||
* Requires the `--allow-env` flag.
|
||
* |Platform | Value | Example |
|
||
* | ------- | ------------------- | --------------------- |
|
||
* | Linux | `XDG_VIDEOS_DIR` | /home/alice/Videos |
|
||
* | macOS | `$HOME`/Movies | /Users/Alice/Movies |
|
||
* | Windows | `{FOLDERID_Videos}` | C:\Users\Alice\Videos |
|
||
*/
|
||
export function videoDir(): string {
|
||
return sendSync(dispatch.OP_GET_DIR, { name: "video" });
|
||
}
|
||
|
||
/**
|
||
* Returns the path to the current deno executable.
|
||
* Requires the `--allow-env` flag.
|
||
*/
|
||
export function execPath(): string {
|
||
return sendSync(dispatch.OP_EXEC_PATH);
|
||
}
|