Merge: Added contributing guidelines and link from readme
[nit.git] / src / nitweb.nit
1 # This file is part of NIT ( http://www.nitlanguage.org ).
2 #
3 # Licensed under the Apache License, Version 2.0 (the "License");
4 # you may not use this file except in compliance with the License.
5 # You may obtain a copy of the License at
6 #
7 # http://www.apache.org/licenses/LICENSE-2.0
8 #
9 # Unless required by applicable law or agreed to in writing, software
10 # distributed under the License is distributed on an "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 # See the License for the specific language governing permissions and
13 # limitations under the License.
14
15 # Runs a webserver based on nitcorn that render things from model.
16 module nitweb
17
18 import frontend
19 import web
20
21 redef class ToolContext
22
23 # Host name to bind on.
24 var opt_host = new OptionString("Host to bind the server on", "--host")
25
26 # Port number to bind on.
27 var opt_port = new OptionInt("Port number to use", 3000, "--port")
28
29 # Web rendering phase.
30 var webphase: Phase = new NitwebPhase(self, null)
31
32 init do
33 super
34 option_context.add_option(opt_host, opt_port)
35 end
36 end
37
38 # Phase that builds the model and wait for http request to serve pages.
39 private class NitwebPhase
40 super Phase
41 redef fun process_mainmodule(mainmodule, mmodules)
42 do
43 var model = mainmodule.model
44 var modelbuilder = toolcontext.modelbuilder
45
46 # Build catalog
47 var catalog = new Catalog(modelbuilder)
48 for mpackage in model.mpackages do
49 catalog.deps.add_node(mpackage)
50 for mgroup in mpackage.mgroups do
51 for mmodule in mgroup.mmodules do
52 for imported in mmodule.in_importation.direct_greaters do
53 var ip = imported.mpackage
54 if ip == null or ip == mpackage then continue
55 catalog.deps.add_edge(mpackage, ip)
56 end
57 end
58 end
59 catalog.git_info(mpackage)
60 catalog.package_page(mpackage)
61 end
62
63 # Run the server
64 var host = toolcontext.opt_host.value or else "localhost"
65 var port = toolcontext.opt_port.value
66
67 var app = new App
68
69 app.use_before("/*", new RequestClock)
70 app.use("/api", new APIRouter(model, modelbuilder, mainmodule, catalog))
71 app.use("/doc/:namespace", new DocAction(model, mainmodule, modelbuilder))
72 app.use("/*", new StaticHandler(toolcontext.share_dir / "nitweb", "index.html"))
73 app.use_after("/*", new ConsoleLog)
74
75 app.listen(host, port.to_i)
76 end
77 end
78
79 # Group all api handlers in one router.
80 class APIRouter
81 super Router
82
83 # Model to pass to handlers.
84 var model: Model
85
86 # ModelBuilder to pass to handlers.
87 var modelbuilder: ModelBuilder
88
89 # Mainmodule to pass to handlers.
90 var mainmodule: MModule
91
92 # Catalog to pass to handlers.
93 var catalog: Catalog
94
95 init do
96 use("/catalog", new APICatalogRouter(model, mainmodule, catalog))
97 use("/list", new APIList(model, mainmodule))
98 use("/search", new APISearch(model, mainmodule))
99 use("/random", new APIRandom(model, mainmodule))
100 use("/entity/:id", new APIEntity(model, mainmodule))
101 use("/code/:id", new APIEntityCode(model, mainmodule, modelbuilder))
102 use("/uml/:id", new APIEntityUML(model, mainmodule))
103 use("/linearization/:id", new APIEntityLinearization(model, mainmodule))
104 use("/defs/:id", new APIEntityDefs(model, mainmodule))
105 end
106 end
107
108 # build toolcontext
109 var toolcontext = new ToolContext
110 var tpl = new Template
111 tpl.add "Usage: nitweb [OPTION]... <file.nit>...\n"
112 tpl.add "Run a webserver based on nitcorn that serve pages about model."
113 toolcontext.tooldescription = tpl.write_to_string
114
115 # process options
116 toolcontext.process_options(args)
117 var arguments = toolcontext.option_context.rest
118
119 # build model
120 var model = new Model
121 var mbuilder = new ModelBuilder(model, toolcontext)
122 var mmodules = mbuilder.parse_full(arguments)
123
124 # process
125 if mmodules.is_empty then return
126 mbuilder.run_phases
127 toolcontext.run_global_phases(mmodules)