mirror of
https://github.com/gristlabs/grist-core.git
synced 2024-10-27 20:44:07 +00:00
0c5f7cf0a7
Summary: * Adds a `SELF_HYPERLINK()` python function, with optional keyword arguments to set a label, the page, and link parameters. * Adds a `UUID()` python function, since using python's uuid.uuidv4 hits a problem accessing /dev/urandom in the sandbox. UUID makes no particular quality claims since it doesn't use an audited implementation. A difficult to guess code is convenient for some use cases that `SELF_HYPERLINK()` enables. The canonical URL for a document is mutable, but older versions generally forward. So for implementation simplicity the document url is passed it on sandbox creation and remains fixed throughout the lifetime of the sandbox. This could and should be improved in future. The URL is passed into the sandbox as a `DOC_URL` environment variable. The code for creating the URL is factored out of `Notifier.ts`. Since the url is a function of the organization as well as the document, some rejiggering is needed to make that information available to DocManager. On document imports, the new document is registered in the database slightly earlier now, in order to keep the procedure for constructing the URL in different starting conditions more homogeneous. Test Plan: updated test Reviewers: dsagal Reviewed By: dsagal Differential Revision: https://phab.getgrist.com/D2759
31 lines
1.1 KiB
TypeScript
31 lines
1.1 KiB
TypeScript
import * as log from 'app/server/lib/log';
|
|
|
|
/**
|
|
* Starting to whittle down the options used when creating a sandbox, to leave more
|
|
* freedom in how the sandbox works.
|
|
*/
|
|
export interface ISandboxCreationOptions {
|
|
comment?: string; // an argument to add in command line when possible, so it shows in `ps`
|
|
|
|
logCalls?: boolean;
|
|
logMeta?: log.ILogMeta;
|
|
logTimes?: boolean;
|
|
|
|
// This batch of options is used by SafePythonComponent, so are important for importers.
|
|
entryPoint?: string; // main script to call - leave undefined for default
|
|
sandboxMount?: string; // if defined, make this path available read-only as "/sandbox"
|
|
importMount?: string; // if defined, make this path available read-only as "/importdir"
|
|
|
|
docUrl?: string; // to support SELF_HYPERLINK.
|
|
}
|
|
|
|
export interface ISandbox {
|
|
shutdown(): Promise<unknown>; // TODO: tighten up this type.
|
|
pyCall(funcName: string, ...varArgs: unknown[]): Promise<any>;
|
|
reportMemoryUsage(): Promise<void>;
|
|
}
|
|
|
|
export interface ISandboxCreator {
|
|
create(options: ISandboxCreationOptions): ISandbox;
|
|
}
|