Have ideas to improve npm?Join in the discussion! »

    @straits/babel-plugin

    1.0.0 • Public • Published

    @straits/babel-plugin npm (scoped) NpmLicense David Travis (.com) Coveralls github

    A babel7 parser and plugin implementing the straits syntax.

    Note: the babel6 version is available on the babel6 branch or as straits-babel@babel6 on npm.

    Installation

    npm install --save-dev @straits/babel-plugin

    Usage

    The easiest way to get started, is by initializing a new project using npm init @straits.

    That will lead you through the creation of a new node project, with all the dev dependencies already in package.json and optionally setting up mocha and ESLint to use the straits syntax. You're left to run npm install to actually install the dev dependencies, and npm start to run a simple Hello World. npm run prepare (automatically executed both by npm install and npm publish) will transpile the straits syntax source code into regular JavaScript in the dist/ directory.

    If you want to manually configure babel to use the straits syntax, just use @straits as a babel plugin. For instance, after installing @babel/cli:

    npx babel --plugins='@straits' your_straits_file.js

    Straits syntax

    The straits syntax transpiles the use straits statement and .* expression. These ease the usage of traits, implemented as symbol properties (see the Iteration protocols for an example of symbol properties implemented as traits in the ECMAScript standard).

    The straits syntax offers several advantages over its alternatives:

    • it makes the code easier to write, read and understand,
    • it makes sure that the traits you access are offered by exactly one trait set you're using,
    • it doesn't pollute nor conflict with the normal scope variables.

    Examples

    Let's see a minimal example:

    use traits * from Symbol;
    [].*iterator();
    // is equivalent to...
    [][Symbol.iterator]();

    Let's look at a more complete one:

    const {TraitSet} = require('straits').utils;
    const traitSet1 = new TraitSet('duplicatedTrait', 'trait1');
    const traitSet2 = new TraitSet('duplicatedTrait', 'trait2');
     
    // an object we're going to assign traits to
    const object = {};
     
    // static error:
    //   .* used outside a `use traits` scope.
    //object.*trait1 = {};
     
    use traits * from traitSet1;
    use traits * from traitSet2;
     
     
    // the following variables won't be used.
    // they're here to show that variables won't interfere with traits
    const duplicatedTrait = {}, trait1 = {}, missingTrait = {};
     
    // the following line would throw an exception:
    //   No trait set is providing symbol missingTrait.
    //object.*missingTrait = {};
     
    // the following line would throw an exception:
    //   Symbol duplicatedTrait offered by multiple trait sets.
    //object.*duplicatedTrait = {};
     
    // the following lines are working as expected
    object.*trait1 = `a trait`;
    object.*trait2 = function() {
        console.log( `Greetings from ${this.*trait1}` );
    }
    object.*trait2(); // prints `Greetings from a trait`

    Install

    npm i @straits/babel-plugin

    DownloadsWeekly Downloads

    1

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    16.8 kB

    Total Files

    4

    Last publish

    Collaborators

    • avatar