ArcanistCSSLintLinter.php
View Options

	<?php

	/**
	* Uses "CSS lint" to detect checkstyle errors in css code.
	* To use this linter, you must install CSS lint.
	* ##npm install csslint -g## (don't forget the -g flag or NPM will install
	* the package locally).
	*
	* @group linter
	*/
	final class ArcanistCSSLintLinter extends ArcanistExternalLinter {

	public function getLinterName() {
	return 'CSSLint';
	}

	public function getLinterConfigurationName() {
	return 'csslint';
	}

	public function getMandatoryFlags() {
	return array('--format=lint-xml');
	}

	public function getDefaultFlags() {
	// TODO: Deprecation warning.
	$config = $this->getEngine()->getConfigurationManager();
	return $config->getConfigFromAnySource('lint.csslint.options', array());
	}

	public function getDefaultBinary() {
	// TODO: Deprecation warning.
	$config = $this->getEngine()->getConfigurationManager();
	return $config->getConfigFromAnySource('lint.csslint.bin', 'csslint');
	}

	public function getVersion() {
	list($stdout) = execx('%C --version', $this->getExecutableCommand());

	$matches = array();
	if (preg_match('/^v(?P<version>\d+\.\d+\.\d+)$/', $stdout, $matches)) {
	return $matches['version'];
	} else {
	return false;
	}
	}

	public function getInstallInstructions() {
	return pht('Install CSSLint using `npm install -g csslint`.');
	}

	public function shouldExpectCommandErrors() {
	return true;
	}

	protected function parseLinterOutput($path, $err, $stdout, $stderr) {
	$report_dom = new DOMDocument();
	$ok = @$report_dom->loadXML($stdout);

	if (!$ok) {
	return false;
	}

	$files = $report_dom->getElementsByTagName('file');
	$messages = array();
	foreach ($files as $file) {
	foreach ($file->childNodes as $child) {
	if (!($child instanceof DOMElement)) {
	continue;
	}

	$data = $this->getData($path);
	$lines = explode("\n", $data);
	$name = $child->getAttribute('reason');
	$severity = ($child->getAttribute('severity') == 'warning')
	? ArcanistLintSeverity::SEVERITY_WARNING
	: ArcanistLintSeverity::SEVERITY_ERROR;

	$message = new ArcanistLintMessage();
	$message->setPath($path);
	$message->setLine($child->getAttribute('line'));
	$message->setChar($child->getAttribute('char'));
	$message->setCode('CSSLint');
	$message->setDescription($child->getAttribute('reason'));
	$message->setSeverity($severity);

	if ($child->hasAttribute('line') && $child->getAttribute('line') > 0) {
	$line = $lines[$child->getAttribute('line') - 1];
	$text = substr($line, $child->getAttribute('char') - 1);
	$message->setOriginalText($text);
	}

	$messages[] = $message;
	}
	}

	return $messages;
	}

	protected function getLintCodeFromLinterConfigurationKey($code) {

	// NOTE: We can't figure out which rule generated each message, so we
	// can not customize severities. I opened a pull request to add this
	// ability; see:
	//
	// https://github.com/stubbornella/csslint/pull/409

	throw new Exception(
	pht(
	"CSSLint does not currently support custom severity levels, because ".
	"rules can't be identified from messages in output. ".
	"See Pull Request #409."));
	}

	}

File Metadata

Mime Type: text/x-php
Expires: Mon, Mar 24, 00:34 (1 d, 4 h ago)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 1259314
Default Alt Text: ArcanistCSSLintLinter.php (3 KB)

ArcanistCSSLintLinter.php
No OneTemporary
Actions

ArcanistCSSLintLinter.php
View Options

File Metadata

Event Timeline

ArcanistCSSLintLinter.phpNo OneTemporaryActions

ArcanistCSSLintLinter.phpView Options

File Metadata

Event Timeline

ArcanistCSSLintLinter.php
No OneTemporary
Actions

ArcanistCSSLintLinter.php
View Options