1.0.0 • Published 5 years ago

sweet-syntax v1.0.0

Weekly downloads
8
License
MIT
Repository
github
Last release
5 years ago

npm.io

npm install size

Add syntactic sugar to any language!

Install

Install sweet-syntax globally using npm:

npm install sweet-syntax -g

Usage

Once the installation is done, you can run the command inside your project's directory with your input and output file.

sweet-syntax input.myts output.ts

By default sweet-syntax will search the root of the current directory for a sweet-syntax.json file that contains your syntax configuration.

If the config file is located somewhere else, use the --config or -c argument with its path.

sweet-syntax input.myjs output.js -c configs/sweet-syntax.json

Finally, run this command to see a list of all available options:

sweet-syntax --help

As a loadable module

You can also use sweet-syntax as a module in your code.
First install it locally using npm:

npm install --save sweet-syntax

Then require and use it in your code:

const sweetSyntax = require('sweet-syntax');
const config = {
    objects: {
       HELLO: 'console.log'
    },
    keywords: {
        END: ';'
    }
}
const input = 'HELLO("Hello World")END';
const output = sweetSyntax.sweeten(config, input);

console.log(output);

// Output:
// console.log("Hello World");

Config

The config file should be named sweet-syntax.json and adopt the following structure:

{
    "keywords": {
        "LOOP": "for",
        "CHECK": "if",
        ...
    },
    "objects": {
        "LOG": "console.log",
        ... 
    },
    "operators": {
        "EQL": "===",
        "NQL": "!==",
        ...
    },
    "characters": {
        "{{": "",
        "}}": "",
        ...
    }
}

At least one object e.g. keywords must be provided by the config.

Examples

You can see examples of custom syntactic sugar under the examples folder:

License

Code released under the MIT License.

Enjoy ⭐️