Added lnms dev:check modules only (librenms#17044)

* lnms dev:check --os-modules-only always
Make --os-modules-only always work.  So if you run as worked before like this to skip os detection tests:
`lnms dev:check unit --os ios --os-modules-only`

Or like this to just test all discovery/polling modules (new):
`lnms dev:check unit --os-modules-only`

* Doc improvement

Author: murrant

LibreNMS/Util/CiHelper.php

@@ -203,7 +203,7 @@ public function checkUnit()
             array_push($phpunit_cmd, '--group', 'docs');
         } elseif ($this->flags['unit_svg']) {
             $phpunit_cmd[] = 'tests/SVGTest.php';
-        } elseif ($this->flags['unit_modules']) {
+        } elseif ($this->flags['unit_modules'] || $this->flags['os-modules-only']) {
             $phpunit_cmd[] = 'tests/OSModulesTest.php';
         }
 

app/Console/Commands/DevCheckCommand.php

@@ -96,11 +96,14 @@ private function parseInput()
                 'lint_enable' => false,
                 'unit_enable' => true,
                 'web_enable' => false,
-                'os-modules-only' => $this->option('os-modules-only'),
             ]);
             $this->helper->setOS(explode(',', $os));
         }
 
+        $this->helper->setFlags([
+            'os-modules-only' => $this->option('os-modules-only'),
+        ]);
+
         if ($modules = $this->option('module')) {
             $this->helper->setFlags(['style_enable' => false, 'lint_enable' => false, 'unit_enable' => true, 'web_enable' => false]);
             $this->helper->setModules(explode(',', $modules));

doc/Developing/os/Test-Units.md

@@ -64,10 +64,17 @@ tests: `lnms dev:check unit --db --snmpsim`
 
 `lnms dev:check unit -o osname`
 
+### Test an OS, but only discovery and polling modules (exluding OS detection)
+`lnms dev:check unit --os osname --os-modules-only`
+
+
 ### Specific Module
 
 `lnms dev:check unit -m modulename`
 
+### Test all modules for all os and stop on failure
+`lnms dev:check unit --db -snmpsim --os-modules-only -f`
+
 ## Using snmpsim for testing
 
 You can run snmpsim to access test data by running
@@ -83,6 +90,17 @@ the community and 127.1.6.1:1161 as the host.
 snmpget -v 2c -c ios_c3560e 127.1.6.1:1161 sysDescr.0
 ```
 
+## Simulate specific device from test data
+
+Add/update a device called "snmpsim" to your install and set to use a specific snmprec file
+
+```bash
+lnms dev:simulate ios_2960x
+```
+
+You can then run `./discovery.php -h snmpsim -d -v` and `lnms device:poll snmpsim -vvv`
+to discover and poll the simulated device.
+
 ## Snmprec format
 
 Snmprec files are simple files that store the snmp data. The data