renovate/test/website-docs.spec.ts
Jamie Magee 8554df5c61 test: convert top level tests to typescript (#4526)
Also convert usage of chai to jest
2019-09-25 11:40:58 +02:00

94 lines
3.1 KiB
TypeScript

import fs from 'fs';
import { RenovateOptions } from '../lib/config/definitions';
const options: RenovateOptions[] = require('../lib/config/definitions').getOptions();
describe('docs', () => {
const doc = fs.readFileSync('docs/usage/configuration-options.md', 'utf8');
const selfHostDoc = fs.readFileSync(
'docs/usage/self-hosted-configuration.md',
'utf8'
);
const headers = doc
.match(/\n## (.*?)\n/g)
.map(match => match.substring(4, match.length - 1));
const selfHostHeaders = selfHostDoc
.match(/\n## (.*?)\n/g)
.map(match => match.substring(4, match.length - 1));
const expectedOptions = options
.filter(option => option.stage !== 'global')
.filter(option => option.releaseStatus !== 'unpublished')
.filter(option => !option.admin)
.filter(option => !option.parent)
.map(option => option.name)
.sort();
const selfHostExpectedOptions = options
.filter(option => option.admin || option.stage === 'global')
.map(option => option.name)
.sort();
it('has doc headers sorted alphabetically', () => {
expect(headers).toEqual([...headers].sort());
});
it('has headers for every required option', () => {
expect(headers).toEqual(expectedOptions);
});
it('has self hosted doc headers sorted alphabetically', () => {
expect(selfHostHeaders).toEqual([...selfHostHeaders].sort());
});
it('has headers (self hosted) for every required option', () => {
expect(selfHostHeaders).toEqual(selfHostExpectedOptions);
});
const headers3 = doc
.match(/\n### (.*?)\n/g)
.map(match => match.substring(5, match.length - 1));
headers3.sort();
const expectedOptions3 = options
.filter(option => option.stage !== 'global')
.filter(option => !option.admin)
.filter(option => option.parent)
.map(option => option.name)
.sort();
expectedOptions3.sort();
it('has headers for every required sub-option', () => {
expect(headers3).toEqual(expectedOptions3);
});
// Checking relatedOptions field in definitions
let relatedOptions = options
.filter(option => option.relatedOptions)
.map(option => option.relatedOptions)
.sort();
relatedOptions = [].concat(...relatedOptions); // Converts the matrix to an 1D array
relatedOptions = [...new Set(relatedOptions)]; // Makes all options unique
/*
Matcher which checks if the argument is within the received array (or string)
on an error, it throws a custom message.
*/
expect.extend({
toContainOption(received, argument) {
if (received.includes(argument)) {
return {
message: () => `Option "${argument}" should be within definitions`,
pass: true,
};
}
return {
message: () => `Option "${argument}" doesn't exist within definitions`,
pass: false,
};
},
});
const allOptionNames = options.map(option => option.name).sort();
// Lists through each option in the relatedOptions array to be able to locate the exact element which causes error, in case of one
it('has valid relateOptions values', () => {
relatedOptions.forEach(relOption => {
expect(allOptionNames).toContainOption(relOption);
});
});
});