akane.nim 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344
  1. # author: Ethosa
  2. # ----- CORE ----- #
  3. import asyncdispatch
  4. import asynchttpserver
  5. # ----- SUPPORT ----- #
  6. import asyncfile # loadtemplate
  7. import strutils # startsWith, endsWith
  8. import tables
  9. import macros
  10. import times
  11. import json # urlParams
  12. import uri # decodeUrl
  13. import os
  14. import re # regex
  15. # ----- EXPORT -----
  16. export asyncdispatch
  17. export asynchttpserver
  18. export strutils
  19. export json
  20. export uri
  21. export re
  22. type
  23. ServerRef* = ref object
  24. port*: uint16
  25. address*: string
  26. server*: AsyncHttpServer
  27. var AKANE_DEBUG_MODE*: bool = false
  28. proc newServer*(address: string = "127.0.0.1",
  29. port: uint16 = 5000, debug: bool = false): ServerRef =
  30. ## Creates a new ServerRef object.
  31. ##
  32. ## Arguments:
  33. ## - ``address`` - server address, e.g. "127.0.0.1"
  34. ## - ``port`` - server port, e.g. 5000
  35. ## - ``debug`` - debug mode
  36. if not existsDir("templates"):
  37. createDir("templates")
  38. AKANE_DEBUG_MODE = debug
  39. return ServerRef(
  40. address: address, port: port,
  41. server: newAsyncHttpServer()
  42. )
  43. proc loadtemplate*(name: string, json: JsonNode = %*{}): Future[string] {.async, inline.} =
  44. ## Loads HTML template from `templates` folder.
  45. ##
  46. ## Arguments:
  47. ## - ``name`` - template's name, e.g. "index", "api", etc.
  48. var
  49. file = openAsync(("templates" / name) & ".html")
  50. readed = await file.readAll()
  51. file.close()
  52. for key, value in json.pairs:
  53. let
  54. # if statment, e.g.: if $(variable) {......}
  55. if_stmt = re("if\\s*(\\$\\(" & key & "\\))\\s*\\{\\s*([\\s\\S]+?)\\s*\\}")
  56. # variable statment, e.g.: $(variable)
  57. variable_stmt = re("(\\$\\s*\\(" & key & "\\))")
  58. if readed.contains(if_stmt):
  59. var canplace: bool = false
  60. case value.kind:
  61. of JBool:
  62. if value.getBool:
  63. canplace = true
  64. of JInt:
  65. if value.getInt != 0:
  66. canplace = true
  67. of JFloat:
  68. if value.getFloat != 0.0:
  69. canplace = true
  70. of JString:
  71. if value.getStr.len > 0:
  72. canplace = true
  73. of JArray:
  74. if value.len > 0:
  75. canplace = true
  76. of JObject:
  77. if value.getFields.len > 0:
  78. canplace = true
  79. else: discard
  80. if canplace:
  81. readed = readed.replacef(if_stmt, "$2")
  82. else:
  83. readed = readed.replacef(if_stmt, "")
  84. readed = readed.replacef(variable_stmt, $value)
  85. return readed
  86. proc parseQuery*(request: Request): Future[JsonNode] {.async.} =
  87. ## Decodes query.
  88. ## e.g.:
  89. ## "a=5&b=10" -> {"a": "5", "b": "10"}
  90. ##
  91. ## This also have debug output, if AKANE_DEBUG_MODE is true.
  92. var data = request.url.query.split("&")
  93. result = %*{}
  94. for i in data:
  95. let timed = i.split("=")
  96. if timed.len > 1:
  97. result[decodeUrl(timed[0])] = %decodeUrl(timed[1])
  98. if AKANE_DEBUG_MODE:
  99. let
  100. now = times.local(times.getTime())
  101. timed_month = ord(now.month)
  102. month = if timed_month > 9: $timed_month else: "0" & $timed_month
  103. day = if now.monthday > 9: $now.monthday else: "0" & $now.monthday
  104. hour = if now.hour > 9: $now.hour else: "0" & $now.hour
  105. minute = if now.minute > 9: $now.minute else: "0" & $now.minute
  106. second = if now.second > 9: $now.second else: "0" & $now.second
  107. host =
  108. if request.headers.hasKey("host") and request.headers["host"].len > 1:
  109. request.headers["host"] & " "
  110. else:
  111. "new "
  112. echo(
  113. host, request.reqMethod,
  114. " at ", now.year, ".", month, ".", day,
  115. " ", hour, ":", minute, ":", second,
  116. " Request from ", request.hostname,
  117. " to url \"", decodeUrl(request.url.path), "\".")
  118. macro pages*(server: ServerRef, body: untyped): untyped =
  119. ## This macro provides convenient page adding.
  120. ##
  121. ## `body` should be StmtList.
  122. ## page type can be:
  123. ## - ``equals``
  124. ## - ``startswith``
  125. ## - ``endswith``
  126. ## - ``regex``
  127. ## - ``notfound`` - this page uses without URL argument.
  128. ##
  129. ## ..code-block::Nim
  130. ## server.pages:
  131. ## equals("/home"):
  132. ## echo url
  133. ## echo urlParams
  134. var
  135. stmtlist = newStmtList()
  136. notfound_declaration = false
  137. stmtlist.add(
  138. newNimNode(nnkLetSection).add( # let urlParams: JsonNode = await parseQuery(request)
  139. newNimNode(nnkIdentDefs).add(
  140. ident("urlParams"),
  141. ident("JsonNode"),
  142. newCall(
  143. "await",
  144. newCall(
  145. "parseQuery",
  146. ident("request")
  147. )
  148. )
  149. )
  150. ),
  151. newNimNode(nnkLetSection).add( # let decode_url: string = decodeUrl(request.url.path)
  152. newNimNode(nnkIdentDefs).add(
  153. ident("decoded_url"),
  154. ident("string"),
  155. newCall(
  156. "decodeUrl",
  157. newNimNode(nnkDotExpr).add(
  158. newNimNode(nnkDotExpr).add(
  159. ident("request"), ident("url")
  160. ),
  161. ident("path")
  162. )
  163. )
  164. )
  165. )
  166. )
  167. stmtlist.add(newNimNode(nnkIfStmt))
  168. var ifstmtlist = stmtlist[2]
  169. for i in body: # for each page in statment list.
  170. let
  171. current = $i[0]
  172. path = if i.len == 3: i[1] else: newEmptyNode()
  173. slist = if i.len == 3: i[2] else: i[1]
  174. if (i.kind == nnkCall and i[0].kind == nnkIdent and
  175. (path.kind == nnkStrLit or path.kind == nnkCallStrLit or path.kind == nnkEmpty) and
  176. slist.kind == nnkStmtList):
  177. if current == "equals":
  178. slist.insert(0, # let url: string = `path`
  179. newNimNode(nnkLetSection).add(
  180. newNimNode(nnkIdentDefs).add(
  181. ident("url"),
  182. ident("string"),
  183. path
  184. )
  185. )
  186. )
  187. ifstmtlist.add( # request.path.url == i[1]
  188. newNimNode(nnkElifBranch).add(
  189. newCall("==", path, ident("decoded_url")),
  190. slist))
  191. elif current == "startswith":
  192. slist.insert(0, # let url = decoded_url[`path`.len..^1]
  193. newNimNode(nnkLetSection).add(
  194. newNimNode(nnkIdentDefs).add(
  195. ident("url"),
  196. ident("string"),
  197. newCall(
  198. "[]",
  199. ident("decoded_url"),
  200. newCall(
  201. "..^",
  202. newCall("len", path),
  203. newLit(1))
  204. )
  205. )
  206. )
  207. )
  208. ifstmtlist.add( # decode_url.startsWith(`path`)
  209. newNimNode(nnkElifBranch).add(
  210. newCall(
  211. "startsWith",
  212. ident("decoded_url"),
  213. path),
  214. slist))
  215. elif current == "endswith":
  216. slist.insert(0, # let url: string = decoded_url[0..^`path`.len]
  217. newNimNode(nnkLetSection).add(
  218. newNimNode(nnkIdentDefs).add(
  219. ident("url"),
  220. ident("string"),
  221. newCall(
  222. "[]",
  223. ident("decoded_url"),
  224. newCall(
  225. "..^",
  226. newLit(0),
  227. newCall("+", newLit(1), newCall("len", path))
  228. )
  229. )
  230. )
  231. )
  232. )
  233. ifstmtlist.add( # decode_url.endsWith(`path`)
  234. newNimNode(nnkElifBranch).add(
  235. newCall(
  236. "endsWith",
  237. ident("decoded_url"),
  238. path),
  239. slist))
  240. elif current == "regex":
  241. slist.insert(0, # discard match(decoded_url, `path`, url)
  242. newNimNode(nnkDiscardStmt).add(
  243. newCall("match", ident("decoded_url"), path, ident("url"))
  244. )
  245. )
  246. slist.insert(0, # var url: array[20, string]
  247. newNimNode(nnkVarSection).add(
  248. newNimNode(nnkIdentDefs).add(
  249. ident("url"),
  250. newNimNode(nnkBracketExpr).add(
  251. ident("array"), newLit(20), ident("string")
  252. ),
  253. newEmptyNode()
  254. )
  255. ))
  256. ifstmtlist.add( # decode_url.match(`path`)
  257. newNimNode(nnkElifBranch).add(
  258. newCall("match", ident("decoded_url"), path),
  259. slist))
  260. elif current == "notfound":
  261. notfound_declaration = true
  262. ifstmtlist.add(newNimNode(nnkElse).add(slist))
  263. if not notfound_declaration:
  264. ifstmtlist.add(
  265. newNimNode(nnkElse).add(
  266. newCall( # await request.respond(Http404, "Not found")
  267. "await",
  268. newCall(
  269. "respond",
  270. ident("request"),
  271. ident("Http404"),
  272. newLit("Not found"))
  273. )
  274. )
  275. )
  276. result = newNimNode(nnkProcDef).add(
  277. ident("receivepages"), # procedure name.
  278. newEmptyNode(), # for template and macros
  279. newEmptyNode(), # generics
  280. newNimNode(nnkFormalParams).add( # proc params
  281. newEmptyNode(), # return type
  282. newNimNode(nnkIdentDefs).add( # param
  283. ident("request"), # param name
  284. ident("Request"), # param type
  285. newEmptyNode() # param default value
  286. )
  287. ),
  288. newNimNode(nnkPragma).add( # pragma declaration
  289. ident("async"),
  290. ident("gcsafe")
  291. ),
  292. newEmptyNode(),
  293. stmtlist)
  294. macro answer*(request, message: untyped, http_code = Http200): untyped =
  295. ## Responds from server with utf-8.
  296. ##
  297. ## Translates to:
  298. ## await request.respond(Http200, "<head><meta charset='utf-8'></head>" & message)
  299. result = newCall(
  300. "respond",
  301. request,
  302. http_code,
  303. newCall("&", newLit("<head><meta charset='utf-8'></head>"), message)
  304. )
  305. macro error*(request, message: untyped, http_code = Http404): untyped =
  306. ## Responds from server with utf-8.
  307. ##
  308. ## Translates to:
  309. ## await request.respond(Http404, "<head><meta charset='utf-8'></head>" & message)
  310. result = newCall(
  311. "respond",
  312. request,
  313. http_code,
  314. newCall("&", newLit("<head><meta charset='utf-8'></head>"), message)
  315. )
  316. macro start*(server: ServerRef): untyped =
  317. ## Starts server.
  318. result = quote do:
  319. if AKANE_DEBUG_MODE:
  320. echo "Server starts on http://", `server`.address, ":", `server`.port
  321. waitFor `server`.server.serve(Port(`server`.port), receivepages)