feat(*): group folder and project diagnostics by file path

src/lint/lintFolder.spec.ts

@@ -6,57 +6,61 @@ describe('lintFolder', () => {
   it('should identify lint issues in a given folder', async () => {
     const results = await lintFolder(path.join(__dirname, '..'))
 
-    expect(results.length).toEqual(8)
-    expect(results).toContainEqual({
+    expect(results.size).toEqual(1)
+    const diagnostics = results.get(
+      path.join(__dirname, '..', 'Example File.sas')
+    )!
+    expect(diagnostics.length).toEqual(8)
+    expect(diagnostics).toContainEqual({
       message: 'Line contains trailing spaces',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 2,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line contains trailing spaces',
       lineNumber: 2,
       startColumnNumber: 1,
       endColumnNumber: 2,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'File name contains spaces',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'File name contains uppercase characters',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'File missing Doxygen header',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line contains encoded password',
       lineNumber: 5,
       startColumnNumber: 10,
       endColumnNumber: 18,
       severity: Severity.Error
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line is indented with a tab',
       lineNumber: 7,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line has incorrect indentation - 3 spaces',
       lineNumber: 6,
       startColumnNumber: 1,

src/lint/lintFolder.ts

@@ -20,19 +20,18 @@ const excludeFolders = [
  * Analyses and produces a set of diagnostics for the folder at the given path.
  * @param {string} folderPath - the path to the folder to be linted.
  * @param {LintConfig} configuration - an optional configuration. When not passed in, this is read from the .sasjslint file.
- * @returns {Diagnostic[]} array of diagnostic objects, each containing a warning, line number and column number.
+ * @returns {Promise<Map<string, Diagnostic[]>>} Resolves with a map with array of diagnostic objects, each containing a warning, line number and column number, and grouped by file path.
  */
 export const lintFolder = async (
   folderPath: string,
   configuration?: LintConfig
 ) => {
   const config = configuration || (await getLintConfig())
-  const diagnostics: Diagnostic[] = []
+  let diagnostics: Map<string, Diagnostic[]> = new Map<string, Diagnostic[]>()
   const fileNames = await listSasFiles(folderPath)
   await asyncForEach(fileNames, async (fileName) => {
-    diagnostics.push(
-      ...(await lintFile(path.join(folderPath, fileName), config))
-    )
+    const filePath = path.join(folderPath, fileName)
+    diagnostics.set(filePath, await lintFile(filePath, config))
   })
 
   const subFolders = (await listSubFoldersInFolder(folderPath)).filter(
@@ -40,9 +39,11 @@ export const lintFolder = async (
   )
 
   await asyncForEach(subFolders, async (subFolder) => {
-    diagnostics.push(
-      ...(await lintFolder(path.join(folderPath, subFolder), config))
+    const subFolderDiagnostics = await lintFolder(
+      path.join(folderPath, subFolder),
+      config
     )
+    diagnostics = new Map([...diagnostics, ...subFolderDiagnostics])
   })
 
   return diagnostics

src/lint/lintProject.spec.ts

@@ -1,62 +1,71 @@
 import { lintProject } from './lintProject'
 import { Severity } from '../types/Severity'
+import * as utils from '../utils'
 import path from 'path'
+jest.mock('../utils')
 
 describe('lintProject', () => {
   it('should identify lint issues in a given project', async () => {
+    jest
+      .spyOn(utils, 'getProjectRoot')
+      .mockImplementationOnce(() => Promise.resolve(path.join(__dirname, '..')))
     const results = await lintProject()
 
-    expect(results.length).toEqual(8)
-    expect(results).toContainEqual({
+    expect(results.size).toEqual(1)
+    const diagnostics = results.get(
+      path.join(__dirname, '..', 'Example File.sas')
+    )!
+    expect(diagnostics.length).toEqual(8)
+    expect(diagnostics).toContainEqual({
       message: 'Line contains trailing spaces',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 2,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line contains trailing spaces',
       lineNumber: 2,
       startColumnNumber: 1,
       endColumnNumber: 2,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'File name contains spaces',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'File name contains uppercase characters',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'File missing Doxygen header',
       lineNumber: 1,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line contains encoded password',
       lineNumber: 5,
       startColumnNumber: 10,
       endColumnNumber: 18,
       severity: Severity.Error
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line is indented with a tab',
       lineNumber: 7,
       startColumnNumber: 1,
       endColumnNumber: 1,
       severity: Severity.Warning
     })
-    expect(results).toContainEqual({
+    expect(diagnostics).toContainEqual({
       message: 'Line has incorrect indentation - 3 spaces',
       lineNumber: 6,
       startColumnNumber: 1,
@@ -64,4 +73,14 @@ describe('lintProject', () => {
       severity: Severity.Warning
     })
   })
+
+  it('should throw an error when a project root is not found', async () => {
+    jest
+      .spyOn(utils, 'getProjectRoot')
+      .mockImplementationOnce(() => Promise.resolve(''))
+
+    await expect(lintProject()).rejects.toThrowError(
+      'SASjs Project Root was not found.'
+    )
+  })
 })

src/lint/lintProject.ts

@@ -3,7 +3,7 @@ import { lintFolder } from './lintFolder'
 
 /**
  * Analyses and produces a set of diagnostics for the current project.
- * @returns {Diagnostic[]} array of diagnostic objects, each containing a warning, line number and column number.
+ * @returns {Promise<Map<string, Diagnostic[]>>} Resolves with a map with array of diagnostic objects, each containing a warning, line number and column number, and grouped by file path.
  */
 export const lintProject = async () => {
   const projectRoot =

tsconfig.json

@@ -7,6 +7,7 @@
       ],
       "target": "es5",
       "module": "commonjs",
+      "downlevelIteration": true,
       "moduleResolution": "node",
       "esModuleInterop": true,
       "declaration": true,