Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/meteor/eslint-plugin-meteor

🧐 Meteor specific linting rules for ESLint
https://github.com/meteor/eslint-plugin-meteor

eslint eslint-plugin-meteor meteor

Last synced: about 1 month ago
JSON representation

🧐 Meteor specific linting rules for ESLint

Host: GitHub
URL: https://github.com/meteor/eslint-plugin-meteor
Owner: meteor
License: mit
Archived: true
Created: 2015-09-24T17:03:56.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2021-10-02T07:41:19.000Z (about 3 years ago)
Last Synced: 2024-05-19T05:33:46.376Z (6 months ago)
Topics: eslint, eslint-plugin-meteor, meteor
Language: JavaScript
Homepage: https://medium.com/@dferber90/8f229ebc7942
Size: 3.8 MB
Stars: 118
Watchers: 17
Forks: 20
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-meteor - ESLint-plugin-Meteor - ESLint plugin for Meteor.js. (Packages)

README

        # ESLint-plugin-Meteor

Meteor specific linting rules for ESLint

[![Build Status][actions-image]][actions-url]

[![Coverage Status][coverage-image]][coverage-url]

[![Dependency Status][deps-image]][deps-url]

[![Join the chat at https://gitter.im/dferber90/eslint-plugin-meteor][gitter-image]][gitter-url]

[![Maintenance Status][status-image]][status-url]

[![semantic-release][semantic-release-image]][semantic-release]

[![Commitizen friendly][commitizen-image]][commitizen]

[![License][license-image]][license-url]

[![NPM version][npm-image]][npm-url]

[![NPM downloads][npm-downloads-image]][npm-downloads-url]

> This repository has been merged into Meteor main repository. You can [find it there](https://github.com/meteor/meteor/tree/devel/npm-packages/eslint-plugin-meteor).

![Example](https://raw.githubusercontent.com/dferber90/eslint-plugin-meteor/master/docs/media/epm.gif)

*This gif shows integration of ESLint-plugin-Meteor into Atom. Find out more in the [integration guide](docs/guides/integration.md).*

# Quickstart

## Installation

Install [ESLint](https://www.github.com/eslint/eslint) and this plugin either locally or globally.

```sh

$ npm install eslint --save-dev

$ npm install eslint-plugin-meteor --save-dev

```

## Configuration

Create an `.eslintrc.json` file with this content at the root of your project:

```json

{

  "plugins": ["meteor"],

  "extends": ["plugin:meteor/recommended"]

}

```

For a more thorough introduction, read the [setup guide](/docs/guides/setup.md).

An article with detailed setup instructions can be found [here](https://medium.com/@dferber90/linting-meteor-8f229ebc7942).

# List of supported rules

## Best Practices

* General

  * [no-zero-timeout](docs/rules/no-zero-timeout.md): Prevent usage of Meteor.setTimeout with zero delay

* Session

  * [no-session](docs/rules/no-session.md): Prevent usage of Session

  * [prefer-session-equals](docs/rules/prefer-session-equals.md): Prefer `Session.equals` in conditions

* Security

  * [audit-argument-checks](docs/rules/audit-argument-checks.md): Enforce check on all arguments passed to methods and publish functions

* Blaze

  * [template-names](docs/rules/template-names.md): Naming convention for templates

  * [no-template-lifecycle-assignments](docs/rules/no-template-lifecycle-assignments.md): Prevent deprecated template lifecycle callback assignments

  * [eventmap-params](docs/rules/eventmap-params.md): Force consistent event handler parameter names in event maps

  * [prefix-eventmap-selectors](docs/rules/prefix-eventmap-selectors.md): Convention for eventmap selectors

  * [scope-dom-lookups](docs/rules/scope-dom-lookups.md): Scope DOM lookups to the template instance

  * [no-dom-lookup-on-created](docs/rules/no-dom-lookup-on-created.md): Forbid DOM lookups in template creation callback

  * [no-template-parent-data](docs/rules/no-template-parent-data.md): Avoid accessing template parent data

## Core API

* *currently no rules implemented*

[Any rule idea is welcome !](https://github.com/dferber90/eslint-plugin-meteor/issues)

## Recommended Configuration

This plugin exports a recommended configuration which enforces good Meteor practices.

The rules enabled in this configuration can be found in [`lib/index.js`](https://github.com/dferber90/eslint-plugin-meteor/blob/master/lib/index.js).

To enable the recommended configuration use the extends property in your `.eslintrc.json` config file:

```json

{

  "plugins": [

    "meteor"

  ],

  "extends": ["eslint:recommended", "plugin:meteor/recommended"]

}

```

You probably also want to enable ESLint to parse ECMAScript 2015 and to support React templates.

Add the following to your `.eslintrc.json` config file

```json

{

  "parserOptions": {

    "ecmaVersion": 6,

    "sourceType": "module",

    "ecmaFeatures": {

        "jsx": true

    }

  }

}

```

See [ESLint documentation](http://eslint.org/docs/user-guide/configuring#extending-configuration-files) for more information about extending configuration files.

## Limitations

ESLint-plugin-Meteor is not aware of where files are going to be executed, to keep the plugin simple.

It will not warn when accessing client-only features on the server and vice versa.

# Contributing

Read about [set up of the development environment](/docs/guides/development.md).

# Thanks

This plugin is inspired by [eslint-plugin-react](https://github.com/yannickcr/eslint-plugin-react).

# License

ESLint-plugin-Meteor is licensed under the [MIT License](http://www.opensource.org/licenses/mit-license.php).

[gitter-image]: https://img.shields.io/badge/gitter-chat-e10079.svg?style=flat-square

[gitter-url]: https://gitter.im/dferber90/eslint-plugin-meteor?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

[npm-url]: https://npmjs.org/package/eslint-plugin-meteor

[npm-image]: http://img.shields.io/npm/v/eslint-plugin-meteor.svg?style=flat-square

[npm-downloads-url]: https://npm-stat.com/charts.html?package=eslint-plugin-meteor

[npm-downloads-image]: https://img.shields.io/npm/dm/eslint-plugin-meteor.svg?style=flat-square

[actions-url]: https://github.com/dferber90/eslint-plugin-meteor/actions?query=workflow%3APR

[actions-image]: https://img.shields.io/github/workflow/status/dferber90/eslint-plugin-meteor/PR?style=flat-square

[deps-url]: https://david-dm.org/dferber90/eslint-plugin-meteor

[deps-image]: https://img.shields.io/david/dev/dferber90/eslint-plugin-meteor.svg?style=flat-square

[coverage-url]: https://coveralls.io/github/dferber90/eslint-plugin-meteor?branch=master

[coverage-image]: http://img.shields.io/coveralls/dferber90/eslint-plugin-meteor/master.svg?style=flat-square

[license-url]: https://github.com/dferber90/eslint-plugin-meteor/blob/master/LICENSE

[license-image]: https://img.shields.io/github/license/mashape/apistatus.svg?style=flat-square

[status-url]: https://github.com/dferber90/eslint-plugin-meteor/pulse

[status-image]: http://img.shields.io/badge/status-maintained-e10079.svg?style=flat-square

[semantic-release-image]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square

[semantic-release]: https://github.com/semantic-release/semantic-release

[commitizen-image]: https://img.shields.io/badge/commitizen-friendly-e10079.svg?style=flat-square

[commitizen]: http://commitizen.github.io/cz-cli/