custom-tslint-rules

    3.0.0 • Public • Published

    Build Status Coverage Status dependencies dev-dependencies

    NPM

    tslint-rules

    A set of custom TSLint rules.

    Usage

    Install from npm to your devDependencies:

    npm install --save-dev custom-tslint-rules
    

    Configure tslint to use the custom-tslint-rules folder:

    Add the following path to the rulesDirectory setting in your tslint.json file:

    {
       "rulesDirectory": [
         "node_modules/custom-tslint-rules/dist"
       ],
       "rules": {
         ...
       }
    }

    Now configure some of the new rules.

    Available Rules

    import-barrels

    Enforces usage of barrels (index.ts) when importing from a directory that has a barrel file.

    Rationale:

    Allows directories that contain multiple modules to be handled as a single module with a single public interface and opaque inner structure.

    This rule works only for ES2015 module syntax import statements and checks only relative module paths.

    Usage:

    "import-barrels"[
      true,
      {"noExplicitBarrels": false, "fileExtensions": ["ts", "js"]}
    ]

    Options:

    An argument object may be optionally provided, with the following properties:

    • noExplicitBarrels = false: disallows usage of explicitly named barrels in import statements (import foo from './foo/index')
    • fileExtensions = ['ts', 'js']: uses the provided file extensions for module and barrel file lookup
    • fixWithExplicitBarrelImport: uses the provided string to replace non-barrel imports in --fix mode (i.e. when set to 'index', import foo from './foo/some-module' becomes import foo from './foo/index')

    jasmine-no-lambda-expression-callbacks

    Disallows usage of ES6-style lambda expressions as callbacks to Jasmine BDD functions.

    Rationale:

    Lambda expressions don't create lexical this bindings in order for this bindings from outer function scopes to be visible inside of lambda expressions. This beats Jasmine's own system of managing shared state by passing in a dictionary object as this reference to the user-provided callbacks to take over the memory management from the JavaScript VM to prevent memory leaks during test runs.

    This rule will also check for cases where a call to a function is made with a lambda expression parameter instead of passing a lambda expression directly as callback to support Angular 2 test style:

    beforeEach(async(() => {
      ...
    }));
     
    it('something', inject([Service], (service) => {
      ...
    }))

    Usage:

    "jasmine-no-lambda-expression-callbacks"true

    Options:

    Not configurable.

    Contributions and Development

    Issue reports and pull requests are highly welcome! Please make sure to provide sensible tests along with your pull request.

    To get started with development, clone the project and run npm install. To run the tests execute npm test. npm run cover will run the tests along with generating a coverage report.

    Install

    npm i custom-tslint-rules

    DownloadsWeekly Downloads

    11

    Version

    3.0.0

    License

    MIT

    Last publish

    Collaborators

    • bendingbender