@eagleoutice/flowr 1.4.1 → 1.5.0

package/r-bridge/shell-executor.js

@@ -10,107 +10,38 @@ const child_process_1 = require("child_process");
 const lang_4_x_1 = require("./lang-4.x");
 const preload_1 = __importDefault(require("semver/preload"));
 const log_1 = require("../util/log");
-const fs_1 = __importDefault(require("fs"));
-const retriever_1 = require("./retriever");
+const executorLog = log_1.log.getSubLogger({ name: 'RShellExecutor' });
 class RShellExecutor {
     options;
-    log;
     prerequisites = [];
     constructor(options) {
         this.options = (0, objects_1.deepMergeObject)(shell_1.DEFAULT_R_SHELL_OPTIONS, options);
-        this.log = log_1.log.getSubLogger({ name: 'RShellExecutor' });
     }
     continueOnError() {
-        this.log.info('continue in case of Errors');
+        executorLog.info('continue in case of Errors');
         this.addPrerequisites('options(error=function() {})');
         return this;
     }
-    injectLibPaths(...paths) {
-        this.log.debug(`injecting lib paths ${JSON.stringify(paths)}`);
-        this.addPrerequisites(`.libPaths(c(.libPaths(), ${paths.map(lang_4_x_1.ts2r).join(',')}))`);
-        return this;
-    }
-    tryToInjectHomeLibPath() {
-        if (this.options.homeLibPath === undefined) {
-            this.log.debug('ensuring home lib path exists (automatic inject)');
-            this.addPrerequisites([
-                'if(!dir.exists(Sys.getenv("R_LIBS_USER"))) { dir.create(path=Sys.getenv("R_LIBS_USER"),showWarnings=FALSE,recursive=TRUE) }',
-                '.libPaths(c(.libPaths(), Sys.getenv("R_LIBS_USER")))'
-            ]);
-        }
-        else {
-            this.injectLibPaths(this.options.homeLibPath);
-        }
-        return this;
-    }
     addPrerequisites(commands) {
         this.prerequisites.push(...(typeof commands == 'string' ? [commands] : commands));
         return this;
     }
     usedRVersion() {
         const version = this.run(`cat(paste0(R.version$major,".",R.version$minor), ${(0, lang_4_x_1.ts2r)(this.options.eol)})`);
-        this.log.trace(`raw version: ${JSON.stringify(version)}`);
+        executorLog.trace(`raw version: ${JSON.stringify(version)}`);
         return preload_1.default.coerce(version);
     }
-    allInstalledPackages() {
-        this.log.debug('getting all installed packages');
-        const packages = this.run(`cat(paste0(installed.packages()[,1], collapse=","),"${this.options.eol}")`);
-        return packages.split(',');
-    }
-    isPackageInstalled(packageName) {
-        this.log.debug(`checking if package "${packageName}" is installed`);
-        return this.run(`cat(system.file(package="${packageName}")!="","${this.options.eol}")`) === 'TRUE';
-    }
-    ensurePackageInstalled(packageName, autoload = false, force = false) {
-        const packageExistedAlready = this.isPackageInstalled(packageName);
-        if (!force && packageExistedAlready) {
-            this.log.info(`package "${packageName}" is already installed`);
-            if (autoload)
-                this.addPrerequisites(`library(${(0, lang_4_x_1.ts2r)(packageName)})`);
-            return { packageName, packageExistedAlready };
+    run(command, returnErr = false) {
+        command += ';base::quit()';
+        if (executorLog.settings.minLevel >= 1 /* LogLevel.Trace */) {
+            executorLog.trace(`> ${JSON.stringify(command)}`);
         }
-        const tempDir = this.obtainTempDir();
-        this.log.debug(`using temporary directory: "${tempDir}" to install package "${packageName}"`);
-        this.run(`install.packages(${(0, lang_4_x_1.ts2r)(packageName)},repos="https://cloud.r-project.org/",quiet=FALSE,lib=temp)`);
-        if (autoload)
-            this.addPrerequisites(`library(${(0, lang_4_x_1.ts2r)(packageName)},lib.loc=temp)`);
-        return { packageName, packageExistedAlready, libraryLocation: tempDir };
-    }
-    obtainTempDir() {
-        const tempDir = this.run([
-            'temp <- tempdir()',
-            `cat(temp, ${(0, lang_4_x_1.ts2r)(this.options.eol)})`
-        ]);
-        log_1.log.info(`obtained temp dir ${tempDir}`);
-        const deleteOnExit = function () {
-            if (fs_1.default.existsSync(tempDir)) {
-                log_1.log.info(`deleting temp dir ${tempDir}`);
-                fs_1.default.rmSync(tempDir, { recursive: true, force: true });
-            }
-        };
-        process.on('SIGINT', deleteOnExit);
-        process.on('SIGTERM', deleteOnExit);
-        return tempDir;
-    }
-    getTokenMap() {
-        this.ensurePackageInstalled('xmlparsedata', true);
-        // we invert the token map to get a mapping back from the replacement
-        const parsed = (0, lang_4_x_1.parseCSV)(this.run('write.table(xmlparsedata::xml_parse_token_map,sep=",",col.names=FALSE)').split('\n'));
-        if (parsed.some(s => s.length !== 2))
-            throw new Error(`Expected two columns in token map, but got ${JSON.stringify(parsed)}`);
-        // we swap key and value to get the other direction, furthermore we remove quotes from keys if they are quoted
-        const ret = {};
-        for (const [key, value] of parsed)
-            ret[value] = (0, retriever_1.removeTokenMapQuotationMarks)(key);
-        return ret;
-    }
-    run(commands, returnErr = false) {
-        this.log.trace(`> ${JSON.stringify(commands)}`);
         const returns = (0, child_process_1.spawnSync)(this.options.pathToRExecutable, this.options.commandLineOptions, {
             env: this.options.env,
             cwd: this.options.cwd,
+            windowsHide: true,
             encoding: 'utf8',
-            input: [...this.prerequisites, commands].join(this.options.eol)
+            input: [...this.prerequisites, command].join(this.options.eol)
         });
         return (returnErr ? returns.stderr : returns.stdout).trim();
     }

package/r-bridge/shell.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="node" />
 import { type MergeableRecord } from '../util/objects';
 import type { SemVer } from 'semver';
-import type { TokenMap } from './retriever';
 export type OutputStreamSelector = 'stdout' | 'stderr' | 'both';
 export interface CollectorTimeout extends MergeableRecord {
     /**
@@ -60,6 +59,7 @@ export interface RShellSessionOptions extends RShellExecutionOptions {
 export interface RShellOptions extends RShellSessionOptions {
     readonly sessionName: string;
 }
+export declare const DEFAULT_R_PATH: string;
 export declare const DEFAULT_R_SHELL_EXEC_OPTIONS: RShellExecutionOptions;
 export declare const DEFAULT_R_SHELL_OPTIONS: RShellOptions;
 /**
@@ -75,7 +75,6 @@ export declare class RShell {
     private session;
     private readonly log;
     private versionCache;
-    private tokenMapCache;
     private tempDirs;
     constructor(options?: Partial<RShellOptions>);
     private revive;
@@ -85,13 +84,12 @@ export declare class RShell {
    */
     sendCommand(command: string): void;
     usedRVersion(): Promise<SemVer | null>;
+    injectLibPaths(...paths: string[]): void;
+    tryToInjectHomeLibPath(): void;
     /**
-     * Retrieve the token map of the xmlparsedata package.
-     *
-     * @note For multiple calls, this makes use of caching
+     * checks if a given package is already installed on the system!
      */
-    tokenMap(): Promise<TokenMap>;
-    private retrieveTokenMap;
+    isPackageInstalled(packageName: string): Promise<boolean>;
     /**
    * Send a command and collect the output
    *
@@ -115,26 +113,6 @@ export declare class RShell {
    * continue working!
    */
     continueOnError(): void;
-    injectLibPaths(...paths: string[]): void;
-    tryToInjectHomeLibPath(): void;
-    /**
-   * checks if a given package is already installed on the system!
-   */
-    isPackageInstalled(packageName: string): Promise<boolean>;
-    allInstalledPackages(): Promise<string[]>;
-    /**
-   * Installs the package using a temporary location
-   *
-   * @param packageName - The package to install
-   * @param autoload    - If true, the package will be loaded after installation
-   * @param force       - If true, the package will be installed no if it is already on the system and ready to be loaded
-   */
-    ensurePackageInstalled(packageName: string, autoload?: boolean, force?: boolean): Promise<{
-        packageName: string;
-        packageExistedAlready: boolean;
-        /** the temporary directory used for the installation, undefined if none was used */
-        libraryLocation?: string;
-    }>;
     /**
      * Obtain the temporary directory used by R.
      * Additionally, this marks the directory for removal when the shell exits.

package/r-bridge/shell.js

@@ -26,16 +26,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RShell = exports.DEFAULT_R_SHELL_OPTIONS = exports.DEFAULT_R_SHELL_EXEC_OPTIONS = exports.DEFAULT_OUTPUT_COLLECTOR_CONFIGURATION = void 0;
+exports.RShell = exports.DEFAULT_R_SHELL_OPTIONS = exports.DEFAULT_R_SHELL_EXEC_OPTIONS = exports.DEFAULT_R_PATH = exports.DEFAULT_OUTPUT_COLLECTOR_CONFIGURATION = void 0;
 const child_process_1 = require("child_process");
 const objects_1 = require("../util/objects");
-const readline = __importStar(require("node:readline"));
+const readline = __importStar(require("readline"));
 const lang_4_x_1 = require("./lang-4.x");
 const log_1 = require("../util/log");
 const preload_1 = __importDefault(require("semver/preload"));
 const os_1 = require("../util/os");
 const fs_1 = __importDefault(require("fs"));
-const retriever_1 = require("./retriever");
+const config_1 = require("../config");
 exports.DEFAULT_OUTPUT_COLLECTOR_CONFIGURATION = {
     from: 'stdout',
     postamble: `🐧${'-'.repeat(5)}🐧`,
@@ -47,13 +47,14 @@ exports.DEFAULT_OUTPUT_COLLECTOR_CONFIGURATION = {
     automaticallyTrimOutput: true,
     errorStopsWaiting: true
 };
+exports.DEFAULT_R_PATH = (0, os_1.getPlatform)() === 'windows' ? 'R.exe' : 'R';
 exports.DEFAULT_R_SHELL_EXEC_OPTIONS = {
-    pathToRExecutable: (0, os_1.getPlatform)() === 'windows' ? 'R.exe' : 'R',
+    pathToRExecutable: (0, config_1.getConfig)().rPath ?? exports.DEFAULT_R_PATH,
     commandLineOptions: ['--vanilla', '--quiet', '--no-echo', '--no-save'],
     cwd: process.cwd(),
     env: process.env,
     eol: '\n',
-    homeLibPath: (0, os_1.getPlatform)() === 'windows' ? undefined : '~/.r-libs',
+    homeLibPath: (0, os_1.getPlatform)() === 'windows' ? undefined : '~/.r-libs'
 };
 exports.DEFAULT_R_SHELL_OPTIONS = {
     ...exports.DEFAULT_R_SHELL_EXEC_OPTIONS,
@@ -74,7 +75,6 @@ class RShell {
     session;
     log;
     versionCache = null;
-    tokenMapCache = null;
     // should never be more than one, but let's be sure
     tempDirs = new Set();
     constructor(options) {
@@ -116,30 +116,28 @@ class RShell {
         this.versionCache = preload_1.default.coerce(result[0]);
         return result.length === 1 ? this.versionCache : null;
     }
-    /**
-     * Retrieve the token map of the xmlparsedata package.
-     *
-     * @note For multiple calls, this makes use of caching
-     */
-    async tokenMap() {
-        if (this.tokenMapCache === null) {
-            this.tokenMapCache = await this.retrieveTokenMap();
-        }
-        return this.tokenMapCache;
+    injectLibPaths(...paths) {
+        this.log.debug(`injecting lib paths ${JSON.stringify(paths)}`);
+        this._sendCommand(`.libPaths(c(.libPaths(), ${paths.map(lang_4_x_1.ts2r).join(',')}))`);
     }
-    async retrieveTokenMap() {
-        await this.ensurePackageInstalled('xmlparsedata', true /* use some kind of environment in the future */);
-        // we invert the token map to get a mapping back from the replacement
-        const parsed = (0, lang_4_x_1.parseCSV)(await this.sendCommandWithOutput('write.table(xmlparsedata::xml_parse_token_map,sep=",",col.names=FALSE)'));
-        if (parsed.some(s => s.length !== 2)) {
-            throw new Error(`Expected two columns in token map, but got ${JSON.stringify(parsed)}`);
+    tryToInjectHomeLibPath() {
+        // ensure the path exists first
+        if (this.options.homeLibPath === undefined) {
+            this.log.debug('ensuring home lib path exists (automatic inject)');
+            this.sendCommand('if(!dir.exists(Sys.getenv("R_LIBS_USER"))) { dir.create(path=Sys.getenv("R_LIBS_USER"),showWarnings=FALSE,recursive=TRUE) }');
+            this.sendCommand('.libPaths(c(.libPaths(), Sys.getenv("R_LIBS_USER")))');
         }
-        // we swap key and value to get the other direction, furthermore we remove quotes from keys if they are quoted
-        const cache = {};
-        for (const [key, value] of parsed) {
-            cache[value] = (0, retriever_1.removeTokenMapQuotationMarks)(key);
+        else {
+            this.injectLibPaths(this.options.homeLibPath);
         }
-        return cache;
+    }
+    /**
+     * checks if a given package is already installed on the system!
+     */
+    async isPackageInstalled(packageName) {
+        this.log.debug(`checking if package "${packageName}" is installed`);
+        const result = await this.sendCommandWithOutput(`cat(system.file(package="${packageName}")!="","${this.options.eol}")`);
+        return result.length === 1 && result[0] === 'TRUE';
     }
     /**
    * Send a command and collect the output
@@ -197,69 +195,6 @@ class RShell {
         this.log.info('continue in case of Errors');
         this._sendCommand('options(error=function() {})');
     }
-    injectLibPaths(...paths) {
-        this.log.debug(`injecting lib paths ${JSON.stringify(paths)}`);
-        this._sendCommand(`.libPaths(c(.libPaths(), ${paths.map(lang_4_x_1.ts2r).join(',')}))`);
-    }
-    tryToInjectHomeLibPath() {
-        // ensure the path exists first
-        if (this.options.homeLibPath === undefined) {
-            this.log.debug('ensuring home lib path exists (automatic inject)');
-            this.sendCommand('if(!dir.exists(Sys.getenv("R_LIBS_USER"))) { dir.create(path=Sys.getenv("R_LIBS_USER"),showWarnings=FALSE,recursive=TRUE) }');
-            this.sendCommand('.libPaths(c(.libPaths(), Sys.getenv("R_LIBS_USER")))');
-        }
-        else {
-            this.injectLibPaths(this.options.homeLibPath);
-        }
-    }
-    /**
-   * checks if a given package is already installed on the system!
-   */
-    async isPackageInstalled(packageName) {
-        this.log.debug(`checking if package "${packageName}" is installed`);
-        const result = await this.sendCommandWithOutput(`cat(system.file(package="${packageName}")!="","${this.options.eol}")`);
-        return result.length === 1 && result[0] === 'TRUE';
-    }
-    async allInstalledPackages() {
-        this.log.debug('getting all installed packages');
-        const [packages] = await this.sendCommandWithOutput(`cat(paste0(installed.packages()[,1], collapse=","),"${this.options.eol}")`);
-        return packages.split(',');
-    }
-    /**
-   * Installs the package using a temporary location
-   *
-   * @param packageName - The package to install
-   * @param autoload    - If true, the package will be loaded after installation
-   * @param force       - If true, the package will be installed no if it is already on the system and ready to be loaded
-   */
-    async ensurePackageInstalled(packageName, autoload = false, force = false) {
-        const packageExistedAlready = await this.isPackageInstalled(packageName);
-        if (!force && packageExistedAlready) {
-            this.log.info(`package "${packageName}" is already installed`);
-            if (autoload) {
-                this.sendCommand(`library(${(0, lang_4_x_1.ts2r)(packageName)})`);
-            }
-            return {
-                packageName,
-                packageExistedAlready: true
-            };
-        }
-        // obtain a temporary directory
-        const tempdir = await this.obtainTmpDir();
-        this.log.debug(`using temporary directory: "${tempdir}" to install package "${packageName}"`);
-        await this.sendCommandWithOutput(`install.packages(${(0, lang_4_x_1.ts2r)(packageName)},repos="https://cloud.r-project.org/",quiet=FALSE,lib=temp)`, {
-            ms: 750_000,
-            resetOnNewData: true
-        });
-        if (autoload) {
-            this.sendCommand(`library(${(0, lang_4_x_1.ts2r)(packageName)},lib.loc=temp)`);
-        }
-        return {
-            packageName,
-            libraryLocation: tempdir,
-            packageExistedAlready
-        };
-    }
     /**
      * Obtain the temporary directory used by R.
      * Additionally, this marks the directory for removal when the shell exits.
@@ -307,7 +242,9 @@ class RShellSession {
             input: this.bareSession.stderr,
             terminal: false
         });
-        this.onExit(() => { this.end(); });
+        this.onExit(() => {
+            this.end();
+        });
         this.options = options;
         this.log = log;
         this.setupRSessionLoggers();
@@ -351,7 +288,9 @@ class RShellSession {
                     this.collectionTimeout = makeTimer();
                 }
             };
-            error = () => { resolve(result); };
+            error = () => {
+                resolve(result);
+            };
             this.onExit(error);
             this.on(from, 'line', handler);
             action?.();

package/{statistics/output → util}/ansi.js

@@ -17,7 +17,7 @@ exports.voidFormatter = new class {
     reset() {
         return '';
     }
-};
+}();
 /**
  * This does not work if the {@link setFormatter | formatter} is void. Tries to format the text with a bold font weight.
  */

package/util/args.d.ts

@@ -4,11 +4,15 @@
  * @module
  */
 /**
- * This splits an input string on the given split string (e.g., ` `) but checks if the string is quoted or escaped.
+ * This splits an input string on the given split string (e.g., ` `), but checks if the string is quoted or escaped.
  *
- * Given an input string like `a "b c" d` with a space character as split this splits the arguments similar to common shell interpreters (i.e., `a`, `b c`, and `d`).
+ * Given an input string like `a "b c" d`, with a space character as split, and escapeQuote set to true,
+ * this splits the arguments similar to common shell interpreters (i.e., `a`, `b c`, and `d`).
+ *
+ * When escapeQuote is set to false instead, we keep quotation marks in the result (i.e., `a`, `"b c"`, and `d`.).
  *
  * @param inputString - The string to split
- * @param split       - The **single** character to split on (can not be the backslash or quote)
+ * @param escapeQuote - Keep quotes in args
+ * @param split       - The **single** character to split on (can not be backslash or quote)
  */
-export declare function splitAtEscapeSensitive(inputString: string, split?: string): string[];
+export declare function splitAtEscapeSensitive(inputString: string, escapeQuote?: boolean, split?: string): string[];

package/util/args.js

@@ -7,14 +7,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitAtEscapeSensitive = void 0;
 /**
- * This splits an input string on the given split string (e.g., ` `) but checks if the string is quoted or escaped.
+ * This splits an input string on the given split string (e.g., ` `), but checks if the string is quoted or escaped.
  *
- * Given an input string like `a "b c" d` with a space character as split this splits the arguments similar to common shell interpreters (i.e., `a`, `b c`, and `d`).
+ * Given an input string like `a "b c" d`, with a space character as split, and escapeQuote set to true,
+ * this splits the arguments similar to common shell interpreters (i.e., `a`, `b c`, and `d`).
+ *
+ * When escapeQuote is set to false instead, we keep quotation marks in the result (i.e., `a`, `"b c"`, and `d`.).
  *
  * @param inputString - The string to split
- * @param split       - The **single** character to split on (can not be the backslash or quote)
+ * @param escapeQuote - Keep quotes in args
+ * @param split       - The **single** character to split on (can not be backslash or quote)
  */
-function splitAtEscapeSensitive(inputString, split = ' ') {
+function splitAtEscapeSensitive(inputString, escapeQuote = true, split = ' ') {
     const args = [];
     let current = '';
     let inQuotes = false;
@@ -50,6 +54,9 @@ function splitAtEscapeSensitive(inputString, split = ' ') {
         }
         else if (c === '"' || c === "'") {
             inQuotes = !inQuotes;
+            if (!escapeQuote) {
+                current += c;
+            }
         }
         else if (c === '\\') {
             escaped = true;

package/util/cfg/visitor.js

@@ -49,7 +49,7 @@ class ControlFlowGraphExecutionTraceVisitor {
         return predecessors;
     }
     visit(cfg) {
-        const visited = new Set;
+        const visited = new Set();
         for (const id of cfg.entryPoints) {
             const node = cfg.graph.vertices().get(id);
             (0, assert_1.guard)(node !== undefined, `Node with id ${id} not present`);

package/util/files.d.ts

@@ -52,3 +52,9 @@ export declare function readLineByLine(filePath: string, onLine: (line: Buffer,
  * See {@link readLineByLine} for an asynchronous version.
  */
 export declare function readLineByLineSync(filePath: string, onLine: (line: Buffer, lineNumber: number) => void): void;
+/**
+ * Chops off the last part of the given directory path after a path separator, essentially returning the path's parent directory.
+ * If an absolute path is passed, the returned path is also absolute.
+ * @param directory - The directory whose parent to return
+ */
+export declare function getParentDirectory(directory: string): string;

package/util/files.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readLineByLineSync = exports.readLineByLine = exports.writeTableAsCsv = exports.allRFilesFrom = exports.allRFiles = exports.getAllFiles = void 0;
+exports.getParentDirectory = exports.readLineByLineSync = exports.readLineByLine = exports.writeTableAsCsv = exports.allRFilesFrom = exports.allRFiles = exports.getAllFiles = void 0;
 const fs_1 = __importStar(require("fs"));
 const path_1 = __importDefault(require("path"));
 const log_1 = require("./log");
@@ -141,4 +141,14 @@ function readLineByLineSync(filePath, onLine) {
     }
 }
 exports.readLineByLineSync = readLineByLineSync;
+/**
+ * Chops off the last part of the given directory path after a path separator, essentially returning the path's parent directory.
+ * If an absolute path is passed, the returned path is also absolute.
+ * @param directory - The directory whose parent to return
+ */
+function getParentDirectory(directory) {
+    // apparently this is somehow the best way to do it in node, what
+    return directory.split(path_1.default.sep).slice(0, -1).join(path_1.default.sep);
+}
+exports.getParentDirectory = getParentDirectory;
 //# sourceMappingURL=files.js.map

package/util/log.js

@@ -34,6 +34,9 @@ class FlowrLogger extends tslog_1.Logger {
 exports.FlowrLogger = FlowrLogger;
 function getActiveLog() {
     return new FlowrLogger({
+        // set the default minimum level as Warn, and let all apps
+        // (like the REPL) update it to whatever they want it to be
+        minLevel: 4 /* LogLevel.Warn */,
         type: 'pretty',
         name: 'main',
         stylePrettyLogs: true,

package/util/{summarizer/summarizer.d.ts → summarizer.d.ts}

@@ -1,4 +1,4 @@
-import type { MergeableRecord } from '../objects';
+import type { MergeableRecord } from './objects';
 export declare const enum SummarizerType {
     Benchmark = "benchmark",
     Statistics = "statistics"
@@ -6,6 +6,17 @@ export declare const enum SummarizerType {
 export interface CommonSummarizerConfiguration extends MergeableRecord {
     logger: (message: string) => void;
 }
+export interface SummarizedMeasurement<T = number> {
+    min: T;
+    max: T;
+    median: T;
+    /** total may be useless for some measurements, especially if they are weighted before (it is just the sum...)*/
+    total: T;
+    /** average */
+    mean: number;
+    /** standard deviation */
+    std: number;
+}
 export declare abstract class Summarizer<Output, Configuration extends CommonSummarizerConfiguration> {
     protected readonly config: Configuration;
     protected readonly log: CommonSummarizerConfiguration['logger'];
@@ -23,3 +34,6 @@ export declare abstract class Summarizer<Output, Configuration extends CommonSum
      */
     abstract summarizePhase(): Promise<Output>;
 }
+export declare function summarizedMeasurement2Csv(a: SummarizedMeasurement): string;
+export declare function summarizedMeasurement2CsvHeader(prefix?: string): string;
+export declare function summarizeMeasurement(data: number[], totalNumberOfDataPoints?: number): SummarizedMeasurement;

package/util/summarizer.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeMeasurement = exports.summarizedMeasurement2CsvHeader = exports.summarizedMeasurement2Csv = exports.Summarizer = void 0;
+const arrays_1 = require("./arrays");
+class Summarizer {
+    config;
+    log;
+    constructor(config) {
+        this.config = config;
+        this.log = this.config.logger;
+    }
+}
+exports.Summarizer = Summarizer;
+function summarizedMeasurement2Csv(a) {
+    return `${a.min},${a.max},${a.median},${a.mean},${a.std},${a.total}`;
+}
+exports.summarizedMeasurement2Csv = summarizedMeasurement2Csv;
+const summarizedKeys = ['min', 'max', 'median', 'mean', 'std', 'total'];
+function summarizedMeasurement2CsvHeader(prefix) {
+    return summarizedKeys.map(k => prefix ? `${prefix}-${k}` : k).join(',');
+}
+exports.summarizedMeasurement2CsvHeader = summarizedMeasurement2CsvHeader;
+function summarizeMeasurement(data, totalNumberOfDataPoints) {
+    // just to avoid in-place modification
+    const sorted = [...data].sort((a, b) => a - b);
+    const min = sorted[0];
+    const max = sorted[sorted.length - 1];
+    const median = sorted[Math.floor(sorted.length / 2)];
+    const total = (0, arrays_1.sum)(sorted);
+    const length = totalNumberOfDataPoints ?? sorted.length;
+    const mean = total / length;
+    // sqrt(sum(x-mean)^2 / n)
+    const std = Math.sqrt(sorted.map(x => (x - mean) ** 2).reduce((a, b) => a + b, 0) / length);
+    return { min, max, median, mean, std, total };
+}
+exports.summarizeMeasurement = summarizeMeasurement;
+//# sourceMappingURL=summarizer.js.map

package/util/version.d.ts

@@ -0,0 +1,2 @@
+import { SemVer } from 'semver';
+export declare function flowrVersion(): SemVer;

package/util/version.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowrVersion = void 0;
+const package_json_1 = require("../../package.json");
+const semver_1 = require("semver");
+function flowrVersion() {
+    return new semver_1.SemVer(package_json_1.version);
+}
+exports.flowrVersion = flowrVersion;
+//# sourceMappingURL=version.js.map

package/benchmark/index.d.ts

@@ -1,3 +0,0 @@
-export * from './stats';
-export * from './slicer';
-export * from './stopwatch';

package/benchmark/index.js

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./stats"), exports);
-__exportStar(require("./slicer"), exports);
-__exportStar(require("./stopwatch"), exports);
-//# sourceMappingURL=index.js.map