Ghost/.eslintrc.js
Sam Lord a21b91cc71 Added lint rules for migrations
refs: https://github.com/TryGhost/Toolbox/issues/105

Lint rules prevent:

* Invalid naming conventions for new migrations
* Loop constructs in migrations - these should be used with caution
and are therefore a warning rule, use `// eslint-disable-next-line
no-restricted-syntax` to prevent this rule from firing where a loop is
required
* Returing within a loop - this is usually meant to be a
continue/break
* Multiple joins - these can be badly performing migrations, so should
be treated with caution, disable the rule for the line if the risk is
understood / the migration cannot be written without it
2021-11-29 16:21:43 +00:00

119 lines
4.6 KiB
JavaScript

const path = require('path');
module.exports = {
env: {
es6: true,
node: true
},
plugins: ['ghost'],
extends: [
'plugin:ghost/node'
],
rules: {
// @TODO: remove this rule once it's turned into "error" in the base plugin
'no-shadow': 'error',
'no-var': 'error',
'one-var': ['error', 'never']
},
overrides: [
{
files: 'core/server/api/canary/*',
rules: {
'ghost/ghost-custom/max-api-complexity': 'error'
}
},
{
files: 'core/server/data/migrations/versions/**',
excludedFiles: [
'core/server/data/migrations/versions/1.*/*',
'core/server/data/migrations/versions/2.*/*',
'core/server/data/migrations/versions/3.*/*'
],
rules: {
'ghost/filenames/match-regex': ['error', '^(?:\\d{2}|\\d{4}(?:-\\d{2}){4})(?:-[a-zA-Z]+)+$', true]
}
},
{
files: 'core/server/data/migrations/versions/**',
rules: {
'no-restricted-syntax': ['warn', {
selector: 'ForStatement',
message: 'For statements can perform badly in migrations'
}, {
selector: 'ForOfStatement',
message: 'For statements can perform badly in migrations'
}, {
selector: 'ForInStatement',
message: 'For statements can perform badly in migrations'
}, {
selector: 'WhileStatement',
message: 'While statements can perform badly in migrations'
}, {
selector: 'CallExpression[callee.property.name=\'forEach\']',
message: 'Loop constructs like forEach can perform badly in migrations'
}, {
selector: 'CallExpression[callee.object.name=\'_\'][callee.property.name=\'each\']',
message: 'Loop constructs like _.each can perform badly in migrations'
}, {
selector: 'CallExpression[callee.property.name=/join|innerJoin|leftJoin/] CallExpression[callee.property.name=/join|innerJoin|leftJoin/] CallExpression[callee.name=\'knex\']',
message: 'Use of multiple join statements in a single knex block'
}],
'ghost/no-return-in-loop/no-return-in-loop': ['error']
}
},
{
files: 'core/shared/**',
rules: {
'ghost/node/no-restricted-require': ['error', [
{
name: path.resolve(__dirname, 'core/server/**'),
message: 'Invalid require of core/server from core/shared.'
},
{
name: path.resolve(__dirname, 'core/frontend/**'),
message: 'Invalid require of core/frontend from core/shared.'
}
]]
}
},
{
files: 'core/server/api/**/utils/validators/**/index.js',
rules: {
'max-lines': ['off']
}
},
/**
* @TODO: enable these soon
*/
{
files: 'core/frontend/**',
rules: {
'ghost/node/no-restricted-require': ['off', [
// If we make the frontend entirely independent, these have to be solved too
// {
// name: path.resolve(__dirname, 'core/shared/**'),
// message: 'Invalid require of core/shared from core/frontend.'
// },
// These are critical refactoring issues that we need to tackle ASAP
{
name: [path.resolve(__dirname, 'core/server/**')],
message: 'Invalid require of core/server from core/frontend.'
}
]]
}
},
{
files: 'core/server/**',
rules: {
'ghost/node/no-restricted-require': ['warn', [
{
// Throw an error for all requires of the frontend, _except_ the url service which will be moved soon
name: [path.resolve(__dirname, 'core/frontend/**')],
message: 'Invalid require of core/frontend from core/server.'
}
]]
}
}
]
};