]> git.kianting.info Git - clo/blobdiff - src/index.js
add readme
[clo] / src / index.js
index 00c72f49471b506f9f0f540322eb770a8a208e8d..411e166d95894b49998c1f4b59f51f567f5a11d5 100644 (file)
@@ -1,7 +1,73 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.thenDo = exports.charToCodepoint = exports.match1Char = void 0;
+exports.tokenize = exports.zeroOrOnceDo = exports.notDo = exports.zeroOrMoreDo = exports.orDo = exports.thenDo = exports.charToCodepoint = exports.matchRange = exports.matchAny = exports.match1Char = exports.TokenType = void 0;
 var fs = require('fs');
+/**
+ * wrap a x in a `Some(T)`
+ * @param x : variable to be wrapped.
+ * @returns wrapped `x`.
+ */
+function toSome(x) {
+    return { _tag: "Some", value: x };
+}
+/**
+ * The types of Token
+ *    NL, // newline
+ *
+ *   SP, // half-width space and tab
+ *
+ * ID, // identifier
+ *
+ * STR, // string
+ *
+ * OP, // operator or something like it
+ *
+ * FLO, // float num
+ *
+ * INT, // integer
+ *
+ * I_* // integer manipulation
+ *
+ * F_* // float manipulation
+ *
+ * SEMI_C// semi-colon
+ */
+var TokenType;
+(function (TokenType) {
+    TokenType[TokenType["NL"] = 0] = "NL";
+    TokenType[TokenType["SP"] = 1] = "SP";
+    TokenType[TokenType["ID"] = 2] = "ID";
+    TokenType[TokenType["STR"] = 3] = "STR";
+    TokenType[TokenType["FLO"] = 4] = "FLO";
+    TokenType[TokenType["INT"] = 5] = "INT";
+    TokenType[TokenType["F_ADD"] = 6] = "F_ADD";
+    TokenType[TokenType["F_SUB"] = 7] = "F_SUB";
+    TokenType[TokenType["F_MUL"] = 8] = "F_MUL";
+    TokenType[TokenType["F_DIV"] = 9] = "F_DIV";
+    TokenType[TokenType["I_ADD"] = 10] = "I_ADD";
+    TokenType[TokenType["I_SUB"] = 11] = "I_SUB";
+    TokenType[TokenType["I_MUL"] = 12] = "I_MUL";
+    TokenType[TokenType["I_DIV"] = 13] = "I_DIV";
+    TokenType[TokenType["L_PAREN"] = 14] = "L_PAREN";
+    TokenType[TokenType["R_PAREN"] = 15] = "R_PAREN";
+    TokenType[TokenType["L_BRACK"] = 16] = "L_BRACK";
+    TokenType[TokenType["R_BRACK"] = 17] = "R_BRACK";
+    TokenType[TokenType["L_BRACE"] = 18] = "L_BRACE";
+    TokenType[TokenType["R_BRACE"] = 19] = "R_BRACE";
+    TokenType[TokenType["COMMA"] = 20] = "COMMA";
+    TokenType[TokenType["DOT"] = 21] = "DOT";
+    TokenType[TokenType["COLON"] = 22] = "COLON";
+    TokenType[TokenType["SEMI_C"] = 23] = "SEMI_C";
+    TokenType[TokenType["AT"] = 24] = "AT";
+    TokenType[TokenType["HASH"] = 25] = "HASH";
+    TokenType[TokenType["EQ"] = 26] = "EQ";
+    TokenType[TokenType["SET"] = 27] = "SET";
+    TokenType[TokenType["GT"] = 28] = "GT";
+    TokenType[TokenType["LT"] = 29] = "LT";
+    TokenType[TokenType["GE"] = 30] = "GE";
+    TokenType[TokenType["LE"] = 31] = "LE";
+    TokenType[TokenType["R_ARROW"] = 32] = "R_ARROW";
+})(TokenType || (exports.TokenType = TokenType = {}));
 /**
  * @description
  * it returns a function which test if the first char of the `remained` part of
@@ -12,6 +78,9 @@ var fs = require('fs');
  */
 function match1Char(c) {
     return (m) => {
+        if (m.remained.length == 0) {
+            return { _tag: "None" };
+        }
         const charToBeMatched = m.remained[0];
         if (charToBeMatched === c) {
             return { _tag: "Some", value: {
@@ -26,6 +95,58 @@ function match1Char(c) {
 }
 exports.match1Char = match1Char;
 ;
+/**
+ *
+ * @param m : the `MatcheePair` to be consumed.
+ * @returns if the length of `m.remained` >= 1; consumes the matchee by 1 char and wraps it in `Some`,
+ * otherwise, returns `None`.
+ */
+function matchAny(m) {
+    if (m.remained.length >= 1) {
+        return { _tag: "Some", value: {
+                matched: m.matched + m.remained[0],
+                remained: m.remained.substring(1)
+            } };
+    }
+    else {
+        return { _tag: "None" };
+    }
+}
+exports.matchAny = matchAny;
+/**
+ * @description
+ * it returns a function which test if the first char of the `remained` part of
+ *  the argument of the function is between `l` and `u`, if it's true, update the `MatchedPair` wrapped
+ * in `Some`. Otherwise, it returns `None`.
+ *  * @param l : lower bound char, 1-char string
+ *  * @param u : upper bound char, 1-char string
+ * @returns the updated `MatchedPair` wrapped in `Some(x)` or `None`.
+ */
+function matchRange(l, u) {
+    let lCodepoint = charToCodepoint(l);
+    let uCodepoint = charToCodepoint(u);
+    if (l > u) {
+        throw new Error("Error: the codepoint of `" + l + "` is not smaller than `" + u + "`)");
+    }
+    return (m) => {
+        if (m.remained.length < 1) {
+            return { _tag: "None" };
+        }
+        const charToBeMatched = m.remained[0];
+        const codePointToBeMatched = charToCodepoint(charToBeMatched);
+        if (codePointToBeMatched >= lCodepoint && codePointToBeMatched <= uCodepoint) {
+            return { _tag: "Some", value: {
+                    matched: m.matched + charToBeMatched,
+                    remained: m.remained.substring(1)
+                } };
+        }
+        else {
+            return { _tag: "None" };
+        }
+    };
+}
+exports.matchRange = matchRange;
+;
 /**
  * convert the one-char string to codepoint.
  * @param s : the string to code point.
@@ -44,6 +165,10 @@ exports.charToCodepoint = charToCodepoint;
 /**
  *  @description thendo(input, f, ...) like
  * a ==> f
+ * @param input: the wrapped input.
+ * @param f: the function to be applied.
+ *
+ * @returns:the applied wrapped result `MatcheePair`.
  */
 function thenDo(input, f) {
     if (input._tag == "None") {
@@ -55,3 +180,225 @@ function thenDo(input, f) {
     }
 }
 exports.thenDo = thenDo;
+/**
+ * @description "or", like the regex `( f1 | f2 )` .
+ * It returns a function `f` of which the argument is`x`.
+ * if `f1(x)` is None, then `f` returns `f2(x)`. Otherwise,
+ * `F` returns `f1(x)`.
+ * @param f1 : 1st function to be compared
+ * @param f2 : 2nd function to be compared
+ * @returns:the combined function
+ */
+function orDo(f1, f2) {
+    return (x) => {
+        let f1x = (f1(x));
+        {
+            if (f1x._tag == "None") {
+                return f2(x);
+            }
+            else {
+                return f1x;
+            }
+        }
+    };
+}
+exports.orDo = orDo;
+/**
+* @description repeating matching function `f`
+* zero or more times, like the asterisk `*` in regex `f*` .
+* @param f : the function to be repeated 0+ times.
+* @returns:the combined function
+*/
+function zeroOrMoreDo(f) {
+    return (x) => {
+        var wrapped_old_x = { _tag: "Some", value: x };
+        var wrapped_new_x = wrapped_old_x;
+        while (wrapped_new_x._tag != "None") {
+            wrapped_old_x = wrapped_new_x;
+            wrapped_new_x = thenDo(wrapped_old_x, f);
+        }
+        ;
+        return wrapped_old_x;
+    };
+}
+exports.zeroOrMoreDo = zeroOrMoreDo;
+/**
+* @description Not. like the `^` inside regex of [^f].
+* returns a function `F(x)` such that if  `f(x)` is `None`,
+* returns the x consuming a char; if `f(x)` is not None, F(x)
+* returns `None`.
+* @param f: the function forbidden to be matched.
+* @returns: combined function `F`.
+*/
+function notDo(f) {
+    return (x) => {
+        let wrapped_x = {
+            _tag: "Some",
+            value: x
+        };
+        let f_x = thenDo(wrapped_x, f);
+        if (f_x._tag != "None") {
+            return { _tag: "None" };
+        }
+        else {
+            return thenDo(wrapped_x, matchAny);
+        }
+    };
+}
+exports.notDo = notDo;
+/**
+ * if `x` is matched by `f` once, returns `f(x)`. Otherwise,
+ * returns x
+ * similar to `?` in regex `f?`.
+ * @param f : the function to be matched
+ * @returns return wrapped f(x)
+ */
+function zeroOrOnceDo(f) {
+    return (x) => {
+        var wrapped_old_x = { _tag: "Some", value: x };
+        var wrapped_new_x = thenDo(wrapped_old_x, f);
+        if (wrapped_new_x._tag != "None") {
+            return wrapped_new_x;
+        }
+        else {
+            return wrapped_old_x;
+        }
+    };
+}
+exports.zeroOrOnceDo = zeroOrOnceDo;
+function tokenize(input) {
+    var input_matchee_pair = toSome({ matched: "",
+        remained: input });
+    /**
+     * generate a parser of a basic term (b_term)
+     * @param pattern : the pattern parser
+     * @param token_type : the returning token type
+     * @returns a wrapped parser.
+     */
+    function bTerm(pattern, token_type) {
+        return (x) => {
+            let wrapped_x = toSome(x);
+            let result = pattern(wrapped_x);
+            if (result._tag == "Some") {
+                result.value.matched_type = token_type;
+            }
+            return result;
+        };
+    }
+    let d = matchRange('0', '9'); // \d
+    // [+-]
+    let plusMinus = orDo(match1Char('+'), match1Char('-'));
+    let s_aux = orDo(match1Char(' '), match1Char('\t')); // (" " | "\t")
+    // integer = ([+]|[-])?\d\d*
+    let integer = bTerm((x) => thenDo(thenDo(thenDo(x, zeroOrOnceDo(plusMinus)), d), zeroOrMoreDo(d)), TokenType.INT);
+    // space = [ \t]+
+    let space = bTerm((x) => thenDo(thenDo(x, s_aux), zeroOrMoreDo(s_aux)), TokenType.INT);
+    // newline = \r?\n
+    let newline = bTerm((x) => thenDo(thenDo(x, zeroOrOnceDo(match1Char('\r'))), match1Char('\n')), TokenType.NL);
+    // [_A-Za-z]
+    let idHead = orDo(orDo(matchRange('a', 'z'), matchRange('A', 'Z')), match1Char('_'));
+    let idRemained = orDo(idHead, matchRange('0', '9')); // [_A-Za-z0-9]
+    // id = [_A-Za-z][_A-Za-z0-9]*
+    let id = bTerm((x) => thenDo(thenDo(x, idHead), zeroOrMoreDo(idRemained)), TokenType.ID);
+    let doublequote = match1Char("\"");
+    // [\\][\"]
+    let escapeReverseSlash = (x) => thenDo(thenDo(toSome(x), match1Char("\\")), doublequote);
+    // ([\\]["]|[^\"])*
+    let stringInnerPattern = zeroOrMoreDo(orDo(escapeReverseSlash, notDo(match1Char("\""))));
+    // str = ["]([\\]["]|[^"])*["]
+    let str = bTerm((x) => thenDo(thenDo(thenDo(x, doublequote), stringInnerPattern), doublequote), TokenType.STR);
+    // float = [+-]?\d+[.]\d+
+    function floatPattern(x) {
+        return thenDo(thenDo(thenDo(thenDo(thenDo(thenDo(x, zeroOrOnceDo(plusMinus)), d), zeroOrMoreDo(d)), match1Char(".")), d), zeroOrMoreDo(d));
+    }
+    ;
+    let float = bTerm(floatPattern, TokenType.FLO);
+    // operators
+    // +.
+    let floatAdd = bTerm((x) => thenDo(thenDo(x, match1Char("+")), match1Char(".")), TokenType.F_ADD);
+    // +.
+    let floatSub = bTerm((x) => thenDo(thenDo(x, match1Char("-")), match1Char(".")), TokenType.F_SUB);
+    // *.
+    let floatMul = bTerm((x) => thenDo(thenDo(x, match1Char("*")), match1Char(".")), TokenType.F_MUL);
+    // /.
+    let floatDiv = bTerm((x) => thenDo(thenDo(x, match1Char("/")), match1Char(".")), TokenType.F_DIV);
+    // ==
+    let eq = bTerm((x) => thenDo(thenDo(x, match1Char("=")), match1Char("=")), TokenType.EQ);
+    // >=
+    let ge = bTerm((x) => thenDo(thenDo(x, match1Char(">")), match1Char("=")), TokenType.GE);
+    // <=
+    let le = bTerm((x) => thenDo(thenDo(x, match1Char("<")), match1Char("=")), TokenType.LE);
+    // ->
+    let rightArrow = bTerm((x) => thenDo(thenDo(x, match1Char("-")), match1Char(">")), TokenType.R_ARROW);
+    /**
+     * unary operator : generating the pattern of basic unary operator
+     * @param char : uniry char for the operator
+     * @param token_type : the corresponding token_type
+     */
+    function unaryOp(char, token_type) {
+        return bTerm((x) => thenDo(x, match1Char(char)), token_type);
+    }
+    ;
+    let intAdd = unaryOp('+', TokenType.I_ADD);
+    let intSub = unaryOp('-', TokenType.I_SUB);
+    let intMul = unaryOp('*', TokenType.I_MUL);
+    let intDiv = unaryOp('/', TokenType.I_DIV);
+    let lParen = unaryOp('(', TokenType.L_PAREN);
+    let rParen = unaryOp(')', TokenType.R_PAREN);
+    let lBracket = unaryOp('[', TokenType.L_BRACK);
+    let rBracket = unaryOp(']', TokenType.R_BRACK);
+    let lBrace = unaryOp('{', TokenType.L_BRACE);
+    let rBrace = unaryOp('}', TokenType.R_BRACE);
+    let comma = unaryOp(',', TokenType.COMMA);
+    let dot = unaryOp('.', TokenType.DOT);
+    let colon = unaryOp(':', TokenType.COLON);
+    let semicolon = unaryOp(';', TokenType.SEMI_C);
+    let at = unaryOp('@', TokenType.AT);
+    let hash = unaryOp('#', TokenType.HASH);
+    let set = unaryOp('=', TokenType.SET);
+    let greaterthan = unaryOp('>', TokenType.GT);
+    let lessthan = unaryOp('<', TokenType.LE);
+    let term = (token_list, x) => {
+        var ln = 1;
+        var col = 0;
+        var old_x = x;
+        let term_list = [float, newline, space, integer, str, id,
+            floatAdd, floatSub, floatMul, floatDiv,
+            intAdd, intSub, intMul, intDiv,
+            eq, ge, le, rightArrow,
+            lParen, rParen, lBracket, rBracket, lBrace, rBrace,
+            comma, dot, colon, semicolon, at, hash,
+            set, greaterthan, lessthan];
+        let term_aux = term_list.reduce((x, y) => orDo(x, y));
+        var new_x = thenDo(old_x, term_aux);
+        while (new_x._tag != "None") {
+            if (new_x.value.matched_type != TokenType.NL) {
+                col += new_x.value.matched.length;
+                token_list.push({ text: new_x.value.matched,
+                    type: new_x.value.matched_type,
+                    ln: ln,
+                    col: col });
+            }
+            else {
+                col = 0;
+                ln += 1;
+                token_list.push({ text: new_x.value.matched,
+                    type: new_x.value.matched_type,
+                    ln: ln,
+                    col: col });
+            }
+            old_x = toSome({ matched: "",
+                remained: new_x.value.remained });
+            new_x = thenDo(old_x, term_aux);
+        }
+        if (old_x.value.remained.length) {
+            console.log(token_list);
+            throw new Error("the code can't be tokenized is near Ln. " + ln + ", Col." + col
+                + ", starting with " + old_x.value.remained.substring(0, 10));
+        }
+        return token_list;
+    };
+    console.log(term([], input_matchee_pair));
+    // TODO: id, string, space, basic operator, 3 marks: @, {, }.
+}
+exports.tokenize = tokenize;