. * * @package LibreNMS * @link http://librenms.org * @copyright 2016 Neil Lathwood * @author Neil Lathwood */ namespace LibreNMS\Tests; use LibreNMS\Config; use PHPUnit_Framework_ExpectationFailedException as PHPUnitException; use Symfony\Component\Yaml\Exception\ParseException; use Symfony\Component\Yaml\Yaml; class YamlTest extends TestCase { private $valid_os_discovery_keys = array( 'sysDescr', 'sysDescr_except', 'sysObjectId', 'sysObjectId_except', 'sysDescr_regex', 'sysDescr_regex_except', 'sysObjectId_regex', 'sysObjectId_regex_except', 'snmpget', 'snmpget_except' ); private $valid_snmpget_keys = array( 'oid', 'options', 'mib', 'mib_dir', 'op', 'value', ); private $valid_comparisons = array( '=', '!=', '==', '!==', '<=', '>=', '<', '>', 'starts', 'ends', 'contains', 'regex', ); public function testOSYaml() { $pattern = Config::get('install_dir') . '/includes/definitions/*.yaml'; foreach (glob($pattern) as $file) { try { $data = Yaml::parse(file_get_contents($file)); } catch (ParseException $e) { throw new PHPUnitException("$file Could not be parsed"); } $this->assertArrayHasKey('os', $data, $file); $this->assertArrayHasKey('type', $data, $file); $this->assertArrayHasKey('text', $data, $file); // test discovery keys if (isset($data['discovery'])) { foreach ((array)$data['discovery'] as $group) { // make sure we have at least one valid discovery key $keys = array_keys($group); $this->assertNotEmpty($keys, "$file: contains no os discovery keys"); $this->assertNotEmpty( array_intersect($keys, $this->valid_os_discovery_keys), "$file: contains no valid os discovery keys: " . var_export($keys, true) ); foreach ((array)$group as $key => $item) { $this->assertContains($key, $this->valid_os_discovery_keys, "$file: invalid discovery type $key"); if (starts_with($key, 'snmpget')) { foreach ($item as $get_key => $get_val) { $this->assertContains($get_key, $this->valid_snmpget_keys, "$file: invalid snmpget option $get_key"); } $this->assertArrayHasKey('oid', $item, "$file: snmpget discovery must specify oid"); $this->assertArrayHasKey('value', $item, "$file: snmpget discovery must specify value"); if (isset($item['op'])) { $this->assertContains($item['op'], $this->valid_comparisons, "$file: invalid op ${item['op']}"); } } } } } } } /** * @dataProvider listDiscoveryFiles * @param $file */ public function testDiscoveryYaml($file) { try { $data = Yaml::parse(file_get_contents(Config::get('install_dir') . "/includes/definitions/discovery/$file")); } catch (ParseException $e) { throw new PHPUnitException("includes/definitions/discovery/$file Could not be parsed"); } foreach ($data['modules'] as $module => $sub_modules) { foreach ($sub_modules as $type => $sub_module) { $this->assertArrayHasKey('data', $sub_module, "$type is missing data key"); foreach ($sub_module['data'] as $sensor_index => $sensor) { $this->assertArrayHasKey('oid', $sensor, "$type.data.$sensor_index is missing oid key"); if ($type !== 'pre-cache') { $this->assertArrayHasKey('num_oid', $sensor, "$type.data.$sensor_index(${sensor['oid']}) is missing num_oid key"); $this->assertArrayHasKey('descr', $sensor, "$type.data.$sensor_index(${sensor['oid']}) is missing descr key"); } if ($type === 'state') { $this->assertArrayHasKey('states', $sensor, "$type.data(${sensor['oid']}) is missing states key"); foreach ($sensor['states'] as $state_index => $state) { $this->assertArrayHasKey('descr', $state, "$type.data.$sensor_index(${sensor['oid']}).states.$state_index is missing descr key"); $this->assertNotEmpty($state['descr'], "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) descr must not be empty"); $this->assertArrayHasKey('graph', $state, "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) is missing graph key"); $this->assertTrue($state['graph'] === 0 || $state['graph'] === 1, "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) invalid graph value must be 0 or 1"); $this->assertArrayHasKey('value', $state, "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) is missing value key"); $this->assertInternalType('int', $state['value'], "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) value must be an int"); $this->assertArrayHasKey('generic', $state, "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) is missing generic key"); $this->assertInternalType('int', $state['generic'], "$type.data.$sensor_index(${sensor['oid']}).states.$state_index(${state['descr']}) generic must be an int"); } } } } } } public function listDiscoveryFiles() { $pattern = Config::get('install_dir') . '/includes/definitions/discovery/*.yaml'; return array_map(function ($file) { return array(basename($file)); }, glob($pattern)); } }