ni_nitdoc: sort lists contained in mmodules page
[nit.git] / src / ni_nitdoc.nit
1 # This file is part of NIT ( http://www.nitlanguage.org ).
2 #
3 # Copyright 2008 Jean Privat <jean@pryen.org>
4 #
5 # Licensed under the Apache License, Version 2.0 (the "License");
6 # you may not use this file except in compliance with the License.
7 # You may obtain a copy of the License at
8 #
9 # http://www.apache.org/licenses/LICENSE-2.0
10 #
11 # Unless required by applicable law or agreed to in writing, software
12 # distributed under the License is distributed on an "AS IS" BASIS,
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 # See the License for the specific language governing permissions and
15 # limitations under the License.
16
17 module ni_nitdoc
18
19 import model_utils
20 import abstract_compiler
21 import html
22
23 class Nitdoc
24 private var toolcontext: ToolContext
25 private var model: Model
26 private var modelbuilder: ModelBuilder
27 private var mainmodule: MModule
28 private var arguments: Array[String]
29 private var destinationdir: nullable String
30 private var sharedir: nullable String
31 private var source: nullable String
32
33 private var opt_dir = new OptionString("Directory where doc is generated", "-d", "--dir")
34 private var opt_source = new OptionString("What link for source (%f for filename, %l for first line, %L for last line)", "--source")
35 private var opt_sharedir = new OptionString("Directory containing the nitdoc files", "--sharedir")
36 private var opt_nodot = new OptionBool("Do not generate graphes with graphiviz", "--no-dot")
37
38 init(toolcontext: ToolContext) do
39 # We need a model to collect stufs
40 self.toolcontext = toolcontext
41 self.arguments = toolcontext.option_context.rest
42 toolcontext.option_context.options.clear
43 toolcontext.option_context.add_option(opt_dir)
44 toolcontext.option_context.add_option(opt_source)
45 toolcontext.option_context.add_option(opt_sharedir)
46 toolcontext.option_context.add_option(opt_nodot)
47 toolcontext.process_options
48 process_options
49
50 if arguments.length < 1 then
51 toolcontext.option_context.usage
52 exit(1)
53 end
54
55 model = new Model
56 modelbuilder = new ModelBuilder(model, toolcontext)
57
58 # Here we load an process std modules
59 var mmodules = modelbuilder.parse_and_build([arguments.first])
60 if mmodules.is_empty then return
61 modelbuilder.full_propdef_semantic_analysis
62 assert mmodules.length == 1
63 self.mainmodule = mmodules.first
64 end
65
66 private fun process_options do
67 if not opt_dir.value is null then
68 destinationdir = opt_dir.value
69 else
70 destinationdir = "nitdoc_directory"
71 end
72 if not opt_sharedir.value is null then
73 sharedir = opt_sharedir.value
74 else
75 var dir = "NIT_DIR".environ
76 if dir.is_empty then
77 dir = "{sys.program_name.dirname}/../share/nitdoc"
78 else
79 dir = "{dir}/share/nitdoc"
80 end
81 sharedir = dir
82 if sharedir is null then
83 print "Error: Cannot locate nitdoc share files. Uses --sharedir or envvar NIT_DIR"
84 abort
85 end
86 dir = "{sharedir.to_s}/scripts/js-facilities.js"
87 if sharedir is null then
88 print "Error: Invalid nitdoc share files. Check --sharedir or envvar NIT_DIR"
89 abort
90 end
91 end
92 if not opt_source.value is null then
93 source = ""
94 else
95 source = opt_source.value
96 end
97 end
98
99 fun start do
100 if arguments.length == 1 then
101 # Create destination dir if it's necessary
102 if not destinationdir.file_exists then destinationdir.mkdir
103 sys.system("cp -r {sharedir.to_s}/* {destinationdir.to_s}/")
104 overview
105 fullindex
106 modules
107 classes
108 quicksearch_list
109 end
110 end
111
112 fun overview do
113 var overviewpage = new NitdocOverview.with(modelbuilder.nmodules, self.opt_nodot.value, destinationdir.to_s)
114 overviewpage.save("{destinationdir.to_s}/index.html")
115 end
116
117 fun fullindex do
118 var fullindex = new NitdocFullindex.with(model.mmodules)
119 fullindex.save("{destinationdir.to_s}/full-index.html")
120 end
121
122 fun modules do
123 for mod in modelbuilder.nmodules do
124 var modulepage = new NitdocModules.with(mod)
125 modulepage.save("{destinationdir.to_s}/{mod.mmodule.name}.html")
126 end
127 end
128
129 fun classes do
130 for amodule in modelbuilder.nmodules do
131 for mclass, aclassdef in amodule.mclass2nclassdef do
132 mclass.amodule(modelbuilder.mmodule2nmodule)
133 mclass.mmethod(aclassdef.mprop2npropdef)
134 var classpage = new NitdocMClasses.with(mclass, aclassdef, source)
135 classpage.save("{destinationdir.to_s}/{mclass.name}.html")
136 end
137 end
138 end
139
140 # Generate QuickSearch file
141 fun quicksearch_list do
142 var file = new OFStream.open("{destinationdir.to_s}/quicksearch-list.js")
143 var content = new Buffer
144 content.append("var entries = \{ ")
145 for prop in model.mproperties do
146 if not prop isa MMethod then continue
147 content.append("\"{prop.name}\": [")
148 for propdef in prop.mpropdefs do
149 content.append("\{txt: \"{propdef.mproperty.full_name}\", url:\"{propdef.mproperty.link_anchor}\" \}")
150 if not propdef is prop.mpropdefs.last then content.append(", ")
151 end
152 content.append("]")
153 content.append(", ")
154 end
155
156 for mclass in model.mclasses do
157 content.append("\"{mclass.name}\": [")
158 for mclassdef in mclass.mclassdefs do
159 content.append("\{txt: \"{mclassdef.mclass.full_name}\", url:\"{mclass.link_anchor}\" \}")
160 if not mclassdef is mclass.mclassdefs.last then content.append(", ")
161 end
162 content.append("]")
163 if not mclass is model.mclasses.last then content.append(", ")
164 end
165
166 content.append(" \};")
167 file.write(content.to_s)
168 file.close
169 end
170
171 end
172
173 class NitdocOverview
174 super NitdocPage
175
176 var amodules: Array[AModule]
177
178 # Init with Array[AModule] to get all ifnormations about each MModule containt in a program
179 # opt_nodot to inform about the graph gen
180 # destination: to know where will be saved dot files
181 init with(modules: Array[AModule], opt_nodot: Bool, destination: String) do
182 self.amodules = modules
183 self.opt_nodot = opt_nodot
184 self.destinationdir = destination
185 end
186
187 redef fun head do
188 super
189 add("title").text("Overview | Nit Standard Library")
190 end
191
192 redef fun header do
193 open("header")
194 open("nav").add_class("main")
195 open("ul")
196 add("li").add_class("current").text("Overview")
197 open("li")
198 add_html("<a href=\"full-index.html\">Full Index</a>")
199 close("li")
200 open("li").attr("id", "liGitHub")
201 open("a").add_class("btn").attr("id", "logGitHub")
202 add("img").attr("id", "imgGitHub").attr("src", "resources/icons/github-icon.png")
203 close("a")
204 open("div").add_class("popover bottom")
205 add("div").add_class("arrow").text(" ")
206 open("div").add_class("githubTitle")
207 add("h3").text("Github Sign In")
208 close("div")
209 open("div")
210 add("label").attr("id", "lbloginGit").text("Username")
211 add("input").attr("id", "loginGit").attr("name", "login").attr("type", "text")
212 open("label").attr("id", "logginMessage").text("Hello ")
213 open("a").attr("id", "githubAccount")
214 add("strong").attr("id", "nickName").text(" ")
215 close("a")
216 close("label")
217 close("div")
218 open("div")
219 add("label").attr("id", "lbpasswordGit").text("Password")
220 add("input").attr("id", "passwordGit").attr("name", "password").attr("type", "password")
221 open("div").attr("id", "listBranches")
222 add("label").attr("id", "lbBranches").text("Branch")
223 add("select").add_class("dropdown").attr("id", "dropBranches").attr("name", "dropBranches").attr("tabindex", "1").text(" ")
224 close("div")
225 close("div")
226 open("div")
227 add("label").attr("id", "lbrepositoryGit").text("Repository")
228 add("input").attr("id", "repositoryGit").attr("name", "repository").attr("type", "text")
229 close("div")
230 open("div")
231 add("label").attr("id", "lbbranchGit").text("Branch")
232 add("input").attr("id", "branchGit").attr("name", "branch").attr("type", "text")
233 close("div")
234 open("div")
235 add("a").attr("id", "signIn").text("Sign In")
236 close("div")
237 close("div")
238 close("li")
239 close("ul")
240 close("nav")
241 close("header")
242 end
243
244 redef fun body do
245 super
246 open("div").add_class("page")
247 open("div").add_class("content fullpage")
248 add("h1").text("Nit Standard Library")
249 open("article").add_class("overview")
250 add_html("<p>Documentation for the standard library of Nit<br />Version jenkins-component=stdlib-19<br />Date: TODAY</p>")
251 close("article")
252 open("article").add_class("overview")
253 add("h2").text("Modules")
254 open("ul")
255 add_modules
256 close("ul")
257 process_generate_dot
258 close("article")
259 close("div")
260 close("div")
261 add("footer").text("Nit standard library. Version jenkins-component=stdlib-19.")
262 end
263
264 fun add_modules do
265 var ls = new List[nullable MModule]
266 for amodule in amodules do
267 var mmodule = amodule.mmodule.public_owner
268 if mmodule != null and not ls.has(mmodule) then
269 open("li")
270 add("a").attr("href", "{mmodule.name}.html").text("{mmodule.to_s} ")
271 add_html(amodule.comment)
272 close("li")
273 ls.add(mmodule)
274 end
275 end
276 end
277
278 fun process_generate_dot do
279 var op = new Buffer
280 op.append("digraph dep \{ rankdir=BT; node[shape=none,margin=0,width=0,height=0,fontsize=10]; edge[dir=none,color=gray]; ranksep=0.2; nodesep=0.1;\n")
281 for amodule in amodules do
282 op.append("\"{amodule.mmodule.name}\"[URL=\"{amodule.mmodule.name}.html\"];\n")
283 for mmodule2 in amodule.mmodule.in_importation.direct_greaters do
284 op.append("\"{amodule.mmodule.name}\"->\"{mmodule2.name}\";\n")
285 end
286 end
287 op.append("\}\n")
288 generate_dot(op.to_s, "dep", "Modules hierarchy")
289 end
290
291 end
292
293 class NitdocFullindex
294 super NitdocPage
295
296 var mmodules: Array[MModule]
297
298 init with(mmodules: Array[MModule]) do
299 self.mmodules = mmodules
300 opt_nodot = false
301 destinationdir = ""
302 end
303
304 redef fun head do
305 super
306 add("title").text("Full Index | Nit Standard Library")
307 end
308
309 redef fun header do
310 open("header")
311 open("nav").add_class("main")
312 open("ul")
313 open("li")
314 add_html("<a href=\"index.html\">Overview</a>")
315 close("li")
316 add("li").add_class("current").text("Full Index")
317 open("li").attr("id", "liGitHub")
318 open("a").add_class("btn").attr("id", "logGitHub")
319 add("img").attr("id", "imgGitHub").attr("src", "resources/icons/github-icon.png")
320 close("a")
321 open("div").add_class("popover bottom")
322 add("div").add_class("arrow").text(" ")
323 open("div").add_class("githubTitle")
324 add("h3").text("Github Sign In")
325 close("div")
326 open("div")
327 add("label").attr("id", "lbloginGit").text("Username")
328 add("input").attr("id", "loginGit").attr("name", "login").attr("type", "text")
329 open("label").attr("id", "logginMessage").text("Hello ")
330 open("a").attr("id", "githubAccount")
331 add("strong").attr("id", "nickName").text(" ")
332 close("a")
333 close("label")
334 close("div")
335 open("div")
336 add("label").attr("id", "lbpasswordGit").text("Password")
337 add("input").attr("id", "passwordGit").attr("name", "password").attr("type", "password")
338 open("div").attr("id", "listBranches")
339 add("label").attr("id", "lbBranches").text("Branch")
340 add("select").add_class("dropdown").attr("id", "dropBranches").attr("name", "dropBranches").attr("tabindex", "1").text(" ")
341 close("div")
342 close("div")
343 open("div")
344 add("label").attr("id", "lbrepositoryGit").text("Repository")
345 add("input").attr("id", "repositoryGit").attr("name", "repository").attr("type", "text")
346 close("div")
347 open("div")
348 add("label").attr("id", "lbbranchGit").text("Branch")
349 add("input").attr("id", "branchGit").attr("name", "branch").attr("type", "text")
350 close("div")
351 open("div")
352 add("a").attr("id", "signIn").text("Sign In")
353 close("div")
354 close("div")
355 close("li")
356 close("ul")
357 close("nav")
358 close("header")
359 end
360
361 redef fun body do
362 super
363 open("div").add_class("page")
364 open("div").add_class("content fullpage")
365 add("h1").text("Full Index")
366 add_content
367 close("div")
368 close("div")
369 add("footer").text("Nit standard library. Version jenkins-component=stdlib-19.")
370 end
371
372 fun add_content do
373 module_column
374 classes_column
375 properties_column
376 end
377
378 # Add to content modules column
379 fun module_column do
380 var ls = new List[nullable MModule]
381 var sorted = mmodules
382 var sorterp = new ComparableSorter[MModule]
383 sorterp.sort(sorted)
384 open("article").add_class("modules filterable")
385 add("h2").text("Modules")
386 open("ul")
387 for mmodule in sorted do
388 if mmodule.public_owner != null and not ls.has(mmodule.public_owner) then
389 ls.add(mmodule.public_owner)
390 open("li")
391 add("a").attr("href", "{mmodule.public_owner.name}.html").text(mmodule.public_owner.name)
392 close("li")
393 end
394 end
395 close("ul")
396 close("article")
397 end
398
399 # Add to content classes modules
400 fun classes_column do
401 var sorted = mmodules.first.imported_mclasses.to_a
402 var sorterp = new ComparableSorter[MClass]
403 sorterp.sort(sorted)
404 open("article").add_class("classes filterable")
405 add("h2").text("Classes")
406 open("ul")
407
408 for mclass in sorted do
409 open("li")
410 add("a").attr("href", "{mclass.name}.html").text(mclass.name)
411 close("li")
412 end
413
414 close("ul")
415 close("article")
416 end
417
418 # Insert the properties column of fullindex page
419 fun properties_column do
420 open("article").add_class("properties filterable")
421 add("h2").text("Properties")
422 open("ul")
423 var sorted_imported = mmodules.first.imported_methods.to_a
424 var sorted_redef = mmodules.first.redef_methods.to_a
425 var sorterp = new ComparableSorter[MProperty]
426 sorterp.sort(sorted_imported)
427 sorterp.sort(sorted_redef)
428
429 for method in sorted_imported do
430 if method.visibility is none_visibility or method.visibility is intrude_visibility then continue
431 open("li").add_class("intro")
432 add("span").attr("title", "introduction").text("I")
433 add_html("&nbsp;")
434 add("a").attr("href", "{method.local_class.name}.html").attr("title", "").text("{method.name} ({method.local_class.name})")
435 close("li")
436 end
437
438 for method in sorted_redef do
439 if method.visibility is none_visibility or method.visibility is intrude_visibility then continue
440 open("li").add_class("redef")
441 add("span").attr("title", "redefinition").text("R")
442 add_html("&nbsp;")
443 add("a").attr("href", "{method.local_class.name}.html").attr("title", "").text("{method.name} ({method.local_class.name})")
444 close("li")
445 end
446
447 close("ul")
448 close("article")
449 end
450
451 end
452
453 class NitdocModules
454 super NitdocPage
455
456 var amodule: AModule
457 var modulename: String
458 init with(amodule: AModule) do
459 self.amodule = amodule
460 self.modulename = self.amodule.mmodule.name
461 opt_nodot = false
462 destinationdir = ""
463 end
464
465 redef fun head do
466 super
467 add("title").text("{modulename} module | {amodule.short_comment}")
468 end
469
470 redef fun header do
471 open("header")
472 open("nav").add_class("main")
473 open("ul")
474 open("li")
475 add_html("<a href=\"index.html\">Overview</a>")
476 close("li")
477 add("li").add_class("current").text(modulename)
478 open("li")
479 add_html("<a href=\"full-index.html\" >Full Index</a>")
480 close("li")
481 open("li").attr("id", "liGitHub")
482 open("a").add_class("btn").attr("id", "logGitHub")
483 add("img").attr("id", "imgGitHub").attr("src", "resources/icons/github-icon.png")
484 close("a")
485 open("div").add_class("popover bottom")
486 add("div").add_class("arrow").text(" ")
487 open("div").add_class("githubTitle")
488 add("h3").text("Github Sign In")
489 close("div")
490 open("div")
491 add("label").attr("id", "lbloginGit").text("Username")
492 add("input").attr("id", "loginGit").attr("name", "login").attr("type", "text")
493 open("label").attr("id", "logginMessage").text("Hello ")
494 open("a").attr("id", "githubAccount")
495 add("strong").attr("id", "nickName").text(" ")
496 close("a")
497 close("label")
498 close("div")
499 open("div")
500 add("label").attr("id", "lbpasswordGit").text("Password")
501 add("input").attr("id", "passwordGit").attr("name", "password").attr("type", "password")
502 open("div").attr("id", "listBranches")
503 add("label").attr("id", "lbBranches").text("Branch")
504 add("select").add_class("dropdown").attr("id", "dropBranches").attr("name", "dropBranches").attr("tabindex", "1").text(" ")
505 close("div")
506 close("div")
507 open("div")
508 add("label").attr("id", "lbrepositoryGit").text("Repository")
509 add("input").attr("id", "repositoryGit").attr("name", "repository").attr("type", "text")
510 close("div")
511 open("div")
512 add("label").attr("id", "lbbranchGit").text("Branch")
513 add("input").attr("id", "branchGit").attr("name", "branch").attr("type", "text")
514 close("div")
515 open("div")
516 add("a").attr("id", "signIn").text("Sign In")
517 close("div")
518 close("div")
519 close("li")
520 close("ul")
521 close("nav")
522 close("header")
523 end
524
525 redef fun body do
526 super
527 open("div").add_class("page")
528 menu
529 add_content
530 close("div")
531 add("footer").text("Nit standard library. Version jenkins-component=stdlib-19.")
532 end
533
534 # Insert all tags in content part
535 fun add_content do
536 open("div").add_class("content")
537 add("h1").text(modulename)
538 add("div").add_class("subtitle").text("module {modulename}")
539 module_comment
540 classes
541 properties
542 close("div")
543 end
544
545 # Insert module comment in the content
546 fun module_comment do
547 var doc = amodule.comment
548 open("div").attr("id", "description")
549 add("pre").add_class("text_label").text(doc)
550 add("textarea").add_class("edit").attr("rows", "1").attr("cols", "76").attr("id", "fileContent").text(" ")
551 add("a").attr("id", "cancelBtn").text("Cancel")
552 add("a").attr("id", "commitBtn").text("Commit")
553 add("pre").add_class("text_label").attr("id", "preSave").attr("type", "2")
554 close("div")
555 end
556
557 fun menu do
558 var mmodule = amodule.mmodule
559 open("div").add_class("menu")
560 open("nav")
561 add("h3").text("Module Hierarchy").attr("style","cursor: pointer;")
562 if mmodule.in_importation.direct_greaters.length > 0 then
563 add_html("<h4>All dependencies</h4><ul>")
564 var sorted = mmodule.in_importation.direct_greaters.to_a
565 var sorterp = new ComparableSorter[MModule]
566 sorterp.sort(sorted)
567 for m in sorted do
568 if m == mmodule or mmodule == m.public_owner then continue
569 open("li")
570 add("a").attr("href", "{m.name}.html").text(m.name)
571 close("li")
572 end
573 add_html("</ul>")
574 end
575 if mmodule.in_importation.greaters.length > 0 then
576 add_html("<h4>All clients</h4><ul>")
577 var sorted = mmodule.in_importation.greaters.to_a
578 var sorterp = new ComparableSorter[MModule]
579 sorterp.sort(sorted)
580 for m in sorted do
581 if m == mmodule then continue
582 open("li")
583 add("a").attr("href", "{m.name}.html").text(m.name)
584 close("li")
585 end
586 add_html("</ul>")
587 end
588 close("nav")
589 if mmodule.in_nesting.direct_greaters.length > 0 then
590 var sorted = mmodule.in_nesting.direct_greaters.to_a
591 var sorterp = new ComparableSorter[MModule]
592 sorterp.sort(sorted)
593 open("nav")
594 add("h3").text("Nested Modules").attr("style","cursor: pointer;")
595 open("ul")
596 for m in sorted do
597 open("li")
598 add("a").attr("href", "{m.name}.html").text(m.name)
599 close("li")
600 end
601 close("ul")
602
603 close("nav")
604 end
605 close("div")
606 end
607
608 fun classes do
609 var sorted = new Array[MClass]
610 sorted.add_all(amodule.mmodule.mclasses.keys)
611 var sorterp = new ComparableSorter[MClass]
612 sorterp.sort(sorted)
613 open("div").add_class("module")
614 open("article").add_class("classes filterable")
615 add("h2").text("Classes")
616 open("ul")
617 for c in sorted do
618 var state = amodule.mmodule.mclasses[c]
619 var name = c.name
620 if state == c_is_intro or state == c_is_imported then
621 open("li").add_class("intro")
622 add("span").attr("title", "introduced in this module").text("I ")
623 else
624 open("li").add_class("redef")
625 add("span").attr("title", "refined in this module").text("R ")
626 end
627 add("a").attr("href", "{name}.html").text(name)
628 close("li")
629 end
630 close("ul")
631 close("article")
632 close("div")
633 end
634
635 fun properties do
636 var sorted_imported = amodule.mmodule.imported_methods.to_a
637 var sorted_redef = amodule.mmodule.redef_methods.to_a
638 var sorterp = new ComparableSorter[MProperty]
639 sorterp.sort(sorted_imported)
640 sorterp.sort(sorted_redef)
641 open("article").add_class("properties filterable")
642 add_html("<h2>Properties</h2>")
643 open("ul")
644 for method in sorted_imported do
645 if method.visibility is none_visibility or method.visibility is intrude_visibility then continue
646 open("li").add_class("intro")
647 add("span").attr("title", "introduction").text("I")
648 add_html("&nbsp;")
649 add("a").attr("href", "{method.local_class.name}.html").attr("title", "").text("{method.name} ({method.local_class.name})")
650 close("li")
651 end
652
653 for method in sorted_redef do
654 if method.visibility is none_visibility or method.visibility is intrude_visibility then continue
655 open("li").add_class("redef")
656 add("span").attr("title", "redefinition").text("R")
657 add_html("&nbsp;")
658 add("a").attr("href", "{method.local_class.name}.html").attr("title", "").text("{method.name} ({method.local_class.name})")
659 close("li")
660 end
661
662 close("ul")
663 close("article")
664 end
665
666 end
667
668 # Nit Standard Library
669 class NitdocMClasses
670 super NitdocPage
671
672 var mclass: MClass
673 var aclassdef: AClassdef
674 var stdclassdef: nullable AStdClassdef
675 var public_owner: nullable MModule
676
677 init with(mclass: MClass, aclassdef: AClassdef, source: nullable String) do
678 self.mclass = mclass
679 self.aclassdef = aclassdef
680 if aclassdef isa AStdClassdef then self.stdclassdef = aclassdef
681 self.public_owner = mclass.intro_mmodule.public_owner
682 opt_nodot = false
683 destinationdir = ""
684 self.source = source
685 end
686
687 redef fun head do
688 super
689 add("title").text("{self.mclass.name} class | Nit Standard Library")
690 end
691
692 redef fun header do
693 open("header")
694 open("nav").add_class("main")
695 open("ul")
696 open("li")
697 add_html("<a href=\"index.html\">Overview</a>")
698 close("li")
699 open("li")
700 if public_owner is null then
701 add_html("<a href=\"{mclass.intro_mmodule.name}.html\">{mclass.intro_mmodule.name}</a>")
702 else
703 add_html("<a href=\"{public_owner.name}.html\">{public_owner.name}</a>")
704 end
705 close("li")
706 add("li").add_class("current").text(mclass.name)
707 open("li")
708 add_html("<a href=\"full-index.html\" >Full Index</a>")
709 close("li")
710 open("li").attr("id", "liGitHub")
711 open("a").add_class("btn").attr("id", "logGitHub")
712 add("img").attr("id", "imgGitHub").attr("src", "resources/icons/github-icon.png")
713 close("a")
714 open("div").add_class("popover bottom")
715 add("div").add_class("arrow").text(" ")
716 open("div").add_class("githubTitle")
717 add("h3").text("Github Sign In")
718 close("div")
719 open("div")
720 add("label").attr("id", "lbloginGit").text("Username")
721 add("input").attr("id", "loginGit").attr("name", "login").attr("type", "text")
722 open("label").attr("id", "logginMessage").text("Hello ")
723 open("a").attr("id", "githubAccount")
724 add("strong").attr("id", "nickName").text(" ")
725 close("a")
726 close("label")
727 close("div")
728 open("div")
729 add("label").attr("id", "lbpasswordGit").text("Password")
730 add("input").attr("id", "passwordGit").attr("name", "password").attr("type", "password")
731 open("div").attr("id", "listBranches")
732 add("label").attr("id", "lbBranches").text("Branch")
733 add("select").add_class("dropdown").attr("id", "dropBranches").attr("name", "dropBranches").attr("tabindex", "1").text(" ")
734 close("div")
735 close("div")
736 open("div")
737 add("label").attr("id", "lbrepositoryGit").text("Repository")
738 add("input").attr("id", "repositoryGit").attr("name", "repository").attr("type", "text")
739 close("div")
740 open("div")
741 add("label").attr("id", "lbbranchGit").text("Branch")
742 add("input").attr("id", "branchGit").attr("name", "branch").attr("type", "text")
743 close("div")
744 open("div")
745 add("a").attr("id", "signIn").text("Sign In")
746 close("div")
747 close("div")
748 close("li")
749 close("ul")
750 close("nav")
751 close("header")
752 end
753
754 redef fun body do
755 super
756 open("div").add_class("page")
757 add_content
758 close("div")
759 add("footer").text("Nit standard library. Version jenkins-component=stdlib-19.")
760 end
761
762 # Insert all tags in content part
763 fun add_content do
764 open("div").add_class("menu")
765 properties_column
766 inheritance_column
767 close("div")
768 open("div").add_class("content")
769 content
770 close("div")
771 end
772
773 fun properties_column do
774 open("nav").add_class("properties filterable")
775 add("h3").text("Properties")
776
777 if mclass.virtual_types.length > 0 then
778 add("h4").text("Virtual Types")
779 open("ul")
780 for prop in mclass.virtual_types do
781 add_html("<li class=\"redef\"><span title=\"Redefined\">R</span><a href=\"{prop.link_anchor}\">{prop.name}</a></li>")
782 end
783 close("ul")
784 end
785 if mclass.constructors.length > 0 then
786 add("h4").text("Constructors")
787 open("ul")
788 for prop in mclass.constructors do
789 add_html("<li class=\"intro\"><span title=\"Introduced\">I</span><a href=\"{prop.link_anchor}\">{prop.name}</a></li>")
790 end
791 close("ul")
792 end
793 add("h4").text("Methods")
794 open("ul")
795 if mclass.intro_methods.length > 0 then
796 for prop in mclass.intro_methods do
797 if prop.visibility is public_visibility or prop.visibility is protected_visibility then add_html("<li class=\"intro\"><span title=\"Introduced\">I</span><a href=\"{prop.link_anchor}\">{prop.name}</a></li>")
798 end
799 end
800 if mclass.inherited_methods.length > 0 then
801 for prop in mclass.inherited_methods do
802 if prop.visibility is public_visibility or prop.visibility is protected_visibility then add_html("<li class=\"inherit\"><span title=\"Inherited\">H</span><a href=\"{prop.link_anchor}\">{prop.name}</a></li>")
803 end
804 end
805 if mclass.redef_methods.length > 0 then
806 for prop in mclass.redef_methods do
807 if prop.visibility is public_visibility or prop.visibility is protected_visibility then add_html("<li class=\"redef\"><span title=\"Refined\">R</span><a href=\"{prop.link_anchor}\">{prop.name}</a></li>")
808 end
809 end
810 close("ul")
811 close("nav")
812 end
813
814 fun inheritance_column do
815 open("nav")
816 add("h3").text("Inheritance")
817 if mclass.parents.length > 0 then
818 add("h4").text("Superclasses")
819 open("ul")
820 for sup in mclass.parents do add_html("<li><a href=\"{sup.name}.html\">{sup.name}</a></li>")
821 close("ul")
822 end
823
824 if mclass.descendants.length is 0 then
825 add("h4").text("No Known Subclasses")
826 else if mclass.descendants.length <= 100 then
827 add("h4").text("Subclasses")
828 open("ul")
829 for sub in mclass.descendants do add_html("<li><a href=\"{sub.name}\">{sub.name}</a></li>")
830 close("ul")
831 else if mclass.children.length <= 100 then
832 add("h4").text("Direct Subclasses Only")
833 open("ul")
834 for sub in mclass.children do add_html("<li><a href=\"{sub.name}\">{sub.name}</a></li>")
835 close("ul")
836 else
837 add("h4").text("Too much Subclasses to list")
838 end
839 close("nav")
840 end
841
842 fun content do
843 var subtitle = ""
844 var lmmodule = new List[MModule]
845 # Insert the subtitle part
846 add("h1").text(mclass.name)
847 open("div").add_class("subtitle")
848 if mclass.visibility is none_visibility then subtitle += "private "
849 subtitle += "{mclass.kind} <a href=\"{mclass.public_owner.name}.html\">{mclass.public_owner.name}</a>::{mclass.name}"
850 add_html(subtitle)
851 close("div")
852 add_html("<div style=\"float: right;\"><a id=\"lblDiffCommit\"></a></div>")
853 # We add the class description
854 open("section").add_class("description")
855 if not stdclassdef is null and not stdclassdef.comment.is_empty then add_html("<pre class=\"text_label\" title=\"122\" name=\"\" tag=\"{mclass.mclassdefs.first.location.to_s}\" type=\"2\">{stdclassdef.comment} </pre><textarea id=\"fileContent\" class=\"edit\" cols=\"76\" rows=\"1\" style=\"display: none;\"></textarea><a id=\"cancelBtn\" style=\"display: none;\">Cancel</a><a id=\"commitBtn\" style=\"display: none;\">Commit</a><pre id=\"preSave\" class=\"text_label\" type=\"2\"></pre>")
856 close("section")
857 open("section").add_class("concerns")
858 add("h2").add_class("section-header").text("Concerns")
859 open("ul")
860 for owner, childs in mclass.concerns do
861 open("li")
862 add_html("<a href=\"#MOD_{owner.name}\">{owner.name}</a>: {owner.amodule.short_comment}")
863 if not childs is null then
864 open("ul")
865 for child in childs.as(not null) do add_html("<li><a href=\"#MOD_{child.name}\">{child.name}</a>: {child.amodule.short_comment} </li>")
866 close("ul")
867 end
868 close("li")
869 end
870 close("ul")
871 close("section")
872 # Insert virtual types if there is almost one
873 if mclass.virtual_types.length > 0 or (stdclassdef != null and stdclassdef.n_formaldefs.length > 0) then
874 open("section").add_class("types")
875 add("h2").text("Formal and Virtual Types")
876 if mclass.virtual_types.length > 0 then for prop in mclass.virtual_types do description(prop)
877 if stdclassdef.n_formaldefs.length > 0 then
878 for prop in stdclassdef.n_formaldefs do
879 open("article").attr("id", "FT_Object_{prop.collect_text}")
880 open("h3").add_class("signature").text("{prop.collect_text}: nullable ")
881 add_html("<a title=\"The root of the class hierarchy.\" href=\"Object.html\">Object</a>")
882 close("h3")
883 add_html("<div class=\"info\">formal generic type</div>")
884 close("article")
885 end
886 end
887 close("section")
888 end
889 # Insert constructors if there is almost one
890 if mclass.constructors.length > 0 then
891 open("section").add_class("constructors")
892 add("h2").add_class("section-header").text("Constructors")
893 for prop in mclass.constructors do description(prop)
894 close("section")
895 end
896 open("section").add_class("methods")
897 add("h2").add_class("section-header").text("Methods")
898 for mmodule, mmethods in mclass.all_methods do
899 add_html("<a id=\"MOD_{mmodule.name}\"></a>")
900 if mmodule != mclass.intro_mmodule and mmodule != mclass.public_owner then
901 if mclass.has_mmodule(mmodule) then
902 add_html("<p class=\"concern-doc\">{mmodule.name}: {mmodule.amodule.short_comment}</p>")
903 else
904 add_html("<h3 class=\"concern-toplevel\">Methods refined in <a href=\"{mmodule.name}.html\">{mmodule.name}</a></h3><p class=\"concern-doc\">{mmodule.name}: {mmodule.amodule.short_comment}</p>")
905 end
906 end
907 for prop in mmethods do description(prop)
908 end
909 # Insert inherited methods
910 if mclass.inherited_methods.length > 0 then
911 add("h3").text("Inherited Methods")
912 for i_mclass, methods in mclass.inherited do
913 open("p")
914 add_html("Defined in <a href=\"{i_mclass.name}.html\">{i_mclass.name}</a>: ")
915 for method in methods do
916 add_html("<a href=\"{method.link_anchor}\">{method.name}</a>")
917 if method != methods.last then add_html(", ")
918 end
919 close("p")
920 end
921 end
922 close("section")
923 end
924
925 # Insert description tags for 'prop'
926 fun description(prop: MProperty) do
927 open("article").add_class("fun public {if prop.is_redef then "redef" else ""}").attr("id", "{prop.anchor}")
928 var sign = prop.name
929 if prop.apropdef != null then sign += prop.apropdef.signature
930 add_html("<h3 class=\"signature\">{sign}</h3>")
931 add_html("<div class=\"info\">{if prop.is_redef then "redef" else ""} fun {prop.intro_mclassdef.namespace(mclass)}::{prop.name}</div><div style=\"float: right;\"><a id=\"lblDiffCommit\"></a></div>")
932
933 open("div").add_class("description")
934 if prop.apropdef is null or prop.apropdef.comment == "" then
935 add_html("<a class=\"newComment\" title=\"32\" tag=\"\">New Comment</a>")
936 else
937 add_html("<pre class=\"text_label\" title=\"\" name=\"\" tag=\"\" type=\"1\">{prop.apropdef.comment}</pre>")
938 end
939 add_html("<textarea id=\"fileContent\" class=\"edit\" cols=\"76\" rows=\"1\" style=\"display: none;\"></textarea><a id=\"cancelBtn\" style=\"display: none;\">Cancel</a><a id=\"commitBtn\" style=\"display: none;\">Commit</a><pre id=\"preSave\" class=\"text_label\" type=\"2\"></pre>")
940 open("p")
941 if prop.local_class != mclass then add_html("inherited from {prop.local_class.intro_mmodule.name} ")
942 #TODO display show code if doc github
943 add_html("defined by the module <a href=\"{prop.intro_mclassdef.mmodule.name}.html\">{prop.intro_mclassdef.mmodule.name}</a> {if prop.apropdef is null then "" else show_source(prop.apropdef.location)}.")
944
945 for parent in mclass.parents do
946 if prop isa MMethod then if parent.constructors.has(prop) then add_html(" Previously defined by: <a href=\"{parent.intro_mmodule.name}.html\">{parent.intro_mmodule.name}</a> for <a href=\"{parent.name}.html\">{parent.name}</a>.")
947 end
948 close("p")
949 close("div")
950
951 close("article")
952 end
953
954 end
955
956 class NitdocPage
957 super HTMLPage
958
959 var opt_nodot: Bool
960 var destinationdir : String
961 var source: nullable String
962
963 redef fun head do
964 add("meta").attr("charset", "utf-8")
965 add("script").attr("type", "text/javascript").attr("src", "scripts/jquery-1.7.1.min.js")
966 add("script").attr("type", "text/javascript").attr("src", "quicksearch-list.js")
967 add("script").attr("type", "text/javascript").attr("src", "scripts/js-facilities.js")
968 add("link").attr("rel", "stylesheet").attr("href", "styles/main.css").attr("type", "text/css").attr("media", "screen")
969 end
970
971 redef fun body do header
972 fun header do end
973
974 # Generate a clickable graphviz image using a dot content
975 fun generate_dot(dot: String, name: String, alt: String) do
976 if opt_nodot then return
977 var file = new OFStream.open("{self.destinationdir}/{name}.dot")
978 file.write(dot)
979 file.close
980 sys.system("\{ test -f {self.destinationdir}/{name}.png && test -f {self.destinationdir}/{name}.s.dot && diff {self.destinationdir}/{name}.dot {self.destinationdir}/{name}.s.dot >/dev/null 2>&1 ; \} || \{ cp {self.destinationdir}/{name}.dot {self.destinationdir}/{name}.s.dot && dot -Tpng -o{self.destinationdir}/{name}.png -Tcmapx -o{self.destinationdir}/{name}.map {self.destinationdir}/{name}.s.dot ; \}")
981 open("article").add_class("graph")
982 add("img").attr("src", "{name}.png").attr("usemap", "#{name}").attr("style", "margin:auto").attr("alt", "{alt}")
983 close("article")
984 var fmap = new IFStream.open("{self.destinationdir}/{name}.map")
985 add_html(fmap.read_all)
986 fmap.close
987 end
988
989 # Add a (source) link fo a given location
990 fun show_source(l: Location): String
991 do
992 if source == null then
993 return "({l.file.filename.simplify_path})"
994 else
995 # THIS IS JUST UGLY ! (but there is no replace yet)
996 var x = source.split_with("%f")
997 source = x.join(l.file.filename.simplify_path)
998 x = source.split_with("%l")
999 source = x.join(l.line_start.to_s)
1000 x = source.split_with("%L")
1001 source = x.join(l.line_end.to_s)
1002 return " (<a href=\"{source.to_s}\">show code</a>)"
1003 end
1004 end
1005
1006 end
1007
1008 redef class AModule
1009 private fun comment: String do
1010 var ret = ""
1011 if n_moduledecl is null or n_moduledecl.n_doc is null then ret
1012 if n_moduledecl.n_doc is null then return ""
1013 for t in n_moduledecl.n_doc.n_comment do
1014 ret += "{t.text.replace("# ", "")}"
1015 end
1016 return ret
1017 end
1018
1019 private fun short_comment: String do
1020 var ret = ""
1021 if n_moduledecl != null and n_moduledecl.n_doc != null then
1022 var txt = n_moduledecl.n_doc.n_comment.first.text
1023 txt = txt.replace("# ", "")
1024 txt = txt.replace("\n", "")
1025 ret += txt
1026 end
1027 return ret
1028 end
1029 end
1030
1031 redef class MModule
1032
1033 super Comparable
1034 redef type OTHER: MModule
1035 redef fun <(other: OTHER): Bool do return self.name < other.name
1036
1037 var amodule: nullable AModule
1038
1039 # Get the list of all methods in a module
1040 fun imported_methods: Set[MMethod] do
1041 var methods = new HashSet[MMethod]
1042 for mclass in imported_mclasses do
1043 for method in mclass.intro_methods do
1044 methods.add(method)
1045 end
1046 end
1047 return methods
1048 end
1049
1050 # Get the list aof all refined methods in a module
1051 fun redef_methods: Set[MMethod] do
1052 var methods = new HashSet[MMethod]
1053 for mclass in redef_mclasses do
1054 for method in mclass.intro_methods do
1055 methods.add(method)
1056 end
1057 end
1058 return methods
1059 end
1060 end
1061
1062 redef class MProperty
1063
1064 super Comparable
1065 redef type OTHER: MProperty
1066 redef fun <(other: OTHER): Bool do return self.name < other.name
1067
1068 var is_redef: Bool
1069 var apropdef: nullable APropdef
1070
1071 redef init(intro_mclassdef: MClassDef, name: String, visibility: MVisibility)
1072 do
1073 super
1074 is_redef = false
1075 end
1076
1077 fun local_class: MClass do
1078 var classdef = self.intro_mclassdef
1079 return classdef.mclass
1080 end
1081
1082 fun class_text: String do
1083 return local_class.name
1084 end
1085
1086 fun link_anchor: String do
1087 return "{class_text}.html#{anchor}"
1088 end
1089
1090 fun anchor: String do
1091 return "PROP_{c_name}"
1092 end
1093
1094 end
1095
1096 redef class MClass
1097
1098 super Comparable
1099 redef type OTHER: MClass
1100 redef fun <(other: OTHER): Bool do return self.name < other.name
1101
1102 # Associate all MMethods to each MModule concerns
1103 fun all_methods: HashMap[MModule, Set[MMethod]] do
1104 var hm = new HashMap[MModule, Set[MMethod]]
1105 for mmodule, childs in concerns do
1106 if not hm.has_key(mmodule) then hm[mmodule] = new HashSet[MMethod]
1107 for prop in intro_methods do
1108 if mmodule == prop.intro_mclassdef.mmodule then
1109 prop.is_redef = false
1110 hm[mmodule].add(prop)
1111 end
1112 end
1113 for prop in redef_methods do
1114 if mmodule == prop.intro_mclassdef.mmodule then
1115 prop.is_redef = true
1116 hm[mmodule].add(prop)
1117 end
1118 end
1119
1120 if childs != null then
1121 for child in childs do
1122 if not hm.has_key(child) then hm[child] = new HashSet[MMethod]
1123 for prop in intro_methods do
1124 if child == prop.intro_mclassdef.mmodule then
1125 prop.is_redef = false
1126 hm[child].add(prop)
1127 end
1128 end
1129 for prop in redef_methods do
1130 if child == prop.intro_mclassdef.mmodule then
1131 prop.is_redef = true
1132 hm[child].add(prop)
1133 end
1134 end
1135 end
1136 end
1137 end
1138 return hm
1139 end
1140
1141 fun public_owner: MModule do
1142 var owner = intro_mmodule
1143 if owner.public_owner is null then
1144 return owner
1145 else
1146 return owner.public_owner.as(not null)
1147 end
1148 end
1149
1150 # Associate Amodule to all MModule concern by 'self'
1151 fun amodule(amodules: HashMap[MModule, AModule]) do
1152 for owner, childs in concerns do
1153 if childs != null then for child in childs do child.amodule = amodules[child]
1154 owner.amodule = amodules[owner]
1155 end
1156 end
1157
1158 # Associate MClass to all MMethod include in 'inherited_methods'
1159 fun inherited: HashMap[MClass, Set[MMethod]] do
1160 var hm = new HashMap[MClass, Set[MMethod]]
1161 for method in inherited_methods do
1162 var mclass = method.intro_mclassdef.mclass
1163 if not hm.has_key(mclass) then hm[mclass] = new HashSet[MMethod]
1164 hm[mclass].add(method)
1165 end
1166 return hm
1167 end
1168
1169 # Return true if MModule concern contain subMModule
1170 fun has_mmodule(sub: MModule): Bool do
1171 for mmodule, childs in concerns do
1172 if childs is null then continue
1173 if childs.has(sub) then return true
1174 end
1175 return false
1176 end
1177
1178 fun mmethod(mprop2npropdef: Map[MProperty, APropdef]) do
1179 for const in constructors do
1180 if mprop2npropdef.has_key(const)then
1181 const.apropdef = mprop2npropdef[const].as(AMethPropdef)
1182 end
1183 end
1184
1185 for intro in intro_methods do
1186 if mprop2npropdef.has_key(intro)then
1187 if mprop2npropdef[intro] isa AMethPropdef then intro.apropdef = mprop2npropdef[intro].as(AMethPropdef)
1188 end
1189 end
1190
1191 for rd in redef_methods do
1192 if mprop2npropdef.has_key(rd)then
1193 if mprop2npropdef[rd] isa AMethPropdef then rd.apropdef = mprop2npropdef[rd].as(AMethPropdef)
1194 end
1195 end
1196 end
1197
1198 fun link_anchor: String do
1199 return "{name}.html"
1200 end
1201
1202 end
1203
1204 redef class AStdClassdef
1205 private fun comment: String do
1206 var ret = ""
1207 if n_doc != null then
1208 for t in n_doc.n_comment do
1209 var txt = t.text.replace("# ", "")
1210 txt = txt.replace("#", "")
1211 ret += "{txt}"
1212 end
1213 end
1214 return ret
1215 end
1216
1217 private fun short_comment: String do
1218 var ret = ""
1219 if n_doc != null then
1220 var txt = n_doc.n_comment.first.text
1221 txt = txt.replace("# ", "")
1222 txt = txt.replace("\n", "")
1223 ret += txt
1224 end
1225 return ret
1226 end
1227 end
1228
1229 redef class ASignature
1230 redef fun to_s do
1231 #TODO closures
1232 var ret = ""
1233 if not n_params.is_empty then
1234 ret = "{ret}({n_params.join(", ")})"
1235 end
1236 if n_type != null and n_type.to_s != "" then ret += " {n_type.to_s}"
1237 return ret
1238 end
1239 end
1240
1241 redef class AParam
1242 redef fun to_s do
1243 var ret = "{n_id.text}"
1244 if n_type != null then
1245 ret = "{ret}: {n_type.to_s}"
1246 if n_dotdotdot != null then ret = "{ret}..."
1247 end
1248 return ret
1249 end
1250 end
1251
1252 redef class AType
1253 redef fun to_s do
1254 var ret = "<a href=\"{n_id.text}.html\">{n_id.text}</a>"
1255 if n_kwnullable != null then ret = "nullable {ret}"
1256 if not n_types.is_empty then ret = "{ret}[{n_types.join(", ")}]"
1257 return ret
1258 end
1259 end
1260
1261 redef class APropdef
1262 private fun short_comment: String is abstract
1263 private fun signature: String is abstract
1264 private fun comment: String is abstract
1265 end
1266
1267 redef class AAttrPropdef
1268 redef fun short_comment do
1269 var ret = ""
1270 if n_doc != null then
1271 var txt = n_doc.n_comment.first.text
1272 txt = txt.replace("# ", "")
1273 txt = txt.replace("\n", "")
1274 ret += txt
1275 end
1276 return ret
1277 end
1278 end
1279
1280 redef class AMethPropdef
1281 redef fun short_comment do
1282 var ret = ""
1283 if n_doc != null then
1284 var txt = n_doc.n_comment.first.text
1285 txt = txt.replace("# ", "")
1286 txt = txt.replace("\n", "")
1287 ret += txt
1288 end
1289 return ret
1290 end
1291
1292 redef fun signature: String do
1293 var sign = ""
1294 if n_signature != null then sign = " {n_signature.to_s}"
1295 return sign
1296 end
1297
1298 redef private fun comment: String do
1299 var ret = ""
1300 if n_doc != null then
1301 for t in n_doc.n_comment do
1302 var txt = t.text.replace("# ", "")
1303 txt = txt.replace("#", "")
1304 ret += "{txt}"
1305 end
1306 end
1307 return ret
1308 end
1309 end
1310
1311 redef class MClassDef
1312 private fun namespace(mclass: MClass): String do
1313
1314 if mmodule.public_owner is null then
1315 return "{mmodule.full_name}::{mclass.name}"
1316 else if mclass is self.mclass then
1317 return "{mmodule.public_owner.name}::{mclass.name}"
1318 else
1319 return "{mmodule.public_owner.name}::<a href=\"{mclass.name}.html\">{mclass.name}</a>"
1320 end
1321 end
1322 end
1323
1324 redef class Set[E]
1325 fun last: E do
1326 return to_a[length-1]
1327 end
1328 end
1329
1330 # Create a tool context to handle options and paths
1331 var toolcontext = new ToolContext
1332
1333 # Here we launch the nit index
1334 var nitdoc = new Nitdoc(toolcontext)
1335 nitdoc.start