@eagleoutice/flowr 1.4.1 → 1.5.0

package/benchmark/stopwatch.js

@@ -1,79 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Measurements = void 0;
-const assert_1 = require("../util/assert");
-/** unguarded start-stop wrapper */
-class Stopwatch {
-    timeStart;
-    timeEnd;
-    stopped = false;
-    start() {
-        this.timeStart = process.hrtime.bigint();
-    }
-    stop() {
-        this.timeEnd = process.hrtime.bigint();
-        // check after to not affect measurements
-        (0, assert_1.guard)(!this.stopped, 'cannot stop a stopwatch twice');
-        this.stopped = true;
-    }
-    get() {
-        (0, assert_1.guard)(this.timeStart !== undefined && this.timeEnd !== undefined, 'cannot get elapsed time as the stopwatch has not been started/stopped');
-        return this.timeEnd - this.timeStart;
-    }
-}
-/**
- * Allows to measure keys of type `T` with a `Stopwatch`.
- *
- * Measure with {@link start}, {@link measure} or {@link measureAsync}, retrieve the final measurements with {@link get}.
- */
-class Measurements {
-    measurements = new Map();
-    /**
-   * Start a timer for the given key, and guards that this is the first time this key is started.
-   * Call {@link IStoppableStopwatch#stop} on the returned stopwatch to stop the timer.
-   */
-    start(key) {
-        // we guard *before* starting so there is no additional time penalty
-        (0, assert_1.guard)(!this.measurements.has(key), `already started stop watch for ${JSON.stringify(key)}`);
-        const stopwatch = new Stopwatch();
-        this.measurements.set(key, stopwatch);
-        stopwatch.start();
-        return stopwatch;
-    }
-    /**
-   * Automatically call {@link Measurements#start | start} and the corresponding stop to measure the execution time of the given function.
-   * @see {@link measureAsync}
-   */
-    measure(key, fn) {
-        const stopwatch = this.start(key);
-        const result = fn();
-        stopwatch.stop();
-        return result;
-    }
-    /**
-   * Similar to {@link measure}, but await the promise as part of the measurement
-   *
-     * @param key - The key to write the resulting measurement to
-     * @param fn  - The function to measure
-     *
-   * @see measure
-   */
-    async measureAsync(key, fn) {
-        const stopwatch = this.start(key);
-        const result = await fn();
-        stopwatch.stop();
-        return result;
-    }
-    /**
-   * Retrieve all measure-results, requires that all stop-watches that have been started have also been stopped.
-   */
-    get() {
-        const result = new Map();
-        for (const [key, stopwatch] of this.measurements) {
-            result.set(key, stopwatch.get());
-        }
-        return result;
-    }
-}
-exports.Measurements = Measurements;
-//# sourceMappingURL=stopwatch.js.map

package/cli/benchmark-app.d.ts

@@ -1,9 +0,0 @@
-export interface BenchmarkCliOptions {
-    verbose: boolean;
-    help: boolean;
-    input: string[];
-    output: string;
-    slice: string;
-    parallel: number;
-    limit?: number;
-}

package/cli/benchmark-app.js

@@ -1,52 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const log_1 = require("../util/log");
-const files_1 = require("../util/files");
-const parallel_1 = require("../util/parallel");
-const assert_1 = require("../util/assert");
-const fs_1 = __importDefault(require("fs"));
-const common_1 = require("./common");
-const options = (0, common_1.processCommandLineArgs)('benchmark', [], {
-    subtitle: 'Slice given files with additional benchmark information',
-    examples: [
-        '{italic example-folder/}',
-        '{bold --help}'
-    ]
-});
-if (options.input.length === 0) {
-    console.error('No input files given. Nothing to do. See \'--help\' if this is an error.');
-    process.exit(0);
-}
-(0, assert_1.guard)(options.slice === 'all' || options.slice === 'no', 'slice must be either all or no');
-function removeIfExists(summarizedRaw) {
-    if (fs_1.default.existsSync(summarizedRaw)) {
-        console.log(`Removing existing ${summarizedRaw}`);
-        fs_1.default.unlinkSync(summarizedRaw);
-    }
-}
-async function benchmark() {
-    removeIfExists(options.output);
-    console.log(`Writing output continuously to ${options.output}`);
-    console.log(`Using ${options.parallel} parallel executors`);
-    // we do not use the limit argument to be able to pick the limit randomly
-    const files = [];
-    for await (const file of (0, files_1.allRFilesFrom)(options.input)) {
-        files.push(file);
-    }
-    if (options.limit) {
-        log_1.log.info(`limiting to ${options.limit} files`);
-        // shuffle and limit
-        files.sort(() => Math.random() - 0.5);
-    }
-    const limit = options.limit ?? files.length;
-    const verboseAdd = options.verbose ? ['--verbose'] : [];
-    const pool = new parallel_1.LimitedThreadPool(`${__dirname}/benchmark-helper-app`, files.map(f => [f.content, '--output', options.output, '--slice', options.slice, ...verboseAdd]), limit, options.parallel);
-    await pool.run();
-    const stats = pool.getStats();
-    console.log(`Benchmarked ${stats.counter} files, skipped ${stats.skipped.length} files due to errors`);
-}
-void benchmark();
-//# sourceMappingURL=benchmark-app.js.map

package/cli/benchmark-helper-app.d.ts

@@ -1,7 +0,0 @@
-export interface SingleBenchmarkCliOptions {
-    verbose: boolean;
-    help: boolean;
-    input?: string;
-    slice: string;
-    output?: string;
-}

package/cli/benchmark-helper-app.js

@@ -1,60 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const log_1 = require("../util/log");
-const benchmark_1 = require("../benchmark");
-const slicing_1 = require("../slicing");
-const fs_1 = __importDefault(require("fs"));
-const json_1 = require("../util/json");
-const assert_1 = require("../util/assert");
-const common_1 = require("./common");
-const options = (0, common_1.processCommandLineArgs)('benchmark-helper', [], {
-    subtitle: 'Will slice for all possible variables, signal by exit code if slicing was successful, and can be run standalone',
-    examples: [
-        '{italic example-file.R} --output {italic output.json}',
-        '{bold --help}'
-    ]
-});
-if (options.verbose) {
-    log_1.log.error('running with *verbose* setting - do not use for final benchmark', options);
-}
-(0, assert_1.guard)(options.slice === 'all' || options.slice === 'no', 'slice must be either all or no');
-async function benchmark() {
-    // we do not use the limit argument to be able to pick the limit randomly
-    (0, assert_1.guard)(options.input !== undefined, 'No input file given');
-    (0, assert_1.guard)(options.output !== undefined, 'No output file given');
-    console.log(`[${options.input}] Appending output to ${options.output}`);
-    // ensure the file exists
-    const fileStat = fs_1.default.statSync(options.input);
-    (0, assert_1.guard)(fileStat.isFile(), `File ${options.input} does not exist or is no file`);
-    const request = { request: 'file', content: options.input };
-    const slicer = new benchmark_1.BenchmarkSlicer();
-    try {
-        await slicer.init(request);
-        // ${escape}1F${escape}1G${escape}2K for line reset
-        if (options.slice === 'all') {
-            const count = await slicer.sliceForAll(slicing_1.DefaultAllVariablesFilter, (i, total, arr) => console.log(`[${options.input}] Slicing ${i + 1}/${total} [${JSON.stringify(arr[i])}]`));
-            console.log(`[${options.input}] Completed Slicing`);
-            (0, assert_1.guard)(count > 0, `No possible slices found for ${options.input}, skipping in count`);
-        }
-        else {
-            console.log(`[${options.input}] Skipping Slicing due to --slice=${options.slice}`);
-        }
-        const { stats } = slicer.finish();
-        // append line by line
-        fs_1.default.appendFileSync(options.output, `${JSON.stringify({ filename: options.input, stats }, json_1.jsonReplacer)}\n`);
-    }
-    catch (e) {
-        if (e instanceof Error) {
-            if (!e.message.includes('unable to parse R')) {
-                console.log(`[${options.input}] Non R-Side error : ${e.message}`);
-            }
-        }
-        slicer.ensureSessionClosed(); // ensure finish
-        throw e;
-    }
-}
-void benchmark();
-//# sourceMappingURL=benchmark-helper-app.js.map

package/cli/common/features.d.ts

@@ -1,3 +0,0 @@
-import type { FeatureKey } from '../../statistics';
-export declare function validateFeatures(features: (string[] | ['all'] | FeatureKey[])): Set<FeatureKey>;
-export declare function retrieveArchiveName(p: string): string;

package/cli/common/features.js

@@ -1,30 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.retrieveArchiveName = exports.validateFeatures = void 0;
-const statistics_1 = require("../../statistics");
-const path_1 = __importDefault(require("path"));
-function validateFeatures(features) {
-    for (const feature of features) {
-        if (feature === 'all') {
-            if (features.length > 1) {
-                console.error(`Feature "all" must be the only feature given, got ${features.join(', ')}`);
-                process.exit(1);
-            }
-        }
-        else if (!statistics_1.allFeatureNames.has(feature)) {
-            console.error(`Feature ${feature} is unknown, supported are ${[...statistics_1.allFeatureNames].join(', ')} or "all"`);
-            process.exit(1);
-        }
-    }
-    return features[0] === 'all' ? statistics_1.allFeatureNames : new Set(features);
-}
-exports.validateFeatures = validateFeatures;
-function retrieveArchiveName(p) {
-    const basepath = path_1.default.normalize(p);
-    return `${basepath.endsWith(path_1.default.sep) ? basepath.substring(0, basepath.length - 1) : basepath}.tar.gz`;
-}
-exports.retrieveArchiveName = retrieveArchiveName;
-//# sourceMappingURL=features.js.map

package/cli/common/index.d.ts

@@ -1,2 +0,0 @@
-export * from './script';
-export * from './scripts-info';

package/cli/common/index.js

@@ -1,19 +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("./script"), exports);
-__exportStar(require("./scripts-info"), exports);
-//# sourceMappingURL=index.js.map

package/cli/common/options.d.ts

@@ -1,20 +0,0 @@
-import type { OptionDefinition } from 'command-line-usage';
-/**
- * This interface describes options, that every script *must* provide.
- */
-export interface CommonOptions {
-    /** Enables the most verbose logging option available. */
-    verbose: boolean;
-    /**
-     * Shows the respective help including usage examples,
-     * see {@link processCommandLineArgs} or {@link helpForOptions} for more information.
-     */
-    help: boolean;
-}
-export declare const benchmarkOptions: OptionDefinition[];
-export declare const benchmarkHelperOptions: OptionDefinition[];
-export declare const exportQuadsOptions: OptionDefinition[];
-export declare const slicerOptions: OptionDefinition[];
-export declare const statisticOptions: OptionDefinition[];
-export declare const statisticHelperOptions: OptionDefinition[];
-export declare const summarizerOptions: OptionDefinition[];

package/cli/common/options.js

@@ -1,82 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.summarizerOptions = exports.statisticHelperOptions = exports.statisticOptions = exports.slicerOptions = exports.exportQuadsOptions = exports.benchmarkHelperOptions = exports.benchmarkOptions = void 0;
-const os_1 = __importDefault(require("os"));
-const time_1 = require("../../util/time");
-const statistics_1 = require("../../statistics");
-/**
- * This string contains a string representation of the loading time of this module.
- */
-const StartTimeString = (0, time_1.date2string)(new Date());
-exports.benchmarkOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging [do not use for the real benchmark as this affects the time measurements, but only to find errors]' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'limit', alias: 'l', type: Number, description: 'Limit the number of files to process (if given, this will choose these files randomly and add the chosen names to the output' },
-    { name: 'input', alias: 'i', type: String, description: 'Pass a folder or file as src to read from', multiple: true, defaultOption: true, defaultValue: [], typeLabel: '{underline files/folders}' },
-    { name: 'parallel', alias: 'p', type: String, description: 'Number of parallel executors (defaults to {italic max(cpu.count-1, 1)})', defaultValue: Math.max(os_1.default.cpus().length - 1, 1), typeLabel: '{underline number}' },
-    { name: 'slice', alias: 's', type: String, description: 'Automatically slice for *all* variables (default) or *no* slicing and only parsing/dataflow construction', defaultValue: 'all', typeLabel: '{underline all/no}' },
-    { name: 'output', alias: 'o', type: String, description: `File to write all the measurements to in a per-file-basis (defaults to {italic benchmark-${StartTimeString}.json})`, defaultValue: `benchmark-${StartTimeString}.json`, typeLabel: '{underline file}' }
-];
-exports.benchmarkHelperOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging [do not use for the real benchmark as this affects the time measurements, but only to find errors]' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'input', alias: 'i', type: String, description: 'Pass a single file as src to read from', multiple: false, defaultOption: true, typeLabel: '{underline file}' },
-    { name: 'slice', alias: 's', type: String, description: 'Automatically slice for *all* variables (default) or *no* slicing and only parsing/dataflow construction', defaultValue: 'all', typeLabel: '{underline all/no}' },
-    { name: 'output', alias: 'o', type: String, description: 'File to write the measurements to (appends a single line in JSON format)', typeLabel: '{underline file}' },
-];
-exports.exportQuadsOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'input', alias: 'i', type: String, description: 'Pass a folder or file as src to read from', multiple: true, defaultOption: true, defaultValue: [], typeLabel: '{underline files/folders}' },
-    { name: 'limit', alias: 'l', type: Number, description: 'Limit the number of files to process' },
-    { name: 'output', alias: 'o', type: String, description: 'File to write all the generated quads to (defaults to {italic out.quads})', typeLabel: '{underline file}' },
-];
-exports.slicerOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'input', alias: 'i', type: String, description: '(Required) Pass a single file to slice', multiple: false, defaultOption: true, typeLabel: '{underline files}' },
-    { name: 'input-is-text', alias: 'r', type: Boolean, description: 'Indicate, that the input is *not* a file, but R code to directly consume' },
-    { name: 'diff', alias: 'd', type: Boolean, description: 'This requires ansi-output and only works if the api option is not set. It visualizes the slice as a diff.' },
-    { name: 'criterion', alias: 'c', type: String, description: '(Required) Slicing criterion either in the form {underline line:col} or {underline line@variable}, multiple can be separated by \'{bold ;}\'. If you do not want to slice but only process the file, pass an empty string.', multiple: false },
-    { name: 'stats', alias: 's', type: Boolean, description: 'Print stats and write them to {italic <output>.stats} (runtimes etc.)', multiple: false },
-    { name: 'output', alias: 'o', type: String, description: 'File to write all the generated quads to (defaults to the commandline)', typeLabel: '{underline file}' },
-    { name: 'api', type: Boolean, description: 'Instead of human-readable output, dump a lot of json with the results of all intermediate steps.' },
-];
-const featureNameList = [...statistics_1.allFeatureNames].map(s => `"${s}"`).join(', ');
-exports.statisticOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'limit', alias: 'l', type: Number, description: 'Limit the number of files to process' },
-    { name: 'input', alias: 'i', type: String, description: 'Pass a folder or file as src to read from', multiple: true, defaultOption: true, defaultValue: [], typeLabel: '{underline files/folders}' },
-    { name: 'output-dir', alias: 'o', type: String, description: 'Folder to write the output to', defaultValue: `${process.cwd()}/statistics-out/${(0, time_1.date2string)(new Date())}`, typeLabel: '{underline folder}' },
-    { name: 'dump-json', type: Boolean, description: 'Write JSON output during the extraction', typeLabel: '{underline folder}' },
-    { name: 'no-ansi', type: Boolean, description: 'Disable ansi-escape-sequences in the output. Useful, if you want to redirect the output to a file.' },
-    { name: 'parallel', alias: 'p', type: String, description: 'Number of parallel executors (defaults to {italic max(cpu.count-1, 1)})', defaultValue: Math.max(os_1.default.cpus().length - 1, 1), typeLabel: '{underline number}' },
-    { name: 'features', type: String, description: `Features to track, supported are "all" or ${featureNameList}`, multiple: true, defaultValue: 'all', typeLabel: '{underline names}' },
-];
-exports.statisticHelperOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'input', alias: 'i', type: String, description: 'Pass single file as src to read from', multiple: false, defaultOption: true, typeLabel: '{underline file}' },
-    { name: 'output-dir', alias: 'o', type: String, description: 'Folder to write the output to', typeLabel: '{underline folder}' },
-    { name: 'root-dir', type: String, description: 'Root dir for the statistics files', defaultValue: '' },
-    { name: 'compress', type: Boolean, description: 'Compress the output folder to a single file', defaultValue: false },
-    { name: 'dump-json', type: Boolean, description: 'Write JSON output during the extraction', typeLabel: '{underline folder}' },
-    { name: 'no-ansi', type: Boolean, description: 'Disable ansi-escape-sequences in the output. Useful, if you want to redirect the output to a file.' },
-    { name: 'features', type: String, description: `Features to track, supported are "all" or ${featureNameList}`, multiple: true, defaultValue: 'all', typeLabel: '{underline names}' },
-];
-exports.summarizerOptions = [
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging' },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide' },
-    { name: 'type', alias: 't', type: String, description: 'Manually specify if you want to post-process benchmark results, statistics, or compressed statistics (defaults to auto).', defaultValue: 'auto' },
-    { name: 'graph', alias: 'g', type: Boolean, description: 'Produce data to be used for visualizing benchmarks over time' },
-    { name: 'categorize', type: Boolean, description: 'Categorize the results (e.g., "test", "example", ...)', defaultValue: false },
-    { name: 'project-skip', type: Number, description: 'Skip the first n folders to find the location of projects', defaultValue: 0 },
-    { name: 'ultimate-only', alias: 'u', type: Boolean, description: 'Only perform the second summary-stage, with this, the input is used to find the summary-output.' },
-    { name: 'input', alias: 'i', type: String, description: 'The {italic output} produced by the benchmark, the statistics, ...', defaultOption: true, multiple: false, typeLabel: '{underline file.json/output}' },
-    { name: 'output', alias: 'o', type: String, description: 'Basename of the summaries (defaults to {italic <input>-summary})', typeLabel: '{underline file}' },
-];
-//# sourceMappingURL=options.js.map

package/cli/common/script.d.ts

@@ -1,21 +0,0 @@
-/**
- * The goal of this module is simply to streamline the creation of new scripts.
- *
- * @module
- */
-import { scripts } from './scripts-info';
-import type { CommonOptions } from './options';
-/**
- * Just a helping data structure to allow the user to provide example usages of the respective script.
- * The subtitle will be displayed next to the title.
- */
-export interface HelpContent {
-    subtitle: string;
-    examples: string[];
-}
-/**
- * Automatically generates a uniform help from a given script (see {@link scripts}).
- * Additionally, you can pass usage examples that may make use of the formatting instructions `{italic x}` and `{bold x}`.
- */
-export declare function helpForOptions(script: keyof typeof scripts, content: HelpContent): string;
-export declare function processCommandLineArgs<T extends CommonOptions>(script: keyof typeof scripts, requireAdditionally: (keyof T)[], help: HelpContent): T;

package/cli/common/script.js

@@ -1,61 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.processCommandLineArgs = exports.helpForOptions = void 0;
-/**
- * The goal of this module is simply to streamline the creation of new scripts.
- *
- * @module
- */
-const scripts_info_1 = require("./scripts-info");
-const command_line_usage_1 = __importDefault(require("command-line-usage"));
-const log_1 = require("../../util/log");
-const command_line_args_1 = __importDefault(require("command-line-args"));
-const statistics_1 = require("../../statistics");
-/**
- * Automatically generates a uniform help from a given script (see {@link scripts}).
- * Additionally, you can pass usage examples that may make use of the formatting instructions `{italic x}` and `{bold x}`.
- */
-function helpForOptions(script, content) {
-    return (0, command_line_usage_1.default)([
-        {
-            header: scripts_info_1.scripts[script].description,
-            content: content.subtitle
-        },
-        {
-            header: 'Synopsis',
-            content: content.examples.map(e => `$ ${scripts_info_1.scripts[script].toolName} ${e}`)
-        },
-        {
-            header: 'Options',
-            optionList: scripts_info_1.scripts[script].options
-        }
-    ]);
-}
-exports.helpForOptions = helpForOptions;
-function processCommandLineArgs(script, requireAdditionally, help) {
-    const options = (0, command_line_args_1.default)(scripts_info_1.scripts[script].options);
-    if (options.help) {
-        console.log(helpForOptions(script, help));
-        process.exit(0);
-    }
-    else if (requireAdditionally.length > 0) {
-        const keys = new Set(Object.keys(options));
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- we know that they are not given if undefined
-        const missing = requireAdditionally.filter(k => !keys.has(k) || options[k] === undefined);
-        if (missing.length > 0) {
-            console.error((0, statistics_1.italic)(`Missing required arguments: ${missing.join(', ')}. Showing help.`));
-            console.log(helpForOptions(script, help));
-            process.exit(0);
-        }
-    }
-    log_1.log.updateSettings(l => l.settings.minLevel = options.verbose ? 1 /* LogLevel.Trace */ : 5 /* LogLevel.Error */);
-    if (options.verbose) {
-        log_1.log.info(`running with (debugging) options, ${JSON.stringify(options)}`);
-    }
-    return options;
-}
-exports.processCommandLineArgs = processCommandLineArgs;
-//# sourceMappingURL=script.js.map

package/cli/common/scripts-info.d.ts

@@ -1,24 +0,0 @@
-/**
- * This file contains the references to all scripts, as well as their explanations and arguments.
- *
- * @module
- */
-import type { MergeableRecord } from '../../util/objects';
-import type { OptionDefinition } from 'command-line-usage';
-interface BaseScriptInformation extends MergeableRecord {
-    toolName: string;
-    target: string;
-    description: string;
-    usageExample: string;
-    options: OptionDefinition[];
-}
-export interface MasterScriptInformation extends BaseScriptInformation {
-    type: 'master script';
-}
-export interface HelperScriptInformation extends BaseScriptInformation {
-    type: 'helper script';
-    masterScripts: string[];
-}
-export type ScriptInformation = MasterScriptInformation | HelperScriptInformation;
-export declare const scripts: Record<"slicer" | "benchmark" | "stats" | "summarizer" | "export-quads" | "stats-helper" | "benchmark-helper", ScriptInformation>;
-export {};

package/cli/common/scripts-info.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.scripts = void 0;
-const options_1 = require("./options");
-/**
- * We hold `_scripts` internally, as the modifiable variant and export the readonly scripts
- */
-const _scripts = {
-    'slicer': {
-        toolName: 'slicer',
-        target: 'slicer-app',
-        description: 'Static backwards executable slicer for R',
-        options: options_1.slicerOptions,
-        usageExample: 'slicer -c "12@product" test/testfiles/example.R',
-        type: 'master script',
-    },
-    'benchmark': {
-        toolName: 'benchmark',
-        target: 'benchmark-app',
-        description: 'Benchmark the static backwards slicer',
-        type: 'master script',
-        usageExample: 'benchmark "example-folder/"',
-        options: options_1.benchmarkOptions
-    },
-    'benchmark-helper': {
-        toolName: 'benchmark-single',
-        target: 'benchmark-helper-app',
-        description: 'Helper Script to Benchmark the Slicer',
-        usageExample: 'benchmark-single "example.R" --output "example.json"',
-        options: options_1.benchmarkHelperOptions,
-        type: 'helper script',
-        masterScripts: ['benchmark']
-    },
-    'summarizer': {
-        toolName: 'summarizer',
-        target: 'summarizer-app',
-        description: 'Summarize the results of the benchmark',
-        options: options_1.summarizerOptions,
-        usageExample: 'summarizer "benchmark.json"',
-        type: 'master script',
-    },
-    'export-quads': {
-        toolName: 'export-quads',
-        target: 'export-quads-app',
-        description: 'Export quads of the normalized AST of a given R code file',
-        usageExample: 'export-quads "example.R" --output "example.quads"',
-        options: options_1.exportQuadsOptions,
-        type: 'master script',
-    },
-    'stats': {
-        toolName: 'stats',
-        target: 'statistics-app',
-        description: 'Generate usage Statistics for R scripts',
-        options: options_1.statisticOptions,
-        usageExample: 'stats -i example.R --output-dir "output-folder/"',
-        type: 'master script',
-    },
-    'stats-helper': {
-        toolName: 'stats-helper',
-        target: 'statistics-helper-app',
-        description: 'Generate usage Statistics for a single R script (parallel helper for stats)',
-        options: options_1.statisticHelperOptions,
-        usageExample: 'stats-helper -i example.R --output-dir "output-folder/"',
-        type: 'helper script',
-        masterScripts: ['stats']
-    }
-};
-exports.scripts = _scripts;
-//# sourceMappingURL=scripts-info.js.map

package/cli/export-quads-app.d.ts

@@ -1,7 +0,0 @@
-export interface QuadsCliOptions {
-    verbose: boolean;
-    help: boolean;
-    input: string[];
-    limit: number;
-    output: string | undefined;
-}

package/cli/export-quads-app.js

@@ -1,46 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const r_bridge_1 = require("../r-bridge");
-const log_1 = require("../util/log");
-const quads_1 = require("../util/quads");
-const fs_1 = __importDefault(require("fs"));
-const files_1 = require("../util/files");
-const common_1 = require("./common");
-const options = (0, common_1.processCommandLineArgs)('export-quads', [], {
-    subtitle: 'Generate RDF N-Quads from the AST of a given R script',
-    examples: [
-        '{bold -i} {italic example.R} {bold --output} {italic "example.quads"}',
-        '{bold --help}'
-    ]
-});
-const shell = new r_bridge_1.RShell();
-shell.tryToInjectHomeLibPath();
-async function writeQuadForSingleFile(request, output) {
-    const normalized = await (0, r_bridge_1.retrieveNormalizedAstFromRCode)({
-        ...request,
-        ensurePackageInstalled: true
-    }, shell);
-    const serialized = (0, quads_1.serialize2quads)(normalized.ast, { context: request.content });
-    log_1.log.info(`Appending quads to ${output}`);
-    fs_1.default.appendFileSync(output, serialized);
-}
-async function getQuads() {
-    const output = options.output ?? 'out.quads';
-    let skipped = 0;
-    for await (const request of (0, files_1.allRFilesFrom)(options.input, options.limit)) {
-        try {
-            await writeQuadForSingleFile(request, output);
-        }
-        catch (e) {
-            log_1.log.error(`[Skipped] Error while processing ${request.content}: ${e.message} (${e.stack ?? ''})`);
-            skipped++;
-        }
-    }
-    console.log(`Skipped ${skipped} files`);
-    shell.close();
-}
-void getQuads();
-//# sourceMappingURL=export-quads-app.js.map

package/cli/repl/commands/cfg.d.ts

@@ -1,3 +0,0 @@
-import type { ReplCommand } from './main';
-export declare const controlflowCommand: ReplCommand;
-export declare const controlflowStarCommand: ReplCommand;