Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/wikimedia/eslint-config-wikimedia

JavaScript style guide for Wikimedia.
https://github.com/wikimedia/eslint-config-wikimedia

Last synced: about 1 month ago
JSON representation

JavaScript style guide for Wikimedia.

Host: GitHub
URL: https://github.com/wikimedia/eslint-config-wikimedia
Owner: wikimedia
License: mit
Created: 2016-07-21T00:58:55.000Z (about 8 years ago)
Default Branch: main
Last Pushed: 2024-05-21T18:59:39.000Z (4 months ago)
Last Synced: 2024-05-22T11:24:52.561Z (4 months ago)
Language: JavaScript
Homepage: https://www.mediawiki.org/wiki/Manual:Coding_conventions/JavaScript
Size: 1.26 MB
Stars: 28
Watchers: 11
Forks: 19
Open Issues: 27
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: license

Awesome Lists containing this project

awesome-eslint - Wikimedia - Shareable config for [Wikimedia's style guide](https://www.mediawiki.org/wiki/Manual:Coding_conventions/JavaScript), used by [MediaWiki](https://www.mediawiki.org/). (Configs / Configs by Well-Known Companies/Organizations)

README

# Wikimedia ESLint config

## Installation

```sh
npm install --save-dev eslint-config-wikimedia
```

Then, [configure ESLint](https://eslint.org/docs/user-guide/configuring) with one or more `.eslintrc.json` files as appropriate.

## Example configurations
Below are some potential recommended uses:

### A typical front-end project
This config allows ES6 code and browser native functions. It will complain about ES2016+ code and language features.
It also automatically applies the Vue plugin and Vue-specific rules to `.vue` files.

`.eslintrc.json`:
```json
{
"extends": "wikimedia/client/es6"
}
```
If you want to only allow ES5 code and browser native functions, you can use `wikimedia/client/es5` instead.

#### jQuery
This config adds the jQuery `$` global, and additional rules preventing the use of jQuery features which are deprecated, have performance issues, or have simple ES6 alternatives.
`.eslintrc.json`:
```json
{
"extends": [
"wikimedia/client/es6",
"wikimedia/jquery"
]
}
```

#### MediaWiki
Code that runs in MediaWiki can use this config. It enforces rules that are specific to the MediaWiki codebase (core and extensions), such as correct documentation of `mw.message` usage, and prohibiting self-closing tags in Vue templates.
`.eslintrc.json`:
```json
{
"extends": [
"wikimedia/client/es6",
"wikimedia/mediawiki"
]
}
```

### Adding a QUnit test suite
You can extend the above config by also adding a second `.eslintrc.json` file in your tests directory:

`tests/qunit/.eslintrc.json`:
```json
{
"extends": [
"wikimedia/mediawiki/qunit"
]
}
```

Or for standalone JavaScript libraries and Node.js projects:

`tests/.eslintrc.json`:
```json
{
"extends": [
"wikimedia/qunit"
]
}
```

### Adding a Mocha test suite
The following config will the Mocha environment and some Mocha related rules:

`tests/mocha/.eslintrc.json`:
```json
{
"root": true,
"extends": [
"wikimedia/server",
"wikimedia/mocha"
]
}
```

### Adding a Selenium WDIO test suite
The following config will enable WDIO globals, as well as the Mocha and server configs:

`tests/selenium/.eslintrc.json`:
```json
{
"root": true,
"extends": [
"wikimedia/selenium"
]
}
```

### A typical Node project
This config allows ES2018 code and Node native functions (_i.e._, Node 10.x). It will complain about ES2019+ code and language features.

`.eslintrc.json`:
```json
{
"extends": "wikimedia/server"
}
```

The `wikimedia/server` config consists of `wikimedia`, `wikimedia/node` and `wikimedia/language/es2018`. To use later versions of ES, for example ES2019, you can use the following config:
`.eslintrc.json`:
```json
{
"extends": [
"wikimedia",
"wikimedia/node",
"wikimedia/language/es2019"
]
}
```

### A basic project
Please note that the basic project configuration does not specify any language or environmental defaults, and is unlikely to be suitable. However, if you wish to target clients with ES3 language support, or earlier versions of Node, this is a good place from which to start.

`.eslintrc.json`:
```json
{
"extends": "wikimedia"
}
```

## Proposing changes

Major changes should be discussed [on mediawiki.org](https://www.mediawiki.org/wiki/Manual_talk:Coding_conventions/JavaScript) or on the [Wikitech mailing list](https://lists.wikimedia.org/mailman/listinfo/wikitech-l) beforehand.

## Semver policy

Same approach as in ESLint, see https://github.com/eslint/eslint#user-content-semantic-versioning-policy.