diff vendor/squizlabs/php_codesniffer/src/Reporter.php @ 4:a9cd425dd02b

Update, including to Drupal core 8.6.10

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/vendor/squizlabs/php_codesniffer/src/Reporter.php	Thu Feb 28 13:11:55 2019 +0000
@@ -0,0 +1,422 @@
+<?php
+/**
+ * Manages reporting of errors and warnings.
+ *
+ * @author    Greg Sherwood <[e-mail]>
+ * @copyright 2006-2015 Squiz Pty Ltd (ABN 77 084 670 600)
+ * @license   https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
+ */
+
+namespace PHP_CodeSniffer;
+
+use PHP_CodeSniffer\Reports\Report;
+use PHP_CodeSniffer\Files\File;
+use PHP_CodeSniffer\Exceptions\RuntimeException;
+use PHP_CodeSniffer\Exceptions\DeepExitException;
+use PHP_CodeSniffer\Util\Common;
+
+class Reporter
+{
+
+    /**
+     * The config data for the run.
+     *
+     * @var \PHP_CodeSniffer\Config
+     */
+    public $config = null;
+
+    /**
+     * Total number of files that contain errors or warnings.
+     *
+     * @var integer
+     */
+    public $totalFiles = 0;
+
+    /**
+     * Total number of errors found during the run.
+     *
+     * @var integer
+     */
+    public $totalErrors = 0;
+
+    /**
+     * Total number of warnings found during the run.
+     *
+     * @var integer
+     */
+    public $totalWarnings = 0;
+
+    /**
+     * Total number of errors/warnings that can be fixed.
+     *
+     * @var integer
+     */
+    public $totalFixable = 0;
+
+    /**
+     * Total number of errors/warnings that were fixed.
+     *
+     * @var integer
+     */
+    public $totalFixed = 0;
+
+    /**
+     * When the PHPCS run started.
+     *
+     * @var float
+     */
+    public static $startTime = 0;
+
+    /**
+     * A cache of report objects.
+     *
+     * @var array
+     */
+    private $reports = [];
+
+    /**
+     * A cache of opened temporary files.
+     *
+     * @var array
+     */
+    private $tmpFiles = [];
+
+
+    /**
+     * Initialise the reporter.
+     *
+     * All reports specified in the config will be created and their
+     * output file (or a temp file if none is specified) initialised by
+     * clearing the current contents.
+     *
+     * @param \PHP_CodeSniffer\Config $config The config data for the run.
+     *
+     * @return void
+     * @throws RuntimeException If a report is not available.
+     */
+    public function __construct(Config $config)
+    {
+        $this->config = $config;
+
+        foreach ($config->reports as $type => $output) {
+            if ($output === null) {
+                $output = $config->reportFile;
+            }
+
+            $reportClassName = '';
+            if (strpos($type, '.') !== false) {
+                // This is a path to a custom report class.
+                $filename = realpath($type);
+                if ($filename === false) {
+                    $error = "ERROR: Custom report \"$type\" not found".PHP_EOL;
+                    throw new DeepExitException($error, 3);
+                }
+
+                $reportClassName = Autoload::loadFile($filename);
+            } else if (class_exists('PHP_CodeSniffer\Reports\\'.ucfirst($type)) === true) {
+                // PHPCS native report.
+                $reportClassName = 'PHP_CodeSniffer\Reports\\'.ucfirst($type);
+            } else if (class_exists($type) === true) {
+                // FQN of a custom report.
+                $reportClassName = $type;
+            } else {
+                // OK, so not a FQN, try and find the report using the registered namespaces.
+                $registeredNamespaces = Autoload::getSearchPaths();
+                $trimmedType          = ltrim($type, '\\');
+
+                foreach ($registeredNamespaces as $nsPrefix) {
+                    if ($nsPrefix === '') {
+                        continue;
+                    }
+
+                    if (class_exists($nsPrefix.'\\'.$trimmedType) === true) {
+                        $reportClassName = $nsPrefix.'\\'.$trimmedType;
+                        break;
+                    }
+                }
+            }//end if
+
+            if ($reportClassName === '') {
+                $error = "ERROR: Class file for report \"$type\" not found".PHP_EOL;
+                throw new DeepExitException($error, 3);
+            }
+
+            $reportClass = new $reportClassName();
+            if (false === ($reportClass instanceof Report)) {
+                throw new RuntimeException('Class "'.$reportClassName.'" must implement the "PHP_CodeSniffer\Report" interface.');
+            }
+
+            $this->reports[$type] = [
+                'output' => $output,
+                'class'  => $reportClass,
+            ];
+
+            if ($output === null) {
+                // Using a temp file.
+                // This needs to be set in the constructor so that all
+                // child procs use the same report file when running in parallel.
+                $this->tmpFiles[$type] = tempnam(sys_get_temp_dir(), 'phpcs');
+                file_put_contents($this->tmpFiles[$type], '');
+            } else {
+                file_put_contents($output, '');
+            }
+        }//end foreach
+
+    }//end __construct()
+
+
+    /**
+     * Generates and prints final versions of all reports.
+     *
+     * Returns TRUE if any of the reports output content to the screen
+     * or FALSE if all reports were silently printed to a file.
+     *
+     * @return bool
+     */
+    public function printReports()
+    {
+        $toScreen = false;
+        foreach ($this->reports as $type => $report) {
+            if ($report['output'] === null) {
+                $toScreen = true;
+            }
+
+            $this->printReport($type);
+        }
+
+        return $toScreen;
+
+    }//end printReports()
+
+
+    /**
+     * Generates and prints a single final report.
+     *
+     * @param string $report The report type to print.
+     *
+     * @return void
+     */
+    public function printReport($report)
+    {
+        $reportClass = $this->reports[$report]['class'];
+        $reportFile  = $this->reports[$report]['output'];
+
+        if ($reportFile !== null) {
+            $filename = $reportFile;
+            $toScreen = false;
+        } else {
+            if (isset($this->tmpFiles[$report]) === true) {
+                $filename = $this->tmpFiles[$report];
+            } else {
+                $filename = null;
+            }
+
+            $toScreen = true;
+        }
+
+        $reportCache = '';
+        if ($filename !== null) {
+            $reportCache = file_get_contents($filename);
+        }
+
+        ob_start();
+        $reportClass->generate(
+            $reportCache,
+            $this->totalFiles,
+            $this->totalErrors,
+            $this->totalWarnings,
+            $this->totalFixable,
+            $this->config->showSources,
+            $this->config->reportWidth,
+            $this->config->interactive,
+            $toScreen
+        );
+        $generatedReport = ob_get_contents();
+        ob_end_clean();
+
+        if ($this->config->colors !== true || $reportFile !== null) {
+            $generatedReport = preg_replace('`\033\[[0-9;]+m`', '', $generatedReport);
+        }
+
+        if ($reportFile !== null) {
+            if (PHP_CODESNIFFER_VERBOSITY > 0) {
+                echo $generatedReport;
+            }
+
+            file_put_contents($reportFile, $generatedReport.PHP_EOL);
+        } else {
+            echo $generatedReport;
+            if ($filename !== null && file_exists($filename) === true) {
+                unlink($filename);
+                unset($this->tmpFiles[$report]);
+            }
+        }
+
+    }//end printReport()
+
+
+    /**
+     * Caches the result of a single processed file for all reports.
+     *
+     * The report content that is generated is appended to the output file
+     * assigned to each report. This content may be an intermediate report format
+     * and not reflect the final report output.
+     *
+     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file that has been processed.
+     *
+     * @return void
+     */
+    public function cacheFileReport(File $phpcsFile)
+    {
+        if (isset($this->config->reports) === false) {
+            // This happens during unit testing, or any time someone just wants
+            // the error data and not the printed report.
+            return;
+        }
+
+        $reportData  = $this->prepareFileReport($phpcsFile);
+        $errorsShown = false;
+
+        foreach ($this->reports as $type => $report) {
+            $reportClass = $report['class'];
+
+            ob_start();
+            $result = $reportClass->generateFileReport($reportData, $phpcsFile, $this->config->showSources, $this->config->reportWidth);
+            if ($result === true) {
+                $errorsShown = true;
+            }
+
+            $generatedReport = ob_get_contents();
+            ob_end_clean();
+
+            if ($report['output'] === null) {
+                // Using a temp file.
+                if (isset($this->tmpFiles[$type]) === false) {
+                    // When running in interactive mode, the reporter prints the full
+                    // report many times, which will unlink the temp file. So we need
+                    // to create a new one if it doesn't exist.
+                    $this->tmpFiles[$type] = tempnam(sys_get_temp_dir(), 'phpcs');
+                    file_put_contents($this->tmpFiles[$type], '');
+                }
+
+                file_put_contents($this->tmpFiles[$type], $generatedReport, (FILE_APPEND | LOCK_EX));
+            } else {
+                file_put_contents($report['output'], $generatedReport, (FILE_APPEND | LOCK_EX));
+            }//end if
+        }//end foreach
+
+        if ($errorsShown === true || PHP_CODESNIFFER_CBF === true) {
+            $this->totalFiles++;
+            $this->totalErrors   += $reportData['errors'];
+            $this->totalWarnings += $reportData['warnings'];
+
+            // When PHPCBF is running, we need to use the fixable error values
+            // after the report has run and fixed what it can.
+            if (PHP_CODESNIFFER_CBF === true) {
+                $this->totalFixable += $phpcsFile->getFixableCount();
+                $this->totalFixed   += $phpcsFile->getFixedCount();
+            } else {
+                $this->totalFixable += $reportData['fixable'];
+            }
+        }
+
+    }//end cacheFileReport()
+
+
+    /**
+     * Generate summary information to be used during report generation.
+     *
+     * @param \PHP_CodeSniffer\Files\File $phpcsFile The file that has been processed.
+     *
+     * @return array
+     */
+    public function prepareFileReport(File $phpcsFile)
+    {
+        $report = [
+            'filename' => Common::stripBasepath($phpcsFile->getFilename(), $this->config->basepath),
+            'errors'   => $phpcsFile->getErrorCount(),
+            'warnings' => $phpcsFile->getWarningCount(),
+            'fixable'  => $phpcsFile->getFixableCount(),
+            'messages' => [],
+        ];
+
+        if ($report['errors'] === 0 && $report['warnings'] === 0) {
+            // Prefect score!
+            return $report;
+        }
+
+        if ($this->config->recordErrors === false) {
+            $message  = 'Errors are not being recorded but this report requires error messages. ';
+            $message .= 'This report will not show the correct information.';
+            $report['messages'][1][1] = [
+                [
+                    'message'  => $message,
+                    'source'   => 'Internal.RecordErrors',
+                    'severity' => 5,
+                    'fixable'  => false,
+                    'type'     => 'ERROR',
+                ],
+            ];
+            return $report;
+        }
+
+        $errors = [];
+
+        // Merge errors and warnings.
+        foreach ($phpcsFile->getErrors() as $line => $lineErrors) {
+            foreach ($lineErrors as $column => $colErrors) {
+                $newErrors = [];
+                foreach ($colErrors as $data) {
+                    $newErrors[] = [
+                        'message'  => $data['message'],
+                        'source'   => $data['source'],
+                        'severity' => $data['severity'],
+                        'fixable'  => $data['fixable'],
+                        'type'     => 'ERROR',
+                    ];
+                }
+
+                $errors[$line][$column] = $newErrors;
+            }
+
+            ksort($errors[$line]);
+        }//end foreach
+
+        foreach ($phpcsFile->getWarnings() as $line => $lineWarnings) {
+            foreach ($lineWarnings as $column => $colWarnings) {
+                $newWarnings = [];
+                foreach ($colWarnings as $data) {
+                    $newWarnings[] = [
+                        'message'  => $data['message'],
+                        'source'   => $data['source'],
+                        'severity' => $data['severity'],
+                        'fixable'  => $data['fixable'],
+                        'type'     => 'WARNING',
+                    ];
+                }
+
+                if (isset($errors[$line]) === false) {
+                    $errors[$line] = [];
+                }
+
+                if (isset($errors[$line][$column]) === true) {
+                    $errors[$line][$column] = array_merge(
+                        $newWarnings,
+                        $errors[$line][$column]
+                    );
+                } else {
+                    $errors[$line][$column] = $newWarnings;
+                }
+            }//end foreach
+
+            ksort($errors[$line]);
+        }//end foreach
+
+        ksort($errors);
+        $report['messages'] = $errors;
+        return $report;
+
+    }//end prepareFileReport()
+
+
+}//end class