Skip to content

Latest commit

 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TinyML Core

TinyML Core is a little, faster and lightweight module that will help you to parse the source code of TinyML.

❌ Please don't use until we delete this message, this lib is under construction 🚫

Installation

npm install tinyml-core

Concept

The structure pattern is similar to HTML, you will get tags, content, params and comments.

HTML TinyML
<!DOCTYPE html>
<html lang="en">
    <head>
        <title>The page title</title>
    </head>
    <body>
        <!-- This is a comment -->
        <hr/>
        <div class="container">
            <h1>My first title</h1>
            <p>
                Lorem ipsum dolor sit<br>
                amet, consectetur
            <p>
        </div>
    </body>
</html>
{{{<!DOCTYPE html>}}}
html(lang="en") {
    head {
        title {The page title}
    }
    body {
        [ This is a comment ]
        hr;
        div(class="container") {
            h1 {My first title}
            p {
                Lorem ipsum dolor sit;br;
                amet, consectetur
            }
        }
    }
}

Functions

From Core

parse

❕ This method will help you to parse synchronically a TinyML-syntax source.

Return

✅ An array with the data

❌ Throw an error.

Params:

🔹 source: string - The source code to parse.

Example:
import { Core } from "tinyml-core/common";

try {
  var parsed = Core.parse(`
    thisIsATag(param1) {
        This is a raw content
        tag{This is raw content too}
        [This is a commentary]
    } Raw content again
`);
} catch (e) {
  console.error(e);
}

Data description

Core.parse returns an array of the following kind of elements if succedes:

  • Core.Element
  • Core.Raw
  • Core.Comment
  • Core.Code

Global methods & members

The following members & methods will be inherited by Core.Raw, Core.Element, Core.Comment and Core.Code

🔹 tokens: Token[] - All tokens catched for the instance.

🔹 isRaw(): boolean - Checks if the instance is a Core.Raw instance.

🔹 isElement(): boolean - Checks if the instance is a Core.Element instance.

🔹 isComment(): boolean - Checks if the instance is a Core.Comment instance.

🔹 isCode(): boolean - Checks if the instance is a Core.Code instance.

🔹 toString(): string - A string representation of all tokens contained in the instance.

The Token data type

This data type contains information about an element of the source code. It has the following members:

🔹 text: string - The string of the token.

🔹 pos: TokenPosition /* {x: number, y: number} */ - The location of the token in the source code.

🔹 text: TokenType - The token type.

Core.Element

This data type defines an element. It is composed by the following members.

🔹 tag: Token - The token that contain the tag name and location. The type ever will be TokenType.identifier.

🔹 params: Token[] - All tokens that compounds the parameters.

🔹 children: (Core.Element | Core.Raw | Core.Comment | Core.Code)[] | undefined - The content inside of. An array of TinyML elements or undefined.

Core.Raw

This data type different to Core.Element element, generally the content of this last one.

Does not contain new methods or members by itself.

Core.Comment

This data type defines the content between [ and ] characters.

Does not contain new methods or members by itself.

Core.Code

This data type defines the content between unnamed {{{ and }}} characters. All content inside these delimiters is treated as raw code and is not parsed recursively.

Named Block Unnamed Block Raw Code Block
namedBlock {
    content of named block
}
{
    content of unnamed block
}
{{{
    raw content { with braces }
}}}

About

TinyML code parser for NodeJS

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages