eslint-formatter-gitlab 4.0.0 → 5.1.0

package/LICENSE.md

@@ -3,7 +3,7 @@
 Copyright © 2018 Remco Haszing
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-associated documentation files (the "Software"), to deal in the Software without restriction,
+associated documentation files (the “Software”), to deal in the Software without restriction,
 including without limitation the rights to use, copy, modify, merge, publish, distribute,
 sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
@@ -11,7 +11,7 @@ furnished to do so, subject to the following conditions:
 The above copyright notice and this permission notice shall be included in all copies or substantial
 portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
 NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
 OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN

package/README.md

@@ -2,11 +2,20 @@
 
 Show ESLint results directly in the
 [GitLab code quality](https://docs.gitlab.com/ee/user/project/merge_requests/code_quality.html)
-results
+results.
+
+## Table of Contents
+
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Example](#example)
+- [Configuration](#configuration)
+- [License](#license)
 
 ## Requirements
 
-This package requires at least Node.js 14 and ESLint 5.
+This package requires at least Node.js 18 and ESLint 5.
 
 ## Installation
 
@@ -24,7 +33,7 @@ _.gitlab-ci.yml_:
 
 ```yaml
 eslint:
-  image: node:18-alpine
+  image: node:20-alpine
   script:
     - npm ci
     - npx eslint --format gitlab .
@@ -33,8 +42,8 @@ eslint:
       codequality: gl-codequality.json
 ```
 
-The formatter will automatically detect a GitLab CI environment. It will detect where to output the
-code quality report based on the GitLab configuration file.
+The formatter automatically detects a GitLab CI environment. It detects where to output the code
+quality report based on the GitLab configuration file.
 
 ## Example
 
@@ -42,12 +51,13 @@ An example of the results can be seen in
 [Merge Request !1](https://gitlab.com/remcohaszing/eslint-formatter-gitlab/merge_requests/1) of
 `eslint-formatter-gitlab` itself.
 
-## Configuration Options
+## Configuration
 
-ESLint formatters don’t take any configuration options. `eslint-formatter-gitlab` uses GitLab
-environment variables to configure the output. In addition, the environment variable
-`ESLINT_CODE_QUALITY_REPORT` is used to override the location to store the code quality report.
+ESLint formatters don’t take any configuration options. `eslint-formatter-gitlab` uses GitLab’s
+[predefined environment variables](https://docs.gitlab.com/ee/ci/variables/predefined_variables.html)
+to configure the output. In addition, the environment variable `ESLINT_CODE_QUALITY_REPORT` is used
+to override the location to store the code quality report.
 
-# License
+## License
 
-[MIT](LICENSE.md) @ [Remco Haszing](https://gitlab.com/remcohaszing)
+[MIT](LICENSE.md) © [Remco Haszing](https://gitlab.com/remcohaszing)

package/index.d.ts

@@ -0,0 +1,11 @@
+export = eslintFormatterGitLab;
+/**
+ * @param {import('eslint').ESLint.LintResult[]} results
+ *   The ESLint report results.
+ * @param {import('eslint').ESLint.LintResultData} data
+ *   The ESLint report result data.
+ * @returns {string}
+ *   The ESLint output to print to the console.
+ */
+declare function eslintFormatterGitLab(results: import('eslint').ESLint.LintResult[], data: import('eslint').ESLint.LintResultData): string;
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":";AA0PA;;;;;;;GAOG;AACH,gDAPW,OAAO,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,QAEpC,OAAO,QAAQ,EAAE,MAAM,CAAC,cAAc,GAEpC,MAAM,CAmBlB"}

package/index.js

@@ -1,283 +1,277 @@
-/**
- * @typedef {import('eslint').ESLint.LintResult} LintResult
- * @typedef {import('eslint').ESLint.LintResultData} LintResultData
- * @typedef {import('eslint').Linter.LintMessage} LintMessage
- */
-
-/**
- * @typedef {object} GitLabReports
- * @property {string} [codequality]
- */
-
-/**
- * @typedef {object} GitLabArtifacts
- * @property {GitLabReports} [reports]
- */
-
-/**
- * @typedef {object} GitLabJob
- * @property {GitLabArtifacts} [artifacts]
- */
-
-/**
- * @typedef {Record<string, GitLabJob>} GitLabCI
- */
-
-/**
- * @typedef {object} CodeClimateLines
- * @property {number} begin
- * @property {number} end
- */
-
-/**
- * @typedef {object} CodeClimateContents
- * @property {string} body
- */
-
-/**
- * @typedef {object} CodeClimateLocation
- * https://github.com/codeclimate/platform/blob/master/spec/analyzers/SPEC.md#locations
- * @property {string} path
- * @property {CodeClimateLines} lines
- */
-
-/**
- * @typedef {object} CodeClimateIssue
- * https://github.com/codeclimate/platform/blob/master/spec/analyzers/SPEC.md#issues
- * @property {'issue'} type
- * @property {string} check_name
- * @property {string} description
- * @property {CodeClimateContents} [contents]
- * @property {'info' | 'minor' | 'major' | 'critical' | 'blocker'} severity
- * @property {string} [fingerprint]
- * @property {CodeClimateLocation} location
- */
+const { createHash } = require('node:crypto')
+const { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } = require('node:fs')
+const { EOL } = require('node:os')
+const { dirname, join, relative, resolve } = require('node:path')
 
-const { createHash } = require('node:crypto');
-const { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } = require('node:fs');
-const { EOL } = require('node:os');
-const { dirname, join, relative, resolve } = require('node:path');
-
-const chalk = require('chalk');
-const yaml = require('yaml');
+const chalk = require('chalk')
+const yaml = require('yaml')
 
 const {
+  CI_COMMIT_SHORT_SHA,
   CI_CONFIG_PATH = '.gitlab-ci.yml',
   CI_JOB_NAME,
   CI_PROJECT_DIR = process.cwd(),
   CI_PROJECT_URL,
-  CI_COMMIT_SHORT_SHA,
   ESLINT_CODE_QUALITY_REPORT,
-  GITLAB_CI,
-  NODE_ENV,
-} = process.env;
+  GITLAB_CI
+} = process.env
 
-/**
- * @type {yaml.CollectionTag}
- */
+/** @type {yaml.CollectionTag} */
 const reference = {
   tag: '!reference',
   collection: 'seq',
   default: false,
   resolve() {
     // We only allow the syntax. We don’t actually resolve the reference.
-  },
-};
+  }
+}
 
 /**
- * @returns {string} The output path of the code quality artifact.
+ * @returns {string}
+ *   The output path of the code quality artifact.
  */
 function getOutputPath() {
-  const configPath = join(CI_PROJECT_DIR, CI_CONFIG_PATH);
+  const configPath = join(CI_PROJECT_DIR, CI_CONFIG_PATH)
   // GitlabCI allows a custom configuration path which can be a URL or a path relative to another
   // project. In these cases CI_CONFIG_PATH is empty and we'll have to require the user provide
   // ESLINT_CODE_QUALITY_REPORT.
   if (!existsSync(configPath) || !lstatSync(configPath).isFile()) {
     throw new Error(
       'Could not resolve .gitlab-ci.yml to automatically detect report artifact path.' +
-        ' Please manually provide a path via the ESLINT_CODE_QUALITY_REPORT variable.',
-    );
-  }
-  const jobs = /** @type {GitLabCI} */ (
-    yaml.parse(readFileSync(configPath, 'utf8'), { version: '1.1', customTags: [reference] })
-  );
-  const { artifacts } = jobs[/** @type {string} */ (CI_JOB_NAME)];
-  const location = artifacts?.reports?.codequality;
-  const msg = `Expected ${CI_JOB_NAME}.artifacts.reports.codequality to be one exact path`;
-  if (!location) {
-    throw new Error(`${msg}, but no value was found.`);
+        ' Please manually provide a path via the ESLINT_CODE_QUALITY_REPORT variable.'
+    )
   }
-  if (Array.isArray(location)) {
-    throw new TypeError(`${msg}, but found an array instead.`);
+  const doc = yaml.parseDocument(readFileSync(configPath, 'utf8'), {
+    version: '1.1',
+    customTags: [reference]
+  })
+  const path = [CI_JOB_NAME, 'artifacts', 'reports', 'codequality']
+  const location = doc.getIn(path)
+  if (typeof location !== 'string' || !location) {
+    throw new TypeError(
+      `Expected ${path.join('.')} to be one exact path, got: ${JSON.stringify(location)}`
+    )
   }
-  return resolve(CI_PROJECT_DIR, location);
+  return resolve(CI_PROJECT_DIR, location)
 }
 
 /**
- * @param {string} filePath The path to the linted file.
- * @param {LintMessage} message The ESLint report message.
- * @returns {string} The fingerprint for the ESLint report message.
+ * @param {string} filePath
+ *   The path to the linted file.
+ * @param {import('eslint').Linter.LintMessage} message
+ *   The ESLint report message.
+ * @param {Set<string>} hashes
+ *   Hashes already encountered. Used to avoid duplicate hashes
+ * @returns {string}
+ *   The fingerprint for the ESLint report message.
  */
-function createFingerprint(filePath, message) {
-  const md5 = createHash('md5');
-  md5.update(filePath);
+function createFingerprint(filePath, message, hashes) {
+  const md5 = createHash('md5')
+  md5.update(filePath)
   if (message.ruleId) {
-    md5.update(message.ruleId);
+    md5.update(message.ruleId)
+  }
+  md5.update(message.message)
+
+  // Create copy of hash since md5.digest() will finalize it, not allowing us to .update() again
+  let md5Tmp = md5.copy()
+  let hash = md5Tmp.digest('hex')
+
+  while (hashes.has(hash)) {
+    // Hash collision. This happens if we encounter the same ESLint message in one file
+    // multiple times. Keep generating new hashes until we get a unique one.
+    md5.update(hash)
+
+    md5Tmp = md5.copy()
+    hash = md5Tmp.digest('hex')
   }
-  md5.update(message.message);
-  return md5.digest('hex');
+
+  hashes.add(hash)
+  return hash
 }
 
 /**
- * @param {LintResult[]} results The ESLint report results.
- * @param {LintResultData} data The ESLint report result data.
- * @returns {CodeClimateIssue[]} The ESLint messages in the form of a GitLab code quality report.
+ * @param {import('eslint').ESLint.LintResult[]} results
+ *   The ESLint report results.
+ * @param {import('eslint').ESLint.LintResultData} data
+ *   The ESLint report result data.
+ * @returns {import('codeclimate-types').Issue[]}
+ *   The ESLint messages in the form of a GitLab code quality report.
  */
 function convert(results, data) {
-  /** @type {CodeClimateIssue[]} */
-  const messages = [];
+  /** @type {import('codeclimate-types').Issue[]} */
+  const messages = []
+
+  /** @type {Set<string>} */
+  const hashes = new Set()
+
   for (const result of results) {
-    for (const message of result.messages) {
-      const relativePath = relative(CI_PROJECT_DIR, result.filePath);
+    const relativePath = relative(CI_PROJECT_DIR, result.filePath)
 
-      /** @type {CodeClimateIssue} */
+    for (const message of result.messages) {
+      /** @type {import('codeclimate-types').Issue} */
       const issue = {
         type: 'issue',
+        categories: ['Style'],
         check_name: message.ruleId ?? '',
         description: message.message,
-        severity: message.severity === 2 ? 'major' : 'minor',
-        fingerprint: createFingerprint(relativePath, message),
+        severity: message.fatal ? 'critical' : message.severity === 2 ? 'major' : 'minor',
+        fingerprint: createFingerprint(relativePath, message, hashes),
         location: {
           path: relativePath,
           lines: {
             begin: message.line,
-            end: message.endLine ?? message.line,
-          },
-        },
-      };
-      const docs = message.ruleId ? data.rulesMeta[message.ruleId]?.docs : undefined;
-      if (docs) {
-        let body = docs.description || '';
-        if (docs.url) {
-          if (body) {
-            body += '\n\n';
+            end: message.endLine ?? message.line
           }
-          body += `[${message.ruleId}](${docs.url})`;
         }
+      }
+      messages.push(issue)
+
+      if (!message.ruleId) {
+        continue
+      }
+
+      if (!data.rulesMeta[message.ruleId]) {
+        continue
+      }
+
+      const { docs, type } = data.rulesMeta[message.ruleId]
+      if (type === 'problem') {
+        issue.categories.unshift('Bug Risk')
+      }
+
+      if (!docs) {
+        continue
+      }
+
+      let body = docs.description || ''
+      if (docs.url) {
         if (body) {
-          issue.contents = { body };
+          body += '\n\n'
         }
+        body += `[${message.ruleId}](${docs.url})`
+      }
+
+      if (body) {
+        issue.content = { body }
       }
-      messages.push(issue);
     }
   }
-  return messages;
-}
-
-/**
- * @param {LintMessage} message The ESLint report message.
- * @returns {boolean} `true` if the message is at error level, `false` if it represents a warning
- */
-function messageIsLevelError(message) {
-  return message.fatal || message.severity === 2;
+  return messages
 }
 
 /**
  * Make a text singular or plural based on the count.
  *
- * @param {number} count The count of the data.
- * @param {string} text The text to make singular or plural.
- * @returns {string} The formatted text.
+ * @param {number} count
+ *   The count of the data.
+ * @param {string} text
+ *   The text to make singular or plural.
+ * @returns {string}
+ *   The formatted text.
  */
 function plural(count, text) {
-  return `${count} ${text}${count === 1 ? '' : 's'}`;
+  return `${count} ${text}${count === 1 ? '' : 's'}`
 }
 
 /**
- * @param {LintResult[]} results The ESLint report results.
- * @returns {string} The ESLint messages converted to a format
- * suitable as output in GitLab CI job logs.
+ * @param {import('eslint').ESLint.LintResult[]} results
+ *   The ESLint report results.
+ * @returns {string}
+ *   The ESLint messages converted to a format suitable as output in GitLab CI job logs.
  */
 function gitlabConsoleFormatter(results) {
   // Severity labels manually padded to have equal lengths and end with spaces
-  const labelError = `${chalk.red('error')}  `;
-  const labelWarn = `${chalk.yellow('warn')}   `;
+  const labelFatal = `${chalk.magenta('fatal')}  `
+  const labelError = `${chalk.red('error')}  `
+  const labelWarn = `${chalk.yellow('warn')}   `
 
-  const lines = [''];
+  const lines = ['']
 
   /** @type {string | undefined} */
-  let gitLabBaseURL;
+  let gitLabBaseURL
   if (CI_PROJECT_URL && CI_COMMIT_SHORT_SHA) {
-    gitLabBaseURL = `${CI_PROJECT_URL}/-/blob/${CI_COMMIT_SHORT_SHA}/`;
+    gitLabBaseURL = `${CI_PROJECT_URL}/-/blob/${CI_COMMIT_SHORT_SHA}/`
   }
 
-  let errors = 0;
-  let warnings = 0;
-  let maxRuleIdLength = 0;
-  let maxMsgLength = 0;
+  let fatal = 0
+  let errors = 0
+  let warnings = 0
+  let maxRuleIdLength = 0
+  let maxMsgLength = 0
 
   for (const result of results) {
+    fatal += result.fatalErrorCount
+    errors += result.errorCount - result.fatalErrorCount
+    warnings += result.warningCount
     for (const message of result.messages) {
-      const isError = messageIsLevelError(message);
-      errors += isError ? 1 : 0;
-      warnings += isError ? 0 : 1;
-      maxRuleIdLength = message.ruleId
-        ? Math.max(maxRuleIdLength, message.ruleId.length)
-        : maxRuleIdLength;
-      maxMsgLength = Math.max(maxMsgLength, message.message.length);
+      if (message.ruleId) {
+        maxRuleIdLength = Math.max(maxRuleIdLength, message.ruleId.length)
+      }
+      maxMsgLength = Math.max(maxMsgLength, message.message.length)
     }
   }
 
   for (const result of results) {
-    const { filePath, messages } = result;
-    const repoFilePath = relative(CI_PROJECT_DIR, filePath);
+    const { filePath, messages } = result
+    const repoFilePath = relative(CI_PROJECT_DIR, filePath)
 
     for (const message of messages) {
-      let line;
-      line = messageIsLevelError(message) ? labelError : labelWarn;
-      line += String(message.ruleId || '').padEnd(maxRuleIdLength + 2);
-      line += message.message.padEnd(maxMsgLength + 2);
+      let line = message.fatal ? labelFatal : message.severity === 1 ? labelWarn : labelError
+      line += String(message.ruleId || '').padEnd(maxRuleIdLength + 2)
+      line += message.message.padEnd(maxMsgLength + 2)
 
       if (gitLabBaseURL) {
         // Create link to referenced file in GitLab
-        const anchor = message.line === undefined ? '' : `#L${message.line}`;
-        line += chalk.blue(`${gitLabBaseURL}${repoFilePath}${anchor}`);
+        let anchor = `#L${message.line}`
+        if (message.endLine != null && message.endLine !== message.line) {
+          anchor += `-${message.endLine}`
+        }
+        line += chalk.blue(`${gitLabBaseURL}${repoFilePath}${anchor}`)
       } else {
-        line += `${filePath}:${message.line || 0}:${message.column || 0}`;
+        line += `${filePath}:${message.line}:${message.column}`
       }
 
-      lines.push(line);
+      lines.push(line)
     }
   }
 
-  const total = warnings + errors;
+  const total = warnings + errors + fatal
   if (total > 0) {
-    const details = `(${plural(errors, 'error')}, ${plural(warnings, 'warning')})`;
-    lines.push('', `${chalk.red('✖')} ${plural(total, 'problem')} ${details}`);
+    const details = `(${fatal} fatal, ${plural(errors, 'error')}, ${plural(warnings, 'warning')})`
+    lines.push('', `${chalk.red('✖')} ${plural(total, 'problem')} ${details}`)
   } else {
-    lines.push(`${chalk.green('✔')} No problems found`);
+    lines.push(`${chalk.green('✔')} No problems found`)
   }
 
-  lines.push('');
-  return lines.join(EOL);
+  lines.push('')
+  return lines.join(EOL)
 }
 
 /**
- * @param {LintResult[]} results The ESLint report results.
- * @param {LintResultData} data The ESLint report result data.
+ * @param {import('eslint').ESLint.LintResult[]} results
+ *   The ESLint report results.
+ * @param {import('eslint').ESLint.LintResultData} data
+ *   The ESLint report result data.
+ * @returns {string}
+ *   The ESLint output to print to the console.
  */
-module.exports = (results, data) => {
-  /* istanbul ignore next */
-  if (GITLAB_CI === 'true' && NODE_ENV !== 'test') {
-    chalk.level = 1;
+function eslintFormatterGitLab(results, data) {
+  /* c8 ignore start */
+  if (GITLAB_CI === 'true') {
+    chalk.level = 1
   }
+
+  /* c8 ignore stop */
   if (CI_JOB_NAME || ESLINT_CODE_QUALITY_REPORT) {
-    const issues = convert(results, data);
-    const outputPath = ESLINT_CODE_QUALITY_REPORT || getOutputPath();
-    const dir = dirname(outputPath);
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(outputPath, JSON.stringify(issues, null, 2));
+    const issues = convert(results, data)
+    const outputPath = ESLINT_CODE_QUALITY_REPORT || getOutputPath()
+    const dir = dirname(outputPath)
+    mkdirSync(dir, { recursive: true })
+    writeFileSync(outputPath, JSON.stringify(issues, null, 2))
   }
 
-  return gitlabConsoleFormatter(results);
-};
+  return gitlabConsoleFormatter(results)
+}
+
+module.exports = eslintFormatterGitLab

package/package.json

@@ -1,24 +1,20 @@
 {
   "name": "eslint-formatter-gitlab",
-  "version": "4.0.0",
+  "version": "5.1.0",
   "description": "Show ESLint results directly in the GitLab code quality results",
   "author": "Remco Haszing <remcohaszing@gmail.com>",
   "license": "MIT",
   "homepage": "https://gitlab.com/remcohaszing/eslint-formatter-gitlab#readme",
-  "repository": {
-    "type": "git",
-    "url": "https://gitlab.com/remcohaszing/eslint-formatter-gitlab.git"
-  },
+  "repository": "gitlab:remcohaszing/eslint-formatter-gitlab",
   "funding": "https://github.com/sponsors/remcohaszing",
-  "bugs": {
-    "url": "https://gitlab.com/remcohaszing/eslint-formatter-gitlab.git/issues"
-  },
+  "bugs": "https://gitlab.com/remcohaszing/eslint-formatter-gitlab/-/issues",
   "exports": "./index.js",
   "files": [
-    "index.js"
+    "index.*"
   ],
   "scripts": {
-    "test": "jest --coverage"
+    "prepack": "tsc --build",
+    "test": "c8 node --test --test-reporter @reporters/junit --test-reporter-destination=junit.xml --test-reporter spec --test-reporter-destination stdout"
   },
   "keywords": [
     "eslint",
@@ -27,28 +23,24 @@
     "gitlab",
     "gitlab-ci"
   ],
-  "engines": {
-    "node": ">=14.0.0"
-  },
   "dependencies": {
     "chalk": "^4.0.0",
     "yaml": "^2.0.0"
   },
   "peerDependencies": {
-    "eslint": "^5 || ^6 || ^7 || ^8"
+    "eslint": ">=5"
   },
   "devDependencies": {
+    "@reporters/junit": "^1.0.0",
     "@types/eslint": "^8.0.0",
-    "@types/jest": "^29.0.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
+    "c8": "^8.0.0",
+    "codeclimate-types": "^0.3.0",
     "eslint": "^8.0.0",
-    "eslint-config-remcohaszing": "^7.0.0",
-    "eslint-plugin-jest": "^27.0.0",
-    "eslint-plugin-jest-formatting": "^3.0.0",
-    "jest": "^29.0.0",
-    "jest-junit": "^14.0.0",
-    "memfs": "^3.0.0",
-    "prettier": "^2.0.0",
-    "typescript": "^4.0.0"
+    "eslint-config-remcohaszing": "^10.0.0",
+    "prettier": "^3.0.0",
+    "remark-cli": "^11.0.0",
+    "remark-preset-remcohaszing": "^2.0.0",
+    "typescript": "^5.0.0"
   }
 }