|
1 | | -import {pad} from "../utils/string-utils"; |
2 | | -import CommentsGenerator from "../generators/comments-generator"; |
| 1 | +import { pad } from '../utils/string-utils'; |
| 2 | +import CommentsGenerator from '../generators/comments-generator'; |
3 | 3 |
|
4 | 4 | // regexps |
5 | 5 | const generatedCommentRegex = new RegExp('/// @([a-zA-Z]*)\\b'); |
6 | 6 | const parameterCommentRegex = '/// @param'; |
7 | 7 |
|
8 | 8 | export class ContractComment { |
9 | 9 |
|
10 | | - constructor(contract) { |
11 | | - this.contract = contract; |
12 | | - this.generator = new CommentsGenerator(); |
13 | | - } |
| 10 | + constructor(contract) { |
| 11 | + this.contract = contract; |
| 12 | + this.generator = new CommentsGenerator(); |
| 13 | + } |
14 | 14 |
|
15 | | - insertComment(node) { |
16 | | - const comment = this.generator.generate(node).trim(); |
17 | | - if (!comment) return; |
18 | | - let commentLines = comment.split('\n'); |
19 | | - if (this.updateComment(commentLines, node.loc)) return; |
20 | | - commentLines = pad( |
21 | | - node.loc.start.column, |
22 | | - commentLines, |
23 | | - this.isTab(this.contract.getOriginalLineAt(node.loc.start.line - 1)) |
24 | | - ); |
25 | | - this.contract.insertLinesBefore(commentLines, node.loc.start.line - 1); |
26 | | - } |
| 15 | + insertComment(node) { |
| 16 | + const comment = this.generator.generate(node).trim(); |
| 17 | + if (!comment) return; |
| 18 | + let commentLines = comment.split('\n'); |
| 19 | + if (this.updateComment(commentLines, node.loc)) return; |
| 20 | + commentLines = pad( |
| 21 | + node.loc.start.column, |
| 22 | + commentLines, |
| 23 | + this.isTab(this.contract.getOriginalLineAt(node.loc.start.line - 1)) |
| 24 | + ); |
| 25 | + this.contract.insertLinesBefore(commentLines, node.loc.start.line - 1); |
| 26 | + } |
27 | 27 |
|
28 | | - updateComment(commentLines, location) { |
29 | | - let line = location.start.line; |
30 | | - if (this.hasComment(line)) { |
31 | | - // extract old comments |
32 | | - let oldCommentsParams = []; |
33 | | - let oldCommentsMap = {}; |
34 | | - let oldCommentPosition = line - 2; |
35 | | - while (true) { |
36 | | - let comment = this.contract.getLineAt(oldCommentPosition).trim(); |
37 | | - if (comment.startsWith(parameterCommentRegex)) { |
38 | | - oldCommentsParams.push({line: oldCommentPosition, value: comment}) |
39 | | - } else if (comment.startsWith('//')) { |
40 | | - oldCommentsMap[comment.match(generatedCommentRegex)[0]] = comment |
41 | | - } else if (!comment.startsWith('function')) { |
42 | | - break; |
43 | | - } |
44 | | - oldCommentPosition--; |
45 | | - } |
46 | | - // check if old comment is generated comment |
47 | | - if (this.isEmptyObject(oldCommentsMap)) { |
48 | | - return true; |
49 | | - } |
50 | | - // extract new comments |
51 | | - let newCommentsParams = []; |
52 | | - let newCommentsMap = commentLines.reduce(function (map, obj) { |
53 | | - let key = obj.match(generatedCommentRegex)[0]; |
54 | | - if (key === parameterCommentRegex) { |
55 | | - newCommentsParams.push(obj); |
56 | | - } else map[key] = obj; |
57 | | - return map; |
58 | | - }, {}); |
59 | | - // update params if changed |
60 | | - if (newCommentsParams.length) { |
61 | | - for (let k in oldCommentsMap) { |
62 | | - if (!k in newCommentsMap) { |
63 | | - return true; |
64 | | - } |
65 | | - } |
66 | | - let firstCommentLine = oldCommentsParams |
67 | | - .reduce((min, b) => Math.min(min, b.line), oldCommentsParams[0].line); |
68 | | - // remove old params comments and save additional information about params |
69 | | - let savedComments = {}; |
70 | | - for (let oldComment of oldCommentsParams) { |
71 | | - this.contract.removeLine(firstCommentLine); |
72 | | - // save old right part of comment |
73 | | - let c = oldComment.value.toString().trim().split(' '); |
74 | | - if (c.length > 3) { |
75 | | - savedComments[c[2]] = c.slice(3).join(' '); |
76 | | - } |
77 | | - } |
78 | | - // insert new params comments |
79 | | - newCommentsParams = pad( |
80 | | - location.start.column, |
81 | | - newCommentsParams, |
82 | | - this.isTab(this.contract.getOriginalLineAt(location.start.line - 1)) |
83 | | - ); |
84 | | - for (let newComment of newCommentsParams.reverse()) { |
85 | | - let oldCommentParamName = newComment.trim().split(' ')[2]; |
86 | | - let savedComment = savedComments[oldCommentParamName]; |
87 | | - if (typeof savedComment !== "undefined") { |
88 | | - newComment = newComment + " " + savedComment; |
89 | | - } |
90 | | - this.contract.insertLinesBeforeWithoutCalculatingAndAddingOffset(newComment.split(), firstCommentLine); |
91 | | - } |
92 | | - this.contract.addOffset(firstCommentLine, newCommentsParams.length - oldCommentsParams.length); |
93 | | - return true; |
94 | | - } |
| 28 | + updateComment(commentLines, location) { |
| 29 | + let line = location.start.line; |
| 30 | + if (this.hasComment(line)) { |
| 31 | + // extract old comments |
| 32 | + let oldCommentsParams = []; |
| 33 | + let oldCommentsMap = {}; |
| 34 | + let oldCommentPosition = line - 2; |
| 35 | + while (true) { |
| 36 | + let comment = this.contract.getLineAt(oldCommentPosition).trim(); |
| 37 | + if (comment.startsWith(parameterCommentRegex)) { |
| 38 | + oldCommentsParams.push({ line: oldCommentPosition, value: comment }); |
| 39 | + } else if (comment.startsWith('//')) { |
| 40 | + oldCommentsMap[comment.match(generatedCommentRegex)[0]] = comment; |
| 41 | + } else if (!comment.startsWith('function')) { |
| 42 | + break; |
| 43 | + } |
| 44 | + oldCommentPosition--; |
| 45 | + } |
| 46 | + // check if old comment is generated comment |
| 47 | + if (this.isEmptyObject(oldCommentsMap)) { |
| 48 | + return true; |
| 49 | + } |
| 50 | + // extract new comments |
| 51 | + let newCommentsParams = []; |
| 52 | + let newCommentsMap = commentLines.reduce(function(map, obj) { |
| 53 | + let key = obj.match(generatedCommentRegex)[0]; |
| 54 | + if (key === parameterCommentRegex) { |
| 55 | + newCommentsParams.push(obj); |
| 56 | + } else map[key] = obj; |
| 57 | + return map; |
| 58 | + }, {}); |
| 59 | + // update params if changed |
| 60 | + if (newCommentsParams.length) { |
| 61 | + for (let k in oldCommentsMap) { |
| 62 | + const c = !k; |
| 63 | + if (c in newCommentsMap) { |
95 | 64 | return true; |
| 65 | + } |
96 | 66 | } |
97 | | - return false; |
98 | | - } |
99 | | - |
100 | | - hasComment(line) { |
101 | | - let counter = 1; |
102 | | - while (true) { |
103 | | - counter++; |
104 | | - let lineText = this.contract.getOriginalLineAt(line - counter); |
105 | | - if (lineText.trim().startsWith('function')) { |
106 | | - lineText = this.contract.getOriginalLineAt(line - counter - 1); |
107 | | - } |
108 | | - if (lineText === undefined) return false; |
109 | | - lineText = lineText.trim(); |
110 | | - if (lineText.startsWith('*') || lineText.startsWith('//')) return true; |
111 | | - if (!lineText.replace(/\s/g, '').length) continue; |
112 | | - return false; |
| 67 | + let firstCommentLine = oldCommentsParams |
| 68 | + .reduce((min, b) => Math.min(min, b.line), oldCommentsParams[0].line); |
| 69 | + // remove old params comments and save additional information about |
| 70 | + // params |
| 71 | + let savedComments = {}; |
| 72 | + for (let oldComment of oldCommentsParams) { |
| 73 | + this.contract.removeLine(firstCommentLine); |
| 74 | + // save old right part of comment |
| 75 | + let c = oldComment.value.toString().trim().split(' '); |
| 76 | + if (c.length > 3) { |
| 77 | + savedComments[c[2]] = c.slice(3).join(' '); |
| 78 | + } |
113 | 79 | } |
114 | | - } |
115 | | - |
116 | | - isEmptyObject(obj) { |
117 | | - for (let name in obj) { |
118 | | - return false; |
| 80 | + // insert new params comments |
| 81 | + newCommentsParams = pad( |
| 82 | + location.start.column, |
| 83 | + newCommentsParams, |
| 84 | + this.isTab(this.contract.getOriginalLineAt(location.start.line - 1)) |
| 85 | + ); |
| 86 | + for (let newComment of newCommentsParams.reverse()) { |
| 87 | + let oldCommentParamName = newComment.trim().split(' ')[2]; |
| 88 | + let savedComment = savedComments[oldCommentParamName]; |
| 89 | + if (typeof savedComment !== 'undefined') { |
| 90 | + newComment = newComment + ' ' + savedComment; |
| 91 | + } |
| 92 | + this.contract.insertLinesBeforeWithoutCalculatingAndAddingOffset(newComment.split(), firstCommentLine); |
119 | 93 | } |
| 94 | + this.contract.addOffset(firstCommentLine, newCommentsParams.length - oldCommentsParams.length); |
120 | 95 | return true; |
| 96 | + } |
| 97 | + return true; |
121 | 98 | } |
| 99 | + return false; |
| 100 | + } |
122 | 101 |
|
123 | | - isTab(originalLineAt) { |
124 | | - return originalLineAt.startsWith('\t'); |
| 102 | + hasComment(line) { |
| 103 | + let counter = 1; |
| 104 | + while (true) { |
| 105 | + counter++; |
| 106 | + let lineText = this.contract.getOriginalLineAt(line - counter); |
| 107 | + if (lineText.trim().startsWith('function')) { |
| 108 | + lineText = this.contract.getOriginalLineAt(line - counter - 1); |
| 109 | + } |
| 110 | + if (lineText === undefined) return false; |
| 111 | + lineText = lineText.trim(); |
| 112 | + if (lineText.startsWith('*') || lineText.startsWith('//')) return true; |
| 113 | + if (!lineText.replace(/\s/g, '').length) continue; |
| 114 | + return false; |
125 | 115 | } |
126 | | -} |
| 116 | + } |
127 | 117 |
|
| 118 | + isEmptyObject(obj) { |
| 119 | + for (let name in obj) { |
| 120 | + return false; |
| 121 | + } |
| 122 | + return true; |
| 123 | + } |
| 124 | + |
| 125 | + isTab(originalLineAt) { |
| 126 | + return originalLineAt.startsWith('\t'); |
| 127 | + } |
| 128 | +} |
128 | 129 |
|
129 | 130 |
|
0 commit comments