-
Notifications
You must be signed in to change notification settings - Fork 0
/
AutoAPImd.ts
132 lines (101 loc) · 4.17 KB
/
AutoAPImd.ts
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
import { readdirSync, readFileSync, writeFileSync } from "fs";
var exec = require('child_process').exec;
// Generates the api.md document
(() => {
const outputFile = "./api.md";
const pluginsFolder = "./";
const ignore = [
".git",
"node_modules",
"Example",
".gitignore",
]
const plugins = readdirSync(pluginsFolder).filter(e => e == "index.d.ts");
let Description: { func: string, desc: string[], variable: boolean }[] = [];
for (let i = 0; i < plugins.length; i++) {
const file: string = readFileSync(pluginsFolder + plugins[i], 'utf-8');
console.log(pluginsFolder + plugins[i])
const InterfaceData: string[] = [];
let bracketCounter = 0;
let atInterface = false;
// Extract lines in interface
const lines: string[] = file.split("\n")
for (let l = 0; l < lines.length; l++) {
const line = lines[l];
if (line.includes("{")) bracketCounter++;
if (line.includes("}")) bracketCounter--;
if (atInterface) {
if (bracketCounter < 2) atInterface = false;
else InterfaceData.push(line.trim())
}
if (bracketCounter == 2 && line.includes("interface")) {
if (InterfaceData.length != 0)
break;
atInterface = true;
}
}
let inComment = false;
// Extract funtions and descriptions
for (let l = InterfaceData.length - 1; l >= 0; l--) {
const line = InterfaceData[l];
if ((line.includes("=>") || line.includes(":")) && !inComment) {
Description.push({
func: line.endsWith(";") ? line.slice(0, line.length - 1) : line,
desc: [],
variable: !line.includes("=>")
})
}
if (line.includes("/**")) {
inComment = false;
Description[Description.length - 1].desc = Description[Description.length - 1].desc.reverse()
}
if (inComment) {
let descriptionLine = line.replace("* ", "");
if (descriptionLine.startsWith("@param")) {
const descSplit = descriptionLine.split(" ").splice(1)
descSplit[0] = "*" + descSplit[0] + "*"
descriptionLine = descSplit.join(" ");
}
else if (descriptionLine.startsWith("@returns")) {
descriptionLine = descriptionLine.replace("@returns", "*Returns*");
}
if (descriptionLine.endsWith(".") || descriptionLine.endsWith(";")) {
descriptionLine = descriptionLine.slice(0, descriptionLine.length - 1)
}
Description[Description.length - 1].desc.push(descriptionLine);
}
if (line.includes("*/")) inComment = true;
}
}
Description = Description.sort((a, b) => (a.variable ? 1 : 0) - (b.variable ? 1 : 0)).reverse()
const APIFileLines: string[] = []
APIFileLines.push("# Api documentation")
APIFileLines.push("")
APIFileLines.push("## Bot functions")
let previousGroup = ""
let inVariables = false;
for (let d = 0; d < Description.length; d++) {
const desc = Description[d];
if (!inVariables && desc.variable) {
APIFileLines.push("")
APIFileLines.push("## Bot variables")
inVariables = true;
}
const t = desc.func.split("_")[0]
if(previousGroup != t){
let title = t
title = title[0].toUpperCase() + title.substring(1)
previousGroup = t
APIFileLines.push("")
APIFileLines.push("### " + title)
}
// APIFileLines.push("")
// APIFileLines.push("#### " + desc.func);
if(desc.desc.length == 0) console.log(desc.func + "\nHas no description!" )
for (let l = 0; l < desc.desc.length; l++) {
APIFileLines.push("- " + desc.desc[l] + ".");
}
}
writeFileSync(outputFile, APIFileLines.join("\n"), "utf-8");
exec("doctoc " + outputFile);
})();