Source for file Notifysend.php
Documentation is available at Notifysend.php
* Notify-send report for PHP_CodeSniffer.
* Supported configuration parameters:
* - notifysend_path - Full path to notify-send cli command
* - notifysend_timeout - Timeout in milliseconds
* - notifysend_showok - Show "ok, all fine" messages (0/1)
* @author Christian Weiske <christian.weiske@netresearch.de>
* @author Greg Sherwood <gsherwood@squiz.net>
* @copyright 2012-2014 Christian Weiske
* @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\Reports;
use PHP_CodeSniffer\Config;
use PHP_CodeSniffer\Files\File;
class Notifysend implements Report
* Notification timeout in milliseconds.
protected $timeout = 3000;
* Path to notify-send command.
protected $path = 'notify-send';
* Show "ok, all fine" messages.
protected $showOk = true;
* Version of installed notify-send executable.
protected $version = null;
* Load configuration data.
public function __construct ()
$path = Config ::getExecutablePath ('notifysend');
$timeout = Config ::getConfigData ('notifysend_timeout');
$this->timeout = (int) $timeout;
$showOk = Config ::getConfigData ('notifysend_showok');
$this->showOk = (boolean) $showOk;
exec($this->path. ' --version')
* Generate a partial report for a single processed file.
* Function should return TRUE if it printed or stored data about the file
* and FALSE if it ignored the file. Returning TRUE indicates that the file and
* its data should be counted in the grand totals.
* @param array $report Prepared report data.
* @param \PHP_CodeSniffer\File $phpcsFile The file being reported on.
* @param bool $showSources Show sources?
* @param int $width Maximum allowed line width.
public function generateFileReport ($report, File $phpcsFile, $showSources=false , $width=80 )
echo $report['filename'].PHP_EOL;
// We want this file counted in the total number
// of checked files even if it has no errors.
}//end generateFileReport()
* Generates a summary of errors and warnings for each file processed.
* @param string $cachedData Any partial report data that was returned from
* generateFileReport during the run.
* @param int $totalFiles Total number of files processed during the run.
* @param int $totalErrors Total number of errors found during the run.
* @param int $totalWarnings Total number of warnings found during the run.
* @param int $totalFixable Total number of problems that can be fixed.
* @param bool $showSources Show sources?
* @param int $width Maximum allowed line width.
* @param bool $interactive Are we running in interactive mode?
* @param bool $toScreen Is the report being printed to screen?
public function generate (
$msg = $this->generateMessage ($checkedFiles, $totalErrors, $totalWarnings);
if ($this->showOk === true ) {
$this->notifyErrors ($msg);
* Generate the error message to show to the user.
* @param string[] $checkedFiles The files checked during the run.
* @param int $totalErrors Total number of errors found during the run.
* @param int $totalWarnings Total number of warnings found during the run.
* @return string Error message or NULL if no error/warning found.
protected function generateMessage ($checkedFiles, $totalErrors, $totalWarnings)
if ($totalErrors === 0 && $totalWarnings === 0 ) {
$totalFiles = count($checkedFiles);
$msg .= 'Checked '. $totalFiles. ' files'.PHP_EOL;
$msg .= $checkedFiles[0 ].PHP_EOL;
if ($totalWarnings > 0 ) {
$msg .= $totalWarnings. ' warnings'.PHP_EOL;
$msg .= $totalErrors. ' errors'.PHP_EOL;
* Tell the user that all is fine and no error/warning has been found.
protected function notifyAllFine ()
$cmd = $this->getBasicCommand ();
$cmd .= ' "PHP CodeSniffer: Ok"';
* Tell the user that errors/warnings have been found.
* @param string $msg Message to display.
protected function notifyErrors ($msg)
$cmd = $this->getBasicCommand ();
$cmd .= ' "PHP CodeSniffer: Error"';
* Generate and return the basic notify-send command string to execute.
* @return string Shell command with common parameters.
protected function getBasicCommand ()
$cmd .= ' --category dev.validate';
$cmd .= ' -h int:transient:1';
$cmd .= ' -t '.(int) $this->timeout;
Documentation generated on Mon, 11 Mar 2019 15:27:39 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.
|