greybel-interpreter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 swe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# greybel-interpreter
+
+[![greybel-interpreter](https://circleci.com/gh/ayecue/greybel-interpreter.svg?style=svg)](https://circleci.com/gh/ayecue/greybel-interpreter)

package/dist/context.d.ts

@@ -0,0 +1,68 @@
+import { Operation } from './types/operation';
+import { Expression } from './types/expression';
+import { Callable } from './types/custom-type';
+import CPS from './cps';
+export declare enum ContextType {
+    API = "API",
+    GLOBAL = "GLOBAL",
+    FUNCTION = "FUNCTION",
+    INJECTION = "INJECTION",
+    LOOP = "LOOP",
+    MAP = "MAP",
+    CALL = "CALL"
+}
+export declare enum ContextState {
+    TEMPORARY = "TEMPORARY",
+    DEFAULT = "DEFAULT"
+}
+export declare class Scope {
+    context: OperationContext;
+    refs: Map<string, any>;
+    constructor(context: OperationContext);
+    valueOf(): Map<string, any>;
+    extend(map?: Map<string, any>): Scope;
+    set(path: string[], value: any): Promise<void>;
+    get(path: string[]): Promise<any>;
+    getCallable(path: string[]): Promise<Callable>;
+}
+export declare class Debugger {
+    breakpoint: boolean;
+    nextStep: boolean;
+    lastContext: OperationContext | null;
+    constructor();
+    raise(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    setBreakpoint(state: boolean): Debugger;
+    getBreakpoint(): boolean;
+    next(): Debugger;
+    resume(): Promise<void>;
+    interact(operationContext: OperationContext, item: Operation | Expression): void;
+    run(code: string): Promise<void>;
+}
+export interface OperationContextOptions {
+    isProtected?: boolean;
+    type?: string;
+    state?: string;
+    previous?: OperationContext;
+    debugger?: Debugger;
+    cps?: CPS;
+}
+export declare class OperationContext {
+    debugger: Debugger;
+    previous: OperationContext | null;
+    type: string;
+    state: string;
+    scope: Scope;
+    isProtected: boolean;
+    memory: Map<string, any>;
+    cps: CPS | null;
+    constructor(options: OperationContextOptions);
+    valueOf(): Map<string, any>;
+    extend(map: Map<string, any>): OperationContext;
+    set(path: any[], value: any): Promise<OperationContext>;
+    get(path: any[]): any;
+    setMemory(key: string, value: any): OperationContext;
+    getMemory(key: string): any;
+    getCallable(path: string[]): Promise<Callable>;
+    fork(type: string, state: string): OperationContext;
+}

package/dist/context.js

@@ -0,0 +1,399 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationContext = exports.Debugger = exports.Scope = exports.ContextState = exports.ContextType = void 0;
+var boolean_1 = __importDefault(require("./custom-types/boolean"));
+var number_1 = __importDefault(require("./custom-types/number"));
+var string_1 = __importDefault(require("./custom-types/string"));
+var nil_1 = __importDefault(require("./custom-types/nil"));
+var custom_type_1 = require("./types/custom-type");
+var greybel_core_1 = require("greybel-core");
+var ContextType;
+(function (ContextType) {
+    ContextType["API"] = "API";
+    ContextType["GLOBAL"] = "GLOBAL";
+    ContextType["FUNCTION"] = "FUNCTION";
+    ContextType["INJECTION"] = "INJECTION";
+    ContextType["LOOP"] = "LOOP";
+    ContextType["MAP"] = "MAP";
+    ContextType["CALL"] = "CALL";
+})(ContextType = exports.ContextType || (exports.ContextType = {}));
+var ContextState;
+(function (ContextState) {
+    ContextState["TEMPORARY"] = "TEMPORARY";
+    ContextState["DEFAULT"] = "DEFAULT";
+})(ContextState = exports.ContextState || (exports.ContextState = {}));
+var Scope = /** @class */ (function () {
+    function Scope(context) {
+        var me = this;
+        me.context = context;
+        me.refs = new Map();
+    }
+    Scope.prototype.valueOf = function () {
+        return this.refs;
+    };
+    Scope.prototype.extend = function (map) {
+        if (map === void 0) { map = new Map(); }
+        var me = this;
+        me.refs = new Map(__spreadArray(__spreadArray([], __read(me.refs.entries()), false), __read(map.entries()), false));
+        return me;
+    };
+    Scope.prototype.set = function (path, value) {
+        return __awaiter(this, void 0, void 0, function () {
+            var me, traversalPath, refs, last, current, origin;
+            return __generator(this, function (_a) {
+                me = this;
+                traversalPath = [].concat(path);
+                refs = me.refs;
+                last = traversalPath.pop();
+                current = traversalPath.shift();
+                origin = refs;
+                if (current != null) {
+                    if (origin.has(current)) {
+                        origin = origin.get(current);
+                        if (origin instanceof custom_type_1.CustomObjectType ||
+                            origin instanceof Scope) {
+                            return [2 /*return*/, origin.set(traversalPath.concat([last]), value)];
+                        }
+                    }
+                    else if (me.context.previous && !me.context.previous.isProtected) {
+                        me.context.previous.set(path, value);
+                        return [2 /*return*/];
+                    }
+                    else if (traversalPath.length > 0) {
+                        throw new Error("Cannot set path ".concat(path.join('.')));
+                    }
+                }
+                if (origin &&
+                    !(origin instanceof boolean_1.default) &&
+                    !(origin instanceof string_1.default) &&
+                    !(origin instanceof number_1.default) &&
+                    !(origin instanceof nil_1.default)) {
+                    origin.set(last, value);
+                }
+                else {
+                    throw new Error("Cannot set path ".concat(path.join('.')));
+                }
+                return [2 /*return*/];
+            });
+        });
+    };
+    Scope.prototype.get = function (path) {
+        return __awaiter(this, void 0, void 0, function () {
+            var me, traversalPath, refs, current, context, origin;
+            return __generator(this, function (_a) {
+                me = this;
+                traversalPath = [].concat(path);
+                refs = me.refs;
+                current = traversalPath.shift();
+                origin = refs;
+                if (current != null) {
+                    if (origin.has(current)) {
+                        context = origin;
+                        origin = origin.get(current);
+                        if (traversalPath.length > 0 &&
+                            (origin instanceof custom_type_1.CustomObjectType ||
+                                origin instanceof Scope)) {
+                            return [2 /*return*/, origin.get(traversalPath)];
+                        }
+                    }
+                    else if (me.context.previous) {
+                        return [2 /*return*/, me.context.previous.get(path)];
+                    }
+                    else {
+                        throw new Error("Cannot get path ".concat(path.join('.')));
+                    }
+                }
+                else {
+                    return [2 /*return*/, null];
+                }
+                return [2 /*return*/, origin];
+            });
+        });
+    };
+    Scope.prototype.getCallable = function (path) {
+        return __awaiter(this, void 0, void 0, function () {
+            var me, traversalPath, refs, current, origin, context;
+            return __generator(this, function (_a) {
+                me = this;
+                traversalPath = [].concat(path);
+                refs = me.refs;
+                current = traversalPath.shift();
+                origin = refs;
+                if (current != null) {
+                    if (origin.has(current)) {
+                        context = origin;
+                        origin = origin.get(current);
+                        if (origin instanceof custom_type_1.CustomObjectType ||
+                            origin instanceof Scope) {
+                            return [2 /*return*/, origin.getCallable(traversalPath)];
+                        }
+                    }
+                    else if (me.context.previous) {
+                        return [2 /*return*/, me.context.previous.getCallable(path)];
+                    }
+                    else {
+                        throw new Error("Cannot get path ".concat(path.join('.')));
+                    }
+                }
+                return [2 /*return*/, {
+                        origin: origin,
+                        context: context
+                    }];
+            });
+        });
+    };
+    return Scope;
+}());
+exports.Scope = Scope;
+var Debugger = /** @class */ (function () {
+    function Debugger() {
+        var me = this;
+        me.breakpoint = false;
+        me.nextStep = false;
+        me.lastContext = null;
+    }
+    Debugger.prototype.raise = function (message) {
+        var args = [];
+        for (var _i = 1; _i < arguments.length; _i++) {
+            args[_i - 1] = arguments[_i];
+        }
+        throw new Error(message);
+    };
+    Debugger.prototype.debug = function (message) {
+        var args = [];
+        for (var _i = 1; _i < arguments.length; _i++) {
+            args[_i - 1] = arguments[_i];
+        }
+        console.info.apply(console, __spreadArray([message], __read(args), false));
+    };
+    Debugger.prototype.setBreakpoint = function (state) {
+        var me = this;
+        me.breakpoint = state;
+        return me;
+    };
+    Debugger.prototype.getBreakpoint = function () {
+        return this.breakpoint;
+    };
+    Debugger.prototype.next = function () {
+        var me = this;
+        me.nextStep = true;
+        return me;
+    };
+    Debugger.prototype.resume = function () {
+        var me = this;
+        if (!me.breakpoint) {
+            return Promise.resolve();
+        }
+        return new Promise(function (resolve) {
+            var check = function () {
+                if (!me.breakpoint) {
+                    resolve();
+                }
+                else if (me.nextStep) {
+                    me.nextStep = false;
+                    resolve();
+                }
+                else {
+                    setImmediate(check);
+                }
+            };
+            setImmediate(check);
+        });
+    };
+    Debugger.prototype.interact = function (operationContext, item) {
+        var me = this;
+        console.warn("Debugger is not setup.");
+        console.info(operationContext);
+        me.lastContext = operationContext;
+        me.breakpoint = false;
+    };
+    Debugger.prototype.run = function (code) {
+        return __awaiter(this, void 0, void 0, function () {
+            var me, parser, chunk, item, context, err_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        me = this;
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        parser = new greybel_core_1.Parser(code);
+                        chunk = parser.parseChunk();
+                        item = me.lastContext.cps.visit(chunk);
+                        context = me.lastContext.fork(ContextType.INJECTION, ContextState.TEMPORARY);
+                        return [4 /*yield*/, item.run(context)];
+                    case 2:
+                        _a.sent();
+                        return [3 /*break*/, 4];
+                    case 3:
+                        err_1 = _a.sent();
+                        console.error(err_1);
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return Debugger;
+}());
+exports.Debugger = Debugger;
+var OperationContext = /** @class */ (function () {
+    function OperationContext(options) {
+        var me = this;
+        me.previous = options.previous || null;
+        me.type = options.type || ContextType.API;
+        me.state = options.state || ContextState.DEFAULT;
+        me.scope = new Scope(me);
+        me.isProtected = options.isProtected || false;
+        me.memory = new Map();
+        me.debugger = options.debugger || new Debugger();
+        me.cps = options.cps;
+    }
+    OperationContext.prototype.valueOf = function () {
+        return this.scope.valueOf();
+    };
+    OperationContext.prototype.extend = function (map) {
+        var _a;
+        var me = this;
+        if (me.state === ContextState.TEMPORARY) {
+            (_a = me.previous) === null || _a === void 0 ? void 0 : _a.extend(map);
+        }
+        else {
+            me.scope.extend(map);
+        }
+        return me;
+    };
+    OperationContext.prototype.set = function (path, value) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var me;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        me = this;
+                        if (!(me.state === ContextState.TEMPORARY)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, ((_a = me.previous) === null || _a === void 0 ? void 0 : _a.set(path, value))];
+                    case 1:
+                        _b.sent();
+                        return [3 /*break*/, 4];
+                    case 2: return [4 /*yield*/, me.scope.set(path, value)];
+                    case 3:
+                        _b.sent();
+                        _b.label = 4;
+                    case 4: return [2 /*return*/, me];
+                }
+            });
+        });
+    };
+    OperationContext.prototype.get = function (path) {
+        var _a;
+        var me = this;
+        if (me.state === ContextState.TEMPORARY) {
+            return (_a = me.previous) === null || _a === void 0 ? void 0 : _a.get(path);
+        }
+        return me.scope.get(path);
+    };
+    OperationContext.prototype.setMemory = function (key, value) {
+        var me = this;
+        me.memory.set(key, value);
+        return me;
+    };
+    OperationContext.prototype.getMemory = function (key) {
+        var me = this;
+        return me.memory.get(key);
+    };
+    OperationContext.prototype.getCallable = function (path) {
+        var _a;
+        var me = this;
+        if (me.state === ContextState.TEMPORARY) {
+            return (_a = me.previous) === null || _a === void 0 ? void 0 : _a.getCallable(path);
+        }
+        return me.scope.getCallable(path);
+    };
+    OperationContext.prototype.fork = function (type, state) {
+        var me = this;
+        var opc = new OperationContext({
+            previous: me,
+            type: type,
+            state: state,
+            debugger: me.debugger,
+            cps: me.cps
+        });
+        if (me.type === ContextType.FUNCTION || me.type === ContextType.GLOBAL) {
+            opc.scope.refs.set('locals', opc.scope);
+        }
+        if (type !== ContextType.FUNCTION) {
+            if (type !== ContextType.LOOP) {
+                opc.setMemory('loopContext', me.getMemory('loopContext'));
+            }
+            opc.setMemory('functionContext', me.getMemory('functionContext'));
+        }
+        return opc;
+    };
+    return OperationContext;
+}());
+exports.OperationContext = OperationContext;

package/dist/cps.d.ts

@@ -0,0 +1,15 @@
+import { ASTBase } from 'greybel-core';
+import { ResourceHandler } from './resource';
+export interface CPSMapType {
+    [key: string]: (item: ASTBase) => any;
+}
+export interface CPSMapContext {
+    target: string;
+    resourceHandler: ResourceHandler;
+}
+export declare const CPSMap: (visit: (o: ASTBase) => any, context: CPSMapContext) => CPSMapType;
+export default class CPS {
+    cpsMap: CPSMapType;
+    constructor(context: CPSMapContext);
+    visit(o: ASTBase): any;
+}