FilesExpand file tree

development

/

generateApiDocs.js

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

129 lines (121 loc) · 3.17 KB

development

/

generateApiDocs.js

Copy path

Top

File metadata and controls

• Code
• Blame

129 lines (121 loc) · 3.17 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

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

/*global load, args, Packages*/

/*

This script is run at build time to generate api.md - a single Markdown document containing documentation for ScriptCraft's API

*/

function foreach(array, func) {

for (var i = 0; i < array.length; i++) {

func(array[i], i, array);

}

}

/*

find - a (very) basic implementation of the unix command line tool.

*/

function find(dir, store, re) {

var files = dir.listFiles();

foreach(files, function(filename) {

filename = '' + filename;

var file = new File(filename);

if (file.isDirectory()) {

find(file, store, re);

} else {

if (typeof re == 'undefined') store.push(filename);

else if (filename.match(re)) store.push(filename);

}

});

}

/*

the main module file for a given directory

(assuming the main module is in a file with the same name as the parent

directory) - e.g. drone/drone.js

*/

function sorter(precedence) {

return function(a, b) {

// convert from Java string to JS string

a = '' + a;

b = '' + b;

var aparts = a.split(/\//);

var bparts = b.split(/\//);

var adir = aparts.slice(3, aparts.length - 1).join('/');

var afile = aparts[aparts.length - 1];

var bdir = bparts.slice(3, bparts.length - 1).join('/');

var bfile = bparts[bparts.length - 1];

for (var i = 0; i < precedence.length; i++) {

var re = precedence[i];

if (a.match(re) && b.match(re)) {

if (afile < bfile) return -1;

if (afile > bfile) return 1;

}

if (a.match(re)) return -1;

if (b.match(re)) return 1;

}

if (adir < bdir) return -1;

if (adir > bdir) return 1;

afile = afile.replace(/\.js$/, '');

if (afile == adir) {

return -1;

} else {

var result = 0;

if (afile < bfile) {

result = -1;

}

if (afile > bfile) {

result = 1;

}

//err.println("afile: " + afile + ", bfile:" + bfile + ",result=" + result);

return result;

}

};

}

var err = java.lang.System.err;

args = Array.prototype.slice.call(args, 1);

if (typeof importPackage == 'undefined') {

// load compatibility script

load('nashorn:mozilla_compat.js');

}

var dir = args[0];

var io = Packages.java.io;

var File = io.File;

var store = [];

find(new io.File(dir), store, /\/[a-zA-Z0-9_\-]+\.js$/);

store.sort(

sorter([

/lib\/scriptcraft\.js$/,

/lib\/require\.js$/,

/lib\/plugin\.js$/,

/lib\/events\.js$/,

/lib\/events\-helper\-canary/,

/lib\/events\-helper\-bukkit/,

/lib\//,

/modules\/drone\/index\.js/,

/modules\/drone\//,

/plugins\/drone\//,

/modules\//,

/examples\//

])

);

var contents = [];

foreach(store, function(filename) {

var br = new io.BufferedReader(new io.FileReader(filename));

var line;

while ((line = br.readLine()) != null) {

contents.push(line);

}

br.close();

});

var len = contents.length;

var writeComment = false;

var startComment = /^\/\*{10}/;

var endComment = /^\*{3}\//;

for (var i = 0; i < contents.length; i++) {

var line = contents[i];

if (line.match(startComment)) {

writeComment = true;

i++;

}

if (line.match(endComment)) {

writeComment = false;

}

if (writeComment) {

java.lang.System.out.println(contents[i]);

}

}