mirror of
https://github.com/librenms/librenms.git
synced 2024-09-21 10:28:13 +00:00
60fa0d8479
* Changelog cleanup Split out previous years and try to exclude from search index * Update test exception
65 lines
2.0 KiB
PHP
65 lines
2.0 KiB
PHP
<?php
|
|
/**
|
|
* DocsTest.php
|
|
*
|
|
* Tests for Docs.
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
* @link https://www.librenms.org
|
|
*
|
|
* @copyright 2018 Neil Lathwood
|
|
* @author Neil Lathwood <gh+n@laf.io>
|
|
*/
|
|
|
|
namespace LibreNMS\Tests;
|
|
|
|
use Symfony\Component\Yaml\Yaml;
|
|
|
|
class DocsTest extends TestCase
|
|
{
|
|
private $hidden_pages = [
|
|
'General/Changelogs/2013.md',
|
|
'General/Changelogs/2014.md',
|
|
'General/Changelogs/2015.md',
|
|
'General/Changelogs/2016.md',
|
|
'General/Changelogs/2017.md',
|
|
'General/Changelogs/2018.md',
|
|
'General/Changelogs/2019.md',
|
|
'General/Changelogs/2020.md',
|
|
'General/Changelogs/2021.md',
|
|
'General/Changelogs/2022.md',
|
|
'General/Changelogs/2023.md',
|
|
];
|
|
|
|
/**
|
|
* @group docs
|
|
*/
|
|
public function testDocExist(): void
|
|
{
|
|
$mkdocs = Yaml::parse(file_get_contents(__DIR__ . '/../mkdocs.yml'));
|
|
$dir = __DIR__ . '/../doc/';
|
|
$files = str_replace($dir, '', rtrim(`find $dir -name '*.md'`));
|
|
|
|
// check for missing pages
|
|
collect(explode(PHP_EOL, $files))
|
|
->diff(collect($mkdocs['nav'])->flatten()->merge($this->hidden_pages)) // grab defined pages and diff
|
|
->each(function ($missing_doc) {
|
|
$this->fail("The doc $missing_doc doesn't exist in mkdocs.yml, please add it to the relevant section");
|
|
});
|
|
|
|
$this->expectNotToPerformAssertions();
|
|
}
|
|
}
|