1589333 - Enable ESLint for all of devtools/client/shared/

Status: RESOLVED FIXED

(DevTools :: General, task, P3)

Description

[Mark Banner (:standard8)]

As part of rolling out ESLint across the tree, we should enable it for all of devtools/client/shared/.

To help Mozilla out with this bug, here's the steps:

1. Comment here on the bug that you want to volunteer to help. I (or someone else) will assign it to you.
2. Download and build the Firefox source code, see the docs for details. An artifact build is all you need.
   • If you have any problems, please ask on IRC in the #introduction channel. They're there to help you get started.
   • You can also read the Developer Guide, which has answers to most development questions.
3. Start working on this bug
   • Please note:
     • We want to end up with two separate commits. One with the automatic changes, the second with the manual changes.
     • Although you'll change .eslintignore at the start, only the second commit should have the .eslintignore changes. Please follow the suggested commands closely.
   • Here's what to do:
     1. In .eslintignore, remove the lines that start with devtools/client/shared/ and the lines below it that start with !devtools/client/shared/.
     2. Run eslint ./mach eslint --fix devtools/client/shared/
        • This should fix some of the issues.
     3. Inspect the diff to make sure that the indentation of the lines surrounding the changes look ok.
     4. Create a commit of the work so far. Note the extra devtools/client/shared/ at the end (this avoids committing .eslintignore at this stage)
        • $ hg commit -m "Bug nnn - Enable ESLint for all of devtools/client/shared/ (automatic changes). r?Standard8" devtools/client/shared/
     5. For the remaining issues, you'll need to fix them by hand. To find them, run ./mach eslint devtools/client/shared/.
        • no-unused-vars: These generally fall into one of two cases:
          • const foo = bar() - if it is like this, it is generally alright to change to bar(). Although the foo is not use, the assignment side is sometimes still required for side-effects.
          • Sometimes a function is shown as unused, but is referenced in onload functions, in this case you can add a line saying /* exported bar */ which will satisfy ESLint.
        • Most of the rules should be reasonably easy to understand, but there's more information on some specific bits (especially no-undef) here and here.
     6. Test your changes, run $ ./mach mochitest devtools/client/shared
     7. Create a second commit of the manual changes, note, there's no directory specifier this time, so .eslintignore will be included.
        • $ hg commit -m "Bug nnn - Enable ESLint for Enable ESLint for all of devtools/client/shared/ (manual changes). r?Standard8"
     8. Post the two commits via phabricator. Please use moz-phab to submit them.
4. Once the patches are submitted, I'll take a look. If there's any changes necessary I'll comment in Phabricator, so be prepared to update the patches. If there's no changes, I'll request review from a devtools peer, so there may still be more to go.

• If you do need to update the patches, please amend the existing commits, rather than creating new ones. This helps with tracking of review comments.

5. Once we're happy with the changes, I'll push it to autoland - our integration branch. Your code will then soon be shipping to Firefox users worldwide!
6. Now you get to think about what kind of bug you'd like to work on next. Let me know what you're interested in and I can help you find your next contribution.

Comment 1

[Richard G (:cardo)]

Mark Banner I would like to have a crack at this!

Comment 2

[Mark Banner (:standard8)]

Hi Richard, sure please do. Feel free to ask questions here or on #introduction on IRC.

Comment 3

[Richard G (:cardo)]

Attachment: Bug 1589333 - Enable ESLint for all of devtools/client/shared/ (automatic changes). r?Standard8

Comment 4

[Richard G (:cardo)]

Attachment: Bug 1589333 - Enable ESLint for all of devtools/client/shared/ (manual changes). r?Standard8

Depends on D50636

Comment 5

[Richard G (:cardo)]

Mark Banner! I was not certain about what to do in /test/doc_inline-debugger-statement.html /test/doc_event-listeners-03.html

Comment 6

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/3aac3fa9657a
Enable ESLint for all of devtools/client/shared/ (automatic changes). r=Standard8,jdescottes
https://hg.mozilla.org/integration/autoland/rev/6a00c559aa42
Enable ESLint for all of devtools/client/shared/ (manual changes). r=Standard8,jdescottes

Comment 7

[Mark Banner (:standard8)]

Richard, thank you for working on this. As you'll see from the previous comment, I've just triggered the patches to land on the integration branch.

Assuming no issues are found with the automated tests, this will get merged to our main branch sometime in the next 24 hours, at which time this will be marked as fixed.

Comment 8

[Richard G (:cardo)]

Alright, Mark. You're welcome! :)

Comment 9

[Arthur Iakab [arthur_iakab]]

https://hg.mozilla.org/mozilla-central/rev/3aac3fa9657a
https://hg.mozilla.org/mozilla-central/rev/6a00c559aa42