1
0
mirror of synced 2025-12-21 10:57:10 -05:00
Files
docs/tests/content/site-data.js
Kevin Heis 8a56437c93 Pretty format (#20352)
* Update prettier flow to include JS

* Run prettier

* ...run prettier
2021-07-14 14:35:01 -07:00

118 lines
4.1 KiB
JavaScript

import { fileURLToPath } from 'url'
import path from 'path'
import fs from 'fs'
import { get, isPlainObject, has } from 'lodash-es'
import flat from 'flat'
import loadSiteData from '../../lib/site-data.js'
import patterns from '../../lib/patterns.js'
import { liquid } from '../../lib/render-content/index.js'
import walkSync from 'walk-sync'
const __dirname = path.dirname(fileURLToPath(import.meta.url))
describe('siteData module (English)', () => {
let data
beforeAll(async () => {
data = await loadSiteData()
})
test('makes an object', async () => {
expect(isPlainObject(data)).toBe(true)
})
test('sets a top-level key for each language', async () => {
expect('en' in data).toEqual(true)
expect('ja' in data).toEqual(true)
})
test('includes English variables', async () => {
const prodName = get(data, 'en.site.data.variables.product.prodname_dotcom')
expect(prodName).toBe('GitHub')
})
test('includes English reusables', async () => {
const reusable = get(
data,
'en.site.data.reusables.command_line.switching_directories_procedural'
)
expect(reusable).toBe('1. Change the current working directory to your local repository.')
})
test('includes Japanese variables', async () => {
const prodName = get(data, 'ja.site.data.variables.product.prodname_dotcom')
expect(prodName).toBe('GitHub')
})
test('includes Japanese reusables', async () => {
const reusable = get(data, 'ja.site.data.reusables.audit_log.octicon_icon')
expect(reusable.includes('任意のページの左上で')).toBe(true)
})
// TODO: re-enable once Janky flakyness is resolved
test.skip('backfills missing translated site data with English values', async () => {
const newFile = path.join(__dirname, '../../data/newfile.yml')
await fs.writeFile(newFile, 'newvalue: bar')
const data = await loadSiteData()
expect(get(data, 'en.site.data.newfile.newvalue')).toEqual('bar')
expect(get(data, 'ja.site.data.newfile.newvalue')).toEqual('bar')
await fs.unlink(newFile)
})
test('all Liquid templating is valid', async () => {
const dataMap = flat(data)
for (const key in dataMap) {
const value = dataMap[key]
if (!patterns.hasLiquid.test(value)) continue
let message = `${key} contains a malformed Liquid expression`
let result = null
try {
result = await liquid.parseAndRender(value)
} catch (err) {
console.trace(err)
message += `: ${err.message}`
}
expect(typeof result, message).toBe('string')
}
})
test('includes markdown files as data', async () => {
const reusable = get(
data,
'en.site.data.reusables.enterprise_enterprise_support.submit-support-ticket-first-section'
)
expect(typeof reusable).toBe('string')
expect(reusable.includes('1. ')).toBe(true)
})
test.skip('encodes bracketed parentheses to prevent them from becoming links', async () => {
const reusable = get(data, 'ja.site.data.reusables.organizations.team_name')
const expectation = `reusable should contain a bracket followed by a space. Actual value: ${reusable}`
expect(reusable.includes('] ('), expectation).toBe(true)
})
test('warn if any YAML reusables are found', async () => {
const reusables = walkSync(path.join(__dirname, '../../data/reusables'))
expect(reusables.length).toBeGreaterThan(100)
const yamlReusables = reusables.filter(
(filename) => filename.endsWith('.yml') || filename.endsWith('.yaml')
)
const message = `reusables are now written as individual Markdown files. Please migrate the following YAML files to Markdown:\n${yamlReusables.join(
'\n'
)}`
expect(yamlReusables.length, message).toBe(0)
})
test('all non-English data has matching English data', async () => {
for (const languageCode of Object.keys(data)) {
if (languageCode === 'en') continue
const nonEnglishKeys = Object.keys(flat(data[languageCode]))
for (const key of nonEnglishKeys) {
if (!has(data.en, key)) {
throw new Error(`matching data not found for ${languageCode}.${key}`)
}
}
}
})
})