update CLI (#253)

Author: Ethosa

happyx.nimble

@@ -2,7 +2,7 @@
 
 description = "Macro-oriented asynchronous web-framework written with ♥"
 author = "HapticX"
-version = "3.9.0"
+version = "3.10.0"
 license = "MIT"
 srcDir = "src"
 installExt = @["nim"]

src/happyx/cli/flags_command.nim

@@ -0,0 +1,42 @@
+import
+  ./utils
+
+
+proc flagsCommand*() =
+  ## Shows the general help message that describes
+  styledEcho "Here is ", fgMagenta, "HappyX", fgWhite, " flags:"
+  styledEcho " [Flags colors]:"
+  styledEcho fgMagenta, "   for SSG/SSR/SPA"
+  styledEcho fgCyan, "   flags with values"
+  styledEcho fgYellow, "   works with any flags"
+  styledEcho fgRed, "   experimental"
+  styledEcho " [Main]:"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "httpx", fgWhite, " - switches to HttpX server"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "beast", fgWhite, " - switches to HttpBeast server"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "micro", fgWhite, " - switches to MicroAsyncHttpServer server"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgRed, "translate", fgWhite, " - enables autotranslation (translatable needed)"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgCyan, "cryptoMethod", fgWhite, " - chooses crypto method"
+  styledEcho "     possible values: ", fgYellow, "sha224|sha256|sha384|sha512"
+  styledEcho "     default value: ", fgYellow, "sha512"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgCyan, "numThreads", fgWhite, " - chooses number of threads (for httpx/httpbeast)"
+  styledEcho "     default value: ", fgYellow, "0"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgCyan, "sessionIdLength", fgWhite, " - chooses length of session ID"
+  styledEcho "     default value: ", fgYellow, "32"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "disableApiDoc", fgWhite, " - disable API documentation (swagger and redoc)"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "appName", fgWhite, " - application name (for documentation)"
+  styledEcho "     default value: ", fgYellow, "\"HappyX Application\""
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "apiDocsPath", fgWhite, " - docs path (for documentation)"
+  styledEcho "     default value: ", fgYellow, "\"/docs\""
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "noliveviews", fgWhite, " - Disables LiveViews at SSR/SSG (It helpful for components)"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "safeRequests", fgWhite, " - Enables requests safety (On error returns 500 with err msg)"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgMagenta, "disableDefDeco", fgWhite, " - Disables default decorators (`AuthBasic`, `GetUserAgent`)"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgYellow, "debug", fgWhite, " - enables HappyX debug"
+  styledEcho " [DEV]:"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "compDebug", fgWhite, " - enables debug logging for components"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "compTreeDebug", fgWhite, " - enables debug logging for components (tree mode)"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "ssrDebug", fgWhite, " - enables debug logging for SSR"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "spaDebug", fgWhite, " - enables debug logging for SPA"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "reqModelDebug", fgWhite, " - enables debug logging for request models"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "routingDebug", fgWhite, " - enables debug logging for routing"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "componentDebugTarget", fgWhite, " - after this component program will terminated"
+  styledEcho "  ", fgYellow, "-d", fgWhite, ":", fgGreen, "reqModelDebugTarget", fgWhite, " - after this request model program will terminated"

src/happyx/cli/help_command.nim

@@ -10,7 +10,7 @@ proc mainHelpMessage*() =
   ## Shows the general help message that describes
   let
     subcommands = [
-      "build", "dev", "serve", "create", "html2tag", "update", "info", "help"
+      "build", "dev", "serve", "create", "html2tag", "update", "info", "flags", "help"
     ]
     logoColors = [
       fgBlue, fgGreen, fgYellow, fgWhite, fgCyan

src/happyx/core/constants.nim

@@ -8,12 +8,10 @@
 ## | `-d:micro`           | enables MicroAsyncHttpServer as alternative HTTP Server ⚡    | ❌         |
 ## | `-d:translate`       | enables automatic translate for returns 🌐                     | ❌         |
 ## | `-d:debug`           | enables debug logging 💻                                      | ❌         |
-## | `-d:oldRenderer`     | enables old renderer for SPA 🍍                               | ❌         |
 ## | `-d:cryptoMethod`    | choose crypto method for `generate_password` methods 🔐       | ✅         |
 ## | `-d:numThreads`      | choose number of threads (httpx/httpbeast) ⌛                 |  ✅        |
 ## | `-d:sessionIdLength` | choose length of session ID ✍                                |  ✅        |
 ## | `-d:disableApiDoc`   | disables built-in API documentation 📕                        | ❌         |
-## | `-d:disableORM`      | disables built-in ORM 📑                                      | ❌         |
 ## | `-d:appName`         | choose name of application (SSR/SSG) 📕                       | ✅         |
 ## | `-d:apiDocsPath`     | choose path for API documentation 📕                          |  ✅        |
 ## | `-d:noliveviews`     | Disables LiveViews at SSR/SSG (It helpful for components) 📕  |  ❌        |

src/happyx/hpx.nim

@@ -10,7 +10,8 @@ import
     create_command, build_command,
     dev_command, serve_command,
     html2tag_command, help_command,
-    update_command, project_info_command
+    update_command, project_info_command,
+    flags_command
   ]
 
 import illwill except
@@ -25,6 +26,7 @@ proc html2tagCommandAux(output: string = "", args: seq[string]): int = html2tagC
 proc updateCommandAux(args: seq[string]): int = updateCommand(args)
 proc serveCommandAux(host: string = "0.0.0.0", port: int = 80): int = serveCommand(host, port)
 proc projectInfoCommandAux(): int = projectInfoCommand()
+proc flagsCommandAux(): int = flagsCommand()
 proc devCommandAux(host: string = "127.0.0.1", port: int = 5000,
                    reload: bool = false): int =
   devCommand(host, port, reload)
@@ -34,6 +36,7 @@ proc createCommandAux(name: string = "", kind: string = "", templates: bool = fa
 
 
 proc mainCommand(version = false): int =
+  ## HappyX main command
   if version:
     styledEcho "HappyX ", fgGreen, HpxVersion
   else:
@@ -52,6 +55,7 @@ when isMainModule:
     [createCommandAux, cmdName = "create"],
     [html2tagCommandAux, cmdName = "html2tag"],
     [updateCommandAux, cmdName = "update"],
+    [flagsCommandAux, cmdName = "flags"],
     [
       mainCommand,
       short = {"version": 'v'}
@@ -77,6 +81,8 @@ when isMainModule:
   case subcmd
   of "build":
     quit(dispatchbuild(cmdline = pars[1..^1]))
+  of "flags":
+    quit(dispatchflags(cmdline = pars[1..^1]))
   of "dev":
     quit(dispatchdev(cmdline = pars[1..^1]))
   of "serve":
@@ -152,6 +158,10 @@ when isMainModule:
       styledEcho "\nUsage:"
       styledEcho fgMagenta, "  hpx info"
       styledEcho fgYellow, "Use ", fgMagenta, "--no-emoji", fgYellow, " flag to disable emoji"
+    of "flags":
+      styledEcho fgBlue, "HappyX", fgMagenta, " flags ", fgWhite, "command displays all HappyX Nim flags."
+      styledEcho "\nUsage:"
+      styledEcho fgMagenta, "  hpx flags"
     else:
       styledEcho fgRed, "Unknown subcommand: ", fgWhite, subcmdHelp
     shutdownCli()

src/happyx/spa/renderer.nim

@@ -262,11 +262,7 @@ else:
 when defined(js):
   proc renderVdom*(app: App, tag: TagRef, force: bool = false) =
     ## Rerender DOM with VDOM
-    # compile with `-d:oldRenderer` to work with old renderer
-    when enableOldRenderer:
-      document.getElementById(app.appId).innerHTML = $tag
-    else:
-      var realDom = document.getElementById(app.appId).Node
+    var realDom = document.getElementById(app.appId).Node
     realDom.innerHTML = ""
     realDom.appendChild(tag)
     if force: