1
0
Fork 0

Refactor commit-ref validation

The require and require-dev arrays have been merged into one and no
longer user private methods/properties to collect warnings.
pull/4529/head
Jeroen Seegers 2015-10-27 13:51:51 +01:00
parent 476c6f279b
commit f3dc31839f
2 changed files with 23 additions and 47 deletions

View File

@ -30,8 +30,6 @@ class ConfigValidator
{ {
private $io; private $io;
private $warnings = array();
public function __construct(IOInterface $io) public function __construct(IOInterface $io)
{ {
$this->io = $io; $this->io = $io;
@ -49,6 +47,7 @@ class ConfigValidator
{ {
$errors = array(); $errors = array();
$publishErrors = array(); $publishErrors = array();
$warnings = array();
// validate json schema // validate json schema
$laxValid = false; $laxValid = false;
@ -86,18 +85,18 @@ class ConfigValidator
$licenseValidator = new SpdxLicenses(); $licenseValidator = new SpdxLicenses();
if ('proprietary' !== $manifest['license'] && array() !== $manifest['license'] && !$licenseValidator->validate($manifest['license'])) { if ('proprietary' !== $manifest['license'] && array() !== $manifest['license'] && !$licenseValidator->validate($manifest['license'])) {
$this->warnings[] = sprintf( $warnings[] = sprintf(
'License %s is not a valid SPDX license identifier, see http://www.spdx.org/licenses/ if you use an open license.' 'License %s is not a valid SPDX license identifier, see http://www.spdx.org/licenses/ if you use an open license.'
."\nIf the software is closed-source, you may use \"proprietary\" as license.", ."\nIf the software is closed-source, you may use \"proprietary\" as license.",
json_encode($manifest['license']) json_encode($manifest['license'])
); );
} }
} else { } else {
$this->warnings[] = 'No license specified, it is recommended to do so. For closed-source software you may use "proprietary" as license.'; $warnings[] = 'No license specified, it is recommended to do so. For closed-source software you may use "proprietary" as license.';
} }
if (isset($manifest['version'])) { if (isset($manifest['version'])) {
$this->warnings[] = 'The version field is present, it is recommended to leave it out if the package is published on Packagist.'; $warnings[] = 'The version field is present, it is recommended to leave it out if the package is published on Packagist.';
} }
if (!empty($manifest['name']) && preg_match('{[A-Z]}', $manifest['name'])) { if (!empty($manifest['name']) && preg_match('{[A-Z]}', $manifest['name'])) {
@ -112,7 +111,7 @@ class ConfigValidator
} }
if (!empty($manifest['type']) && $manifest['type'] == 'composer-installer') { if (!empty($manifest['type']) && $manifest['type'] == 'composer-installer') {
$this->warnings[] = "The package type 'composer-installer' is deprecated. Please distribute your custom installers as plugins from now on. See http://getcomposer.org/doc/articles/plugins.md for plugin documentation."; $warnings[] = "The package type 'composer-installer' is deprecated. Please distribute your custom installers as plugins from now on. See http://getcomposer.org/doc/articles/plugins.md for plugin documentation.";
} }
// check for require-dev overrides // check for require-dev overrides
@ -120,20 +119,27 @@ class ConfigValidator
$requireOverrides = array_intersect_key($manifest['require'], $manifest['require-dev']); $requireOverrides = array_intersect_key($manifest['require'], $manifest['require-dev']);
if (!empty($requireOverrides)) { if (!empty($requireOverrides)) {
$plural = (count($requireOverrides) > 1) ? 'are' : 'is'; $plural = (count($requireOverrides) > 1) ? 'are' : 'is';
$this->warnings[] = implode(', ', array_keys($requireOverrides)). " {$plural} required both in require and require-dev, this can lead to unexpected behavior"; $warnings[] = implode(', ', array_keys($requireOverrides)). " {$plural} required both in require and require-dev, this can lead to unexpected behavior";
} }
} }
// check for commit references // check for commit references
$this->checkForCommitReferences($manifest['require']); $packages = array_merge($manifest['require'], $manifest['require-dev']);
$this->checkForCommitReferences($manifest['require-dev']); foreach ($packages as $package => $version) {
if (preg_match('/#/', $version) === 1) {
$warnings[] = sprintf(
'The package "%s" is pointing to a commit-ref, this is bad practice and can cause unforeseen issues.',
$package
);
}
}
// check for empty psr-0/psr-4 namespace prefixes // check for empty psr-0/psr-4 namespace prefixes
if (isset($manifest['autoload']['psr-0'][''])) { if (isset($manifest['autoload']['psr-0'][''])) {
$this->warnings[] = "Defining autoload.psr-0 with an empty namespace prefix is a bad idea for performance"; $warnings[] = "Defining autoload.psr-0 with an empty namespace prefix is a bad idea for performance";
} }
if (isset($manifest['autoload']['psr-4'][''])) { if (isset($manifest['autoload']['psr-4'][''])) {
$this->warnings[] = "Defining autoload.psr-4 with an empty namespace prefix is a bad idea for performance"; $warnings[] = "Defining autoload.psr-4 with an empty namespace prefix is a bad idea for performance";
} }
try { try {
@ -149,27 +155,8 @@ class ConfigValidator
$errors = array_merge($errors, $e->getErrors()); $errors = array_merge($errors, $e->getErrors());
} }
$this->warnings = array_merge($this->warnings, $loader->getWarnings()); $warnings = array_merge($warnings, $loader->getWarnings());
return array($errors, $publishErrors, $this->warnings); return array($errors, $publishErrors, $warnings);
}
/**
* Check for explicit commit references.
*
* @param array $packages An array of packages and their versions
*
* @return void
*/
private function checkForCommitReferences(array $packages)
{
foreach ($packages as $package => $version) {
if (preg_match('/#/', $version) === 1) {
$this->warnings[] = sprintf(
'The package "%s" is pointing to a commit-ref, this is bad practice and can cause unforeseen issues.',
$package
);
}
}
} }
} }

View File

@ -27,22 +27,11 @@ class ConfigValidatorTest extends TestCase
public function testConfigValidatorCommitRefWarning() public function testConfigValidatorCommitRefWarning()
{ {
$configValidator = new ConfigValidator(new NullIO()); $configValidator = new ConfigValidator(new NullIO());
$reflection = new \ReflectionClass(get_class($configValidator)); list(, , $warnings) = $configValidator->validate(__DIR__ . '/Fixtures/composer_commit-ref.json');
$method = $reflection->getMethod('checkForCommitReferences');
$warnings = $reflection->getProperty('warnings');
$method->setAccessible(true); $this->assertEquals(true, in_array(
$warnings->setAccessible(true); 'The package "some/package" is pointing to a commit-ref, this is bad practice and can cause unforeseen issues.',
$warnings
$this->assertEquals(0, count($warnings->getValue($configValidator)));
$method->invokeArgs($configValidator, array(
array(
'some-package' => 'dev-master#62c4da6',
'another-package' => '^1.0.0'
)
)); ));
$this->assertEquals(1, count($warnings->getValue($configValidator)));
} }
} }