-
-
Notifications
You must be signed in to change notification settings - Fork 153
/
requireDescription.js
99 lines (88 loc) · 2.29 KB
/
requireDescription.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
import _ from 'lodash';
import iterateJsdoc from '../iterateJsdoc';
export default iterateJsdoc(({
jsdoc,
report,
utils,
context
}) => {
if (utils.avoidDocs()) {
return;
}
const {descriptionStyle = 'body'} = context.options[0] || {};
let targetTagName = utils.getPreferredTagName({
// We skip reporting except when `@description` is essential to the rule,
// so user can block the tag and still meaningfully use this rule
// even if the tag is present (and `check-tag-names` is the one to
// normally report the fact that it is blocked but present)
skipReportingBlockedTag: descriptionStyle !== 'tag',
tagName: 'description'
});
if (!targetTagName) {
return;
}
const isBlocked = typeof targetTagName === 'object' && targetTagName.blocked;
if (isBlocked) {
targetTagName = targetTagName.tagName;
}
const checkDescription = (description) => {
const exampleContent = _.compact(description.trim().split('\n'));
return exampleContent.length;
};
if (descriptionStyle !== 'tag') {
if (checkDescription(jsdoc.description || '')) {
return;
}
if (descriptionStyle === 'body') {
report('Missing JSDoc block description.');
return;
}
}
const functionExamples = isBlocked ?
[] :
_.filter(jsdoc.tags, {
tag: targetTagName
});
if (!functionExamples.length) {
report(
descriptionStyle === 'any' ?
`Missing JSDoc block description or @${targetTagName} declaration.` :
`Missing JSDoc @${targetTagName} declaration.`
);
return;
}
functionExamples.forEach((example) => {
if (!checkDescription(`${example.name} ${example.description}`)) {
report(`Missing JSDoc @${targetTagName} description.`);
}
});
}, {
contextDefaults: true,
meta: {
schema: [
{
additionalProperties: false,
properties: {
contexts: {
items: {
type: 'string'
},
type: 'array'
},
descriptionStyle: {
enum: ['body', 'tag', 'any'],
type: 'string'
},
exemptedBy: {
items: {
type: 'string'
},
type: 'array'
}
},
type: 'object'
}
],
type: 'suggestion'
}
});