Adding a markdown report generator

src/Business/MetricsFacade.php

@@ -13,6 +13,7 @@
 use Phauthentic\CognitiveCodeAnalysis\Business\Cognitive\Exporter\CsvExporter;
 use Phauthentic\CognitiveCodeAnalysis\Business\Cognitive\Exporter\HtmlExporter;
 use Phauthentic\CognitiveCodeAnalysis\Business\Cognitive\Exporter\JsonExporter;
+use Phauthentic\CognitiveCodeAnalysis\Business\Cognitive\Exporter\MarkdownExporter;
 use Phauthentic\CognitiveCodeAnalysis\Business\Cognitive\ScoreCalculator;
 use Phauthentic\CognitiveCodeAnalysis\CognitiveAnalysisException;
 use Phauthentic\CognitiveCodeAnalysis\Config\CognitiveConfig;
@@ -170,10 +171,13 @@ public function exportMetricsReport(
         string $reportType,
         string $filename
     ): void {
+        $config = $this->configService->getConfig();
+
         match ($reportType) {
             'json' => (new JsonExporter())->export($metricsCollection, $filename),
             'csv'  => (new CsvExporter())->export($metricsCollection, $filename),
             'html' => (new HtmlExporter())->export($metricsCollection, $filename),
+            'markdown' => (new MarkdownExporter($config))->export($metricsCollection, $filename),
             default => null,
         };
     }

src/Command/Handler/CognitiveMetricsReportHandler.php

@@ -56,7 +56,7 @@ private function hasIncompleteReportOptions(?string $reportType, ?string $report
 
     private function isValidReportType(?string $reportType): bool
     {
-        return in_array($reportType, ['json', 'csv', 'html']);
+        return in_array($reportType, ['json', 'csv', 'html', 'markdown']);
     }
 
     /**
@@ -80,7 +80,7 @@ private function handleExceptions(Exception $exception): int
     public function handleInvalidReporType(?string $reportType): int
     {
         $this->output->writeln(sprintf(
-            '<error>Invalid report type `%s` provided. Only `json`, `csv`, and `html` are accepted.</error>',
+            '<error>Invalid report type `%s` provided. Only `json`, `csv`, `html`, and `markdown` are accepted.</error>',
             $reportType
         ));
 

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_AllMetrics.md

@@ -0,0 +1,27 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+**Total Classes:** 2
+
+---
+
+* **Class:** TestClass
+* **File:** TestClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| testMethod | 10 (0.500) | 2 (0.300) | 1 (0.200) | 5 (0.400) | 3 (0.300) | 4 (0.600) | 2 (0.500) | 1 (0.200) | 0.300 | 573.211 | 12.500 | 7,165.138 | 5 (low) |
+| anotherMethod | 5 (0.200) | 1 (0.100) | 1 (0.100) | 2 (0.100) | 1 (0.100) | 1 (0.200) | 1 (0.100) | 0 (0.000) | 0.050 | 185.470 | 6.250 | 1,159.188 | 2 (low) |
+
+---
+
+* **Class:** AnotherClass
+* **File:** AnotherClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| complexMethod | 20 (1.000) | 4 (0.600) | 3 (0.500) | 10 (0.800) | 5 (0.500) | 8 (1.200) | 3 (1.000) | 4 (0.600) | 0.800 | 1,357.824 | 25.000 | 33,945.600 | 12 (medium) |
+
+---
+

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_CyclomaticOnly.md

@@ -0,0 +1,27 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+**Total Classes:** 2
+
+---
+
+* **Class:** TestClass
+* **File:** TestClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| testMethod | 10 (0.500) | 2 (0.300) | 1 (0.200) | 5 (0.400) | 3 (0.300) | 4 (0.600) | 2 (0.500) | 1 (0.200) | 0.300 | 5 (low) |
+| anotherMethod | 5 (0.200) | 1 (0.100) | 1 (0.100) | 2 (0.100) | 1 (0.100) | 1 (0.200) | 1 (0.100) | 0 (0.000) | 0.050 | 2 (low) |
+
+---
+
+* **Class:** AnotherClass
+* **File:** AnotherClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| complexMethod | 20 (1.000) | 4 (0.600) | 3 (0.500) | 10 (0.800) | 5 (0.500) | 8 (1.200) | 3 (1.000) | 4 (0.600) | 0.800 | 12 (medium) |
+
+---
+

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_HalsteadOnly.md

@@ -0,0 +1,27 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+**Total Classes:** 2
+
+---
+
+* **Class:** TestClass
+* **File:** TestClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| testMethod | 10 (0.500) | 2 (0.300) | 1 (0.200) | 5 (0.400) | 3 (0.300) | 4 (0.600) | 2 (0.500) | 1 (0.200) | 0.300 | 573.211 | 12.500 | 7,165.138 |
+| anotherMethod | 5 (0.200) | 1 (0.100) | 1 (0.100) | 2 (0.100) | 1 (0.100) | 1 (0.200) | 1 (0.100) | 0 (0.000) | 0.050 | 185.470 | 6.250 | 1,159.188 |
+
+---
+
+* **Class:** AnotherClass
+* **File:** AnotherClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| complexMethod | 20 (1.000) | 4 (0.600) | 3 (0.500) | 10 (0.800) | 5 (0.500) | 8 (1.200) | 3 (1.000) | 4 (0.600) | 0.800 | 1,357.824 | 25.000 | 33,945.600 |
+
+---
+

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_Minimal.md

@@ -0,0 +1,27 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+**Total Classes:** 2
+
+---
+
+* **Class:** TestClass
+* **File:** TestClass.php
+
+| Method | Cognitive Complexity |
+|--------|--------|
+| testMethod | 0.300 |
+| anotherMethod | 0.050 |
+
+---
+
+* **Class:** AnotherClass
+* **File:** AnotherClass.php
+
+| Method | Cognitive Complexity |
+|--------|--------|
+| complexMethod | 0.800 |
+
+---
+

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_NoDetailedMetrics.md

@@ -0,0 +1,27 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+**Total Classes:** 2
+
+---
+
+* **Class:** TestClass
+* **File:** TestClass.php
+
+| Method | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|
+| testMethod | 0.300 | 573.211 | 12.500 | 7,165.138 | 5 (low) |
+| anotherMethod | 0.050 | 185.470 | 6.250 | 1,159.188 | 2 (low) |
+
+---
+
+* **Class:** AnotherClass
+* **File:** AnotherClass.php
+
+| Method | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|
+| complexMethod | 0.800 | 1,357.824 | 25.000 | 33,945.600 | 12 (medium) |
+
+---
+

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_SingleTable.md

@@ -0,0 +1,11 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+## All Methods (3 total)
+
+| Class | Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| TestClass | testMethod | 10 (0.500) | 2 (0.300) | 1 (0.200) | 5 (0.400) | 3 (0.300) | 4 (0.600) | 2 (0.500) | 1 (0.200) | 0.300 | 573.211 | 12.500 | 7,165.138 | 5 (low) |
+| TestClass | anotherMethod | 5 (0.200) | 1 (0.100) | 1 (0.100) | 2 (0.100) | 1 (0.100) | 1 (0.200) | 1 (0.100) | 0 (0.000) | 0.050 | 185.470 | 6.250 | 1,159.188 | 2 (low) |
+| AnotherClass | complexMethod | 20 (1.000) | 4 (0.600) | 3 (0.500) | 10 (0.800) | 5 (0.500) | 8 (1.200) | 3 (1.000) | 4 (0.600) | 0.800 | 1,357.824 | 25.000 | 33,945.600 | 12 (medium) |

tests/Unit/Business/Cognitive/Exporter/MarkdownExporterContent_Threshold.md

@@ -0,0 +1,28 @@
+# Cognitive Metrics Report
+
+**Generated:** 2023-10-01 12:00:00
+
+**Total Classes:** 2
+
+**Note:** Only showing methods exceeding threshold of 0.100
+
+---
+
+* **Class:** TestClass
+* **File:** TestClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| testMethod | 10 (0.500) | 2 (0.300) | 1 (0.200) | 5 (0.400) | 3 (0.300) | 4 (0.600) | 2 (0.500) | 1 (0.200) | 0.300 | 573.211 | 12.500 | 7,165.138 | 5 (low) |
+
+---
+
+* **Class:** AnotherClass
+* **File:** AnotherClass.php
+
+| Method | Lines | Args | Returns | Variables | Property Calls | If | If Nesting | Else | Cognitive Complexity | Halstead Volume | Halstead Difficulty | Halstead Effort | Cyclomatic Complexity |
+|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|--------|
+| complexMethod | 20 (1.000) | 4 (0.600) | 3 (0.500) | 10 (0.800) | 5 (0.500) | 8 (1.200) | 3 (1.000) | 4 (0.600) | 0.800 | 1,357.824 | 25.000 | 33,945.600 | 12 (medium) |
+
+---
+