51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
# Contributing to cypress-io/eslint-plugin-cypress
|
|
|
|
Thanks for taking the time to contribute! :smile:
|
|
|
|
## Preparation
|
|
|
|
* Fork and clone this repository
|
|
* Branch from the default `master` branch using a descriptive new branch name
|
|
* Install dependencies with `npm ci`
|
|
|
|
## Rule references
|
|
|
|
* Refer to the [ESLint documentation](https://eslint.org/docs/latest/) and the [Custom Rules](https://eslint.org/docs/latest/extend/custom-rules) page
|
|
|
|
## New rule
|
|
|
|
To add a new rule:
|
|
|
|
* Follow the instructions in the ESLint [generator-eslint](https://www.npmjs.com/package/generator-eslint) documentation to install [Yeoman](https://www.npmjs.com/package/yo) and the generator
|
|
* Run the new rule generator `yo eslint:rule` and answer the questions
|
|
- select "ESLint Plugin"
|
|
- for "Type a short description of this rule" provide text which starts with one of "enforce", "require" or "disallow" (all lower case)
|
|
* Yeoman creates three boilerplate files:
|
|
- `docs/rules/<rule-id>.md`
|
|
- `lib/rules/<rule-id>.js`
|
|
- `test/rules/<rule-id>.js`
|
|
* Run `npm run lint-fix`
|
|
* Address the linting errors by editing `lib/rules/<rule-id>.js`
|
|
- Add a `meta.messages` property (see [MessageIds](https://eslint.org/docs/latest/extend/custom-rules#messageids))
|
|
- Select the appropriate `meta.type` property using `problem`, `suggestion`, or `layout`
|
|
* Complete the new rule by adding content to the three files previously created
|
|
* Run `eslint-doc-generator` to generate automated documentation sections (see [Document generation](#document-generation) below)
|
|
* Review documentation changes
|
|
* Run `npm run lint`
|
|
* Run `npm test` to run [Jest](https://jestjs.io/) (or run `npm start` to run [Jest](https://jestjs.io/) in [watchAll](https://jestjs.io/docs/cli#--watchall) mode where it remains active and reruns when source changes are made)
|
|
* Make sure all tests are passing
|
|
* Add the rule to [legacy.js](https://github.com/cypress-io/eslint-plugin-cypress/blob/master/legacy.js) and to [flat.js](https://github.com/cypress-io/eslint-plugin-cypress/blob/master/lib/flat.js)
|
|
* Create a git commit with a commit message similar to: `feat: add rule <description>` (see [commit message conventions](https://github.com/semantic-release/semantic-release#commit-message-format))
|
|
* Create a PR from your branch
|
|
|
|
## Document generation
|
|
|
|
This plugin uses the ESLint [eslint-doc-generator](https://www.npmjs.com/package/eslint-doc-generator) to generate consistent documentation.
|
|
* Install with `npm install eslint-doc-generator -g`
|
|
* Run `eslint-doc-generator` in the root directory of the plugin
|
|
|
|
## Legacy tests
|
|
|
|
* The directory [tests-legacy](https://github.com/cypress-io/eslint-plugin-cypress/tree/master/tests-legacy) contains tests which are compatible with the legacy [ESLint v8 RuleTester](https://eslint.org/docs/v8.x/integrate/nodejs-api#ruletester) utility. It is not expected to add new rules to this set of tests.
|
|
* The directory [tests](https://github.com/cypress-io/eslint-plugin-cypress/tree/master/tests) is for tests compatible with the current [ESLint RuleTester](https://eslint.org/docs/latest/integrate/nodejs-api#ruletester).
|