Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cybozu/eslint-config
ESLint rules for Cybozu
https://github.com/cybozu/eslint-config
eslint
Last synced: 3 months ago
JSON representation
ESLint rules for Cybozu
- Host: GitHub
- URL: https://github.com/cybozu/eslint-config
- Owner: cybozu
- License: mit
- Created: 2018-05-29T07:56:03.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-29T18:58:46.000Z (6 months ago)
- Last Synced: 2024-05-02T06:17:09.143Z (6 months ago)
- Topics: eslint
- Language: JavaScript
- Size: 2.42 MB
- Stars: 91
- Watchers: 7
- Forks: 7
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# @cybozu/eslint-config
[](https://badge.fury.io/js/%40cybozu%2Feslint-config)
[](https://github.com/cybozu/eslint-config/actions?workflow=test)
[](https://github.com/cybozu/eslint-config/actions?workflow=lint)
A ESLint rule set for Cybozu.
**This package is intended to use in Cybozu. Currently, this is still in development so the rules might be changed.**
## What is this?
This is a ESLint rule set for Cybozu.
The purpose of `@cybozu/eslint-config` are following
- Share best practices for JavaScript
- Standardize JavaScript coding guideline in Cybozu
- Installation support for ESLint and continuous support for the rule set
## The benefits to adapt this rule
You don't need to care about updates for ESLint and ESLint plugins.
We'll manage the updates and provide CHANGELOG that you need to know so that you can update it easily.
In addition, we'll add some useful plugins into `@cybozu/eslint-config` so you can learn about best practices for JavaScript through `@cybozu/eslint-config`.
## Rule set policies
We provide rules that are Error or Warning.
### Error
This is a rule you must fix because the code might not follow our practices in JavaScript
### Warning
This is a rule you should fix because the code style might not be preferable.
## Version policy
1. We update major version if the changes might cause new errors.
1. We update minor version if the changes might cause new warnings.
1. We update patch version if the changes don't cause any new errors and warnings.
## How to use
Install `eslint` and `@cybozu/eslint-config`
```
% npm install --save-dev eslint @cybozu/eslint-config
```
### `.eslintrc.js`
Put it into your `.eslintrc.js`
```js
module.exports = {
extends: "@cybozu"
};
```
**Currently, we adopt that `indent` rule is 2 spaces and having indentation in `switch case`.
You can override the rule if your project adopts 4 spaces or others.
We think it's important to have consistency in your entire codebase.**
```js
module.exports = {
extends: "@cybozu/eslint-config/presets/react-typescript-prettier",
rules: {
// default
// 'indent': ['warn', 2, { "SwitchCase": 1 }],
indent: ["warn", 4, { SwitchCase: 0 }]
}
};
```
### `eslint.config.js` (Flat Config)
> [!NOTE]
> Flat Config support is experimental. The applicable rules and scope may have changed.
Put it into your `.eslint.config.js`
```js
const config = require("@cybozu/eslint-config/flat/presets/react-typescript-prettier")
module.exports = [
...config,
{
rules: {
// default
// 'indent': ['warn', 2, { "SwitchCase": 1 }],
indent: ["warn", 4, { SwitchCase: 0 }]
}
},
]
```
## Support rule set
- `@cybozu`
- This is included in the all following presets
- `@cybozu/eslint-config/presets/node`
- Including `eslint-plugin-n`
- `@cybozu/eslint-config/presets/typescript`
- Including `@typescript-eslint/eslint-plugin`
- `@cybozu/eslint-config/presets/react`
- Including `eslint-plugin-react`, `eslint-plugin-jsx-ally` and `eslint-plugin-react-hooks`
- `@cybozu/eslint-config/presets/react-typescript`
- Including `@cybozu/eslint-config/presets/typescript` and `@cybozu/eslint-config/presets/react`
- `@cybozu/eslint-config/presets/es5`
## Prettier Support
Prettier is a code formatter, which supports not only JavaScript but also many languages.
Prettier is used widely as code formatter for JavaScript.
It's opinionated but we don't have to discuss about code styles with Prettier because it's the rule (No more bikeshed).
The following presets disable all rules that conflict with Prettier and treat the differences between Prettier's code format as errors.
You can fix the errors by `--fix` option so you don't have to fix the errors manually.
To use the presets, you have to install `prettier`. We only support Prettier v2 or later versions.
```
% npm install --save-dev prettier
```
- `@cybozu/eslint-config/presets/prettier`
- `@cybozu/eslint-config/presets/node-prettier`
- `@cybozu/eslint-config/presets/node-typescript-prettier`
- `@cybozu/eslint-config/presets/typescript-prettier`
- `@cybozu/eslint-config/presets/react-typescript-prettier`
- `@cybozu/eslint-config/presets/react-prettier`
- `@cybozu/eslint-config/presets/es5-prettier`
**Currently, we don't support customized Prettier config**
## React Support
### ⚠️ Classic JSX Syntax
`@cybozu/eslint-config` is intented to be used with the [New JSX Transform](https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html). If you want to use the Classic JSX Transform (`React.createElement`), please enable the `react/jsx-uses-react` rule on your own.
```js
rules: {
"react/jsx-uses-react": "error"
}
```
## For kintone customize developers
`@cybozu/eslint-config/preset/kintone-customize-es5` is a preset for kintone customize(plug-in) developers, which is based on `preset/es5` and add some `globals` for kintone.
```js
module.exports = {
extends: "@cybozu/eslint-config/presets/kintone-customize-es5"
};
```
We also provide `@cybozu/eslint-config/presets/kintone-customize-es5-prettier` to use it with `prettier`.