mirror of
https://github.com/snipe/snipe-it.git
synced 2024-11-10 07:34:06 -08:00
934afa036f
Shift automatically applies the Laravel coding style - which uses the PSR-2 coding style as a base with some minor additions. You may customize the adopted coding style by adding your own [PHP CS Fixer][1] `.php_cs` config file to your project root. Feel free to use [Shift's Laravel ruleset][2] to help you get started. [1]: https://github.com/FriendsOfPHP/PHP-CS-Fixer [2]: https://gist.github.com/laravel-shift/cab527923ed2a109dda047b97d53c200
134 lines
3.9 KiB
PHP
134 lines
3.9 KiB
PHP
<?php
|
|
|
|
/**
|
|
* A helper class for Codeception (http://codeception.com/) that allows automated HTML5 Validation
|
|
* using the Nu Html Checker (http://validator.github.io/validator/) during acceptance testing.
|
|
* It uses local binaries and can therefore be run offline.
|
|
*
|
|
*
|
|
* Requirements:
|
|
* =============
|
|
*
|
|
* - Codeception with WebDriver set up (PhpBrowser doesn't work)
|
|
* - java is installed locally
|
|
* - The vnu.jar is installed locally (download the .zip from https://github.com/validator/validator/releases,
|
|
* it contains the .jar file)
|
|
*
|
|
*
|
|
* Installation:
|
|
* =============
|
|
*
|
|
* - Copy this file to _support/Helper/ in the codeception directory
|
|
* - Merge the following configuration to acceptance.suite.yml:
|
|
*
|
|
* modules:
|
|
* enabled:
|
|
* - \Helper\HTMLValidator
|
|
* config:
|
|
* \Helper\HTMLValidator:
|
|
* javaPath: /usr/bin/java
|
|
* vnuPath: /usr/local/bin/vnu.jar
|
|
*
|
|
*
|
|
*
|
|
* Usage:
|
|
* ======
|
|
*
|
|
* Validate the HTML of the current page:
|
|
* $I->validateHTML();
|
|
*
|
|
* Validate the HTML of the current page, but ignore errors containing the string "Ignoreit":
|
|
* $I->validateHTML(["Ignoreme"]);
|
|
*
|
|
*
|
|
*
|
|
* @license http://www.opensource.org/licenses/mit-license.html MIT License
|
|
* @author Tobias Hößl <tobias@hoessl.eu>
|
|
*/
|
|
|
|
namespace Helper;
|
|
|
|
use Codeception\TestCase;
|
|
|
|
class HTMLValidator extends \Codeception\Module
|
|
{
|
|
/**
|
|
* @param string $html
|
|
* @return array
|
|
* @throws \Exception
|
|
*/
|
|
private function validateByVNU($html)
|
|
{
|
|
$javaPath = $this->_getConfig('javaPath');
|
|
if (! $javaPath) {
|
|
$javaPath = 'java';
|
|
}
|
|
$vnuPath = $this->_getConfig('vnuPath');
|
|
if (! $vnuPath) {
|
|
$vnuPath = '/usr/local/bin/vnu.jar';
|
|
}
|
|
|
|
$filename = DIRECTORY_SEPARATOR.'tmp'.DIRECTORY_SEPARATOR.uniqid('html-validate').'.html';
|
|
file_put_contents($filename, $html);
|
|
exec($javaPath.' -Xss1024k -jar '.$vnuPath.' --format json '.$filename.' 2>&1', $return);
|
|
$data = json_decode($return[0], true);
|
|
if (! $data || ! isset($data['messages']) || ! is_array($data['messages'])) {
|
|
throw new \Exception('Invalid data returned from validation service: '.$return);
|
|
}
|
|
|
|
return $data['messages'];
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
* @throws \Codeception\Exception\ModuleException
|
|
* @throws \Exception
|
|
*/
|
|
private function getPageSource()
|
|
{
|
|
if (! $this->hasModule('WebDriver')) {
|
|
throw new \Exception('This validator needs WebDriver to work');
|
|
}
|
|
|
|
/** @var \Codeception\Module\WebDriver $webdriver */
|
|
$webdriver = $this->getModule('WebDriver');
|
|
|
|
return $webdriver->webDriver->getPageSource();
|
|
}
|
|
|
|
/**
|
|
* @param string[] $ignoreMessages
|
|
*/
|
|
public function validateHTML($ignoreMessages = [])
|
|
{
|
|
$source = $this->getPageSource();
|
|
try {
|
|
$messages = $this->validateByVNU($source);
|
|
} catch (\Exception $e) {
|
|
$this->fail($e->getMessage());
|
|
|
|
return;
|
|
}
|
|
$failMessages = [];
|
|
$lines = explode("\n", $source);
|
|
foreach ($messages as $message) {
|
|
if ($message['type'] == 'error') {
|
|
$formattedMsg = '- Line '.$message['lastLine'].', column '.$message['lastColumn'].': '.
|
|
$message['message']."\n > ".$lines[$message['lastLine'] - 1];
|
|
$ignoring = false;
|
|
foreach ($ignoreMessages as $ignoreMessage) {
|
|
if (mb_stripos($formattedMsg, $ignoreMessage) !== false) {
|
|
$ignoring = true;
|
|
}
|
|
}
|
|
if (! $ignoring) {
|
|
$failMessages[] = $formattedMsg;
|
|
}
|
|
}
|
|
}
|
|
if (count($failMessages) > 0) {
|
|
\PHPUnit_Framework_Assert::fail('Invalid HTML: '."\n".implode("\n", $failMessages));
|
|
}
|
|
}
|
|
}
|