oJobBrowse.yaml

# Copyright 2025 Nuno Aguiar

include:
- oJobHTTPd.yaml

jobs:
# -------------------
- name : HTTP Browser
  deps :
  - HTTP Start Server
  to   : HTTP Service
  typeArgs:
    noLog: false 
    shortcut:
      name  : httpdBrowser
      keyArg: port
      args  : 
        uri      : uri
        type     : type
        options  : options
  help : 
   text   : Provides a HTTP browser service based on an existing type.
   expects:
   - name: port
     desc: (Number) The port where the server was made available (default is 8091)
   - name: uri
     desc: (String) The URI where the HTTP File Browser will be available.
   - name: type
     desc: (String) The type of the HTTP Browser services to be used (based on ow.server.httpd.browse.*)
   - name: options
     desc: (Map) A map with options to be passed
  check:
    in:
      port     : toNumber.default(8091)
      uri      : isString.default("/")
      type     : isString.default("files")
      #options  : isMap.default({})  
  args :
    execURI: | #js
      try {
        var _options = global.__GBHTTPD[String(port) + uri]
        return ow.server.httpd.replyBrowse(server, request, _options)
      } catch(e) {
        $err(e)
        return { data: "Internal error", mimetype: "text/plain", status: 500, header: {} }
      }
  exec : | #js
    global.__GBHTTPD = global.__GBHTTPD || {}

    if (isUnDef(ow.server.httpd.browse[args.type])) throw new Error("Invalid type provided: " + args.type)
    global.__GBHTTPD[String(args.port) + args.uri] = ow.server.httpd.browse[args.type](args.uri, args.options)

# --------------------------
- name : HTTP Browse generic
  deps :
  - HTTP Start Server
  to   : HTTP Service
  typeArgs:
    noLog: false 
    shortcut:
      name  : httpdBrowse
      keyArg: port
      args  : 
        uri      : uri
        path     : path
        templates: templates
        fns      : fns
        options  : options
  help : 
   text   : Provides a HTTP browse definition. 
   expects:
   - name: port
     desc: (Number) The port where the server was made available (default is 8091)
   - name: uri
     desc: (String) The URI where the HTTP File Browse will be available.
   - name: templates
     desc: (Map) A map with templates to be used.
   - name: fns
     desc: (Map) A map with functions to be used in the template.
   - name: options
     desc: (Map) A map with options to be passed
  check:
    in:
      port     : toNumber.isNumber.default(8091)
      uri      : isString.default("/")
      path     : isString.default("")
      templates: isMap.default({})
      fns      : isMap.default({})
      options  : isMap.default({})
  args :
    execURI: | #js
      try {
        var _options = global.__GBHTTPD[String(port) + uri]
        var _out = ""
        var _lst = _options._fns.getList(request, _options)
        if (_lst.isList) {
            _out = _options._fns.renderList(_lst, server, request, _options)
            if (isMap(_out)) return _out
        } else {
            if (_lst.isFile) {
              var _obj = _options._fns.getObj(request, _options)
              return _options._fns.renderObj(_obj, server, request, _options)
            } else {
                _out = _options._fns.renderEmpty(request, _options)
            }
        }

        return server.replyOKHTML( String(_out) )
      } catch(e) {
        logErr(`Error: ${e.message}`)
        return { data: "Internal error", mimetype: "text/plain", status: 500, header: {} }
      }
  exec : | #js
    ow.loadTemplate(); ow.loadFormat(); ow.loadServer()

    // Check the functions provided
    args.fns.getList = _$(args.fns.getList, "args.fns.getList").isFunction().default((request, options) => {
      const uri = request.uri
      var puri = uri.replace(new RegExp("^" + options.parentURI + "/?"), "")

      if (io.fileExists(options.parentPath + "/" + puri)) {
          if (io.fileInfo(options.parentPath + "/" + puri).isFile) {
              return { isFile: true }
          } 
      } else {
          return { isFile: false }
      }

      var lst = io.listFiles(options.parentPath + "/" + puri).files
      return {
          isList     : true,
          fields     : [ "Filename", "Last modified", "Size", "Size in bytes" ],
          alignFields: [ "left", "center", "right", "right" ],
          key        : "Filename",
          list       : lst.map(r => ({
              isDirectory: r.isDirectory,
              values     : {
                  Filename        : r.filename,
                  "Last modified" : ow.format.fromDate(new Date(r.lastModified), "yyyy-MM-dd HH:mm:ss"),
                  Size            : (!r.isDirectory ? ow.format.toBytesAbbreviation(r.size) : ""),
                  "Size in bytes" : (!r.isDirectory ? r.size : "")
              }
          }))
      }
    })
    args.fns.getObj = _$(args.fns.getObj, "args.fns.getObj").isFunction().default((request, options) => {
      const uri = request.uri
      var puri = uri.replace(new RegExp("^" + options.parentURI + "/?"), "")
      
      if (request.params.raw == "true") {
        return { stream: io.readFileStream(options.parentPath + "/" + puri) }
      }

      var ext = String(puri).replace(/^.*\./, "")
      switch(ext) {
      case "md"  : return { data: io.readFileString(options.parentPath + "/" + puri), type: "md" }
      case "yml" :
      case "yaml": return { data: io.readFileString(options.parentPath + "/" + puri), type: "yaml" }
      case "css" : return { data: io.readFileString(options.parentPath + "/" + puri), type: "css" }
      case "sh"  : return { data: io.readFileString(options.parentPath + "/" + puri), type: "sh" }
      case "js"  : return { data: io.readFileString(options.parentPath + "/" + puri), type: "js" }
      case "java": return { data: io.readFileString(options.parentPath + "/" + puri), type: "java" }
      case "py"  : return { data: io.readFileString(options.parentPath + "/" + puri), type: "python" }
      case "toml": return { data: io.readFileString(options.parentPath + "/" + puri), type: "toml" }
      case "hbs" : return { data: io.readFileString(options.parentPath + "/" + puri), type: "handlebars" }
      case "json": return { data: io.readFileJSON(options.parentPath + "/" + puri), type: "json" }  
      case "adoc": return { file: options.parentPath + "/" + puri, type: "asciidoc" }            
      default:
        return { file: options.parentPath + "/" + puri }
      }
    })
    args.fns.renderList = _$(args.fns.renderList, "args.fns.renderList").isFunction().default((lst, server, request, options) => {
      if (isDef(options.browse) && !options.browse) return ""
      const uri = request.uri
      const uriPrefix = _$(global.__ojobHttpUriPrefix[String(options.port)], "__ojobHttpUriPrefix1").default(_$(global.__ojobHttpUriPrefix[options.port], "__ojobHttpUriPrefix2").default(""))
      const prefixURL = aURL => {
        aURL = _$(aURL).default("")
        if (aURL == "") return aURL
        aURL = String(aURL)
        if ((/^[a-z]+:/i).test(aURL) || aURL.startsWith("//")) return aURL
        if (!aURL.startsWith("/")) return aURL
        return (uriPrefix + "/" + aURL.replace(/^\/+/, "")).replace(/\/+/g, "/")
      }

      var puri = uri.replace(new RegExp("^" + options.parentURI + "/?"), "").replace(/\/$/, "")
      const relDir = aDepth => (aDepth <= 0 ? "./" : "../".repeat(aDepth))
      const fileLink = aName => encodeURI(aName).replace(/\+/g, "%2B")
      if (!uri.endsWith("/")) {
        const q = isMap(request.params) && Object.keys(request.params).length > 0
                ? "?" + Object.keys(request.params).map(k => encodeURIComponent(k) + "=" + encodeURIComponent(request.params[k])).join("&")
                : ""
        return ow.server.httpd.replyRedirect(server, uri + "/" + q, {})
      }
      var _page = 1
      var _pageSize = 0
      if (isDef(lst.pageInfo)) {
        if (isDef(lst.pageInfo.page)) _page = Number(lst.pageInfo.page)
        if (isDef(lst.pageInfo.pageSize)) _pageSize = Number(lst.pageInfo.pageSize)
      } else {
        if (isDef(request.params.page)) _page = Number(request.params.page)
        //if (isDef(request.params.pageSize)) _pageSize = Number(request.params.pageSize)
      }
      if (!isNumber(_page) || _page <= 0) _page = 1
      if (!isNumber(_pageSize) || _pageSize < 0) _pageSize = 0

      if (isDef(options.default) && lst.list.filter(r => r.values[lst.key] == options.default).length == 1) {
        request.uri = request.uri + "/" + options.default
        return options._fns.renderObj(options._fns.getObj(request, options), server, request, options)
      }

      const breadcrumb = p => {
        if (p == "") return "[/](<./>) [" + (options.showURI ? options.parentURI.replace(/^\//, "") : "") + "](<./>)"
        var parts = p.split("/")
        var b = "[/](<" + relDir(parts.length).replace(/ +/g, "") + ">) [" + (options.showURI ? options.parentURI.replace(/^\//, "") : "") + "](<" + relDir(parts.length).replace(/ +/g, "") + ">)"
        for (var i = 0; i < parts.length; i++) {
          if (i == parts.length - 1) {
            b += (!options.showURI && i == 0 ? "" : " / ") + parts[i] + " "
          } else {
            b += " [" + (!options.showURI && i == 0 ? "" : " / ") + " " + parts[i] + "](<" + relDir(parts.length - i - 1) + ">)"
          }
        }
        return b
      }

      const logo = prefixURL(_$(options.logo, "logo").isString().default("/fonts/openaf_small.png"))
      var content = "## " + breadcrumb( puri ) + "<img style=\"padding-left: 1em;\" align=\"right\" src=\"" + logo + "\">\n\n"

      // Pagination controls (if metadata is provided)
      if (isDef(lst.pageInfo) && isDef(lst.pageInfo.pageSize) && lst.pageInfo.pageSize > 0) {
        var _totalPages = Math.max(1, Math.ceil(lst.pageInfo.total / lst.pageInfo.pageSize))
        if (_totalPages == 1 && _page <= 1) {
          // Don't render pagination for a single page.
        } else {
        var _prev = _page > 1 ? ("?page=" + (_page - 1)) : __
        var _next = (_page < _totalPages) ? ("?page=" + (_page + 1)) : __
        var _pager = "<div style=\"margin: 0.25em 0 0.75em 0; padding-left: 0.5em; font-family: -apple-system, Calibri, DejaVu Sans;\">"
        if (isDef(_prev) && String(_prev).length > 0) {
          _pager += "<a style=\"text-decoration: none; font-weight: 600; color: #a0a0a0;\" onmouseover=\"this.style.color='#707070'\" onmouseout=\"this.style.color='#a0a0a0'\" href=\"" + _prev + "\">&#8592;</a>"
        } else {
          _pager += "<span style=\"color: #a0a0a0;\">&#8592;</span>"
        }
        _pager += "<span style=\"color: #a0a0a0; padding: 0 0.6em;\">|</span>"
        _pager += "<span style=\"color: #a0a0a0; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace; font-size: 0.95em;\">" + _page + " / " + _totalPages + "</span>"
        _pager += "<span style=\"color: #a0a0a0; padding: 0 0.6em;\">|</span>"
        if (isDef(_next) && String(_next).length > 0) {
          _pager += "<a style=\"text-decoration: none; font-weight: 600; color: #a0a0a0;\" onmouseover=\"this.style.color='#707070'\" onmouseout=\"this.style.color='#a0a0a0'\" href=\"" + _next + "\">&#8594;</a>"
        } else {
          _pager += "<span style=\"color: #a0a0a0;\">&#8594;</span>"
        }
        _pager += "</div>\n"
        content += _pager
        }
      }

      content += "|  |" + lst.fields.join(" | ") + " |\n"
      if (lst.alignFields) {
          content += "|---"
          lst.alignFields.forEach((a, i) => {
              if (a == "left") {
                  content += "|:--"
              } else if (a == "right") {
                  content += "|--:"
              } else {
                  content += "|--"
              }
          })
          content += "|\n"

          if (puri != "/" && puri != "") {
            content += "| <span style=\"color: #a0a0a0; font-family: -apple-system, Calibri, DejaVu Sans;\">&#8598;</span> | __[..](<../>)__ | | |\n"
          }

          $from(lst.list).sort("-isDirectory", "values." + lst.key).select(r => {
              content += "|"
              if (r.isDirectory) {
                  content += " <span style=\"color: #a0a0a0; font-family: -apple-system, Calibri, DejaVu Sans;\">&#8600;</span> |"
              } else {
                  content += " <span style=\"font-family: -apple-system, Calibri, DejaVu Sans;\"><a href=\"" + fileLink(r.values[lst.key]) + "?raw=true\" download=\"" + r.values[lst.key].replace(/\+/g, "%2B") + "\">&darr;</a></span> |"
              }
              lst.fields.forEach((f, i) => {
                if (r.isDirectory) {
                    content += " " + (i == 0 ? "__[" + r.values[f] + "](<" + fileLink(r.values[lst.key]) + "/>)__" : r.values[f]) + " |"
                } else {
                    content += " " + (i == 0 ? "[" + r.values[f] + "](<" + fileLink(r.values[lst.key]) + ">)" : r.values[f]) + " |"
                }
              })
              content += "\n"
          })
      }

      // Content
      if (isDef(lst.content)) {
          content += "\n" + lst.content + "\n"
      }
 
      // Footer
      if (isDef(options.footer)) {
          content += "\n" + options.footer + "\n"
      }

      if (options.sortTab) content += "<script src=\"" + prefixURL("/js/mdtablesort.js") + "\"></script>\n"

      return ow.template.parseMD2HTML( content, true )
    })
    args.fns.renderObj = _$(args.fns.renderObj, "args.fns.renderObj").isFunction().default((obj, server, request, options) => {
      const uri = request.uri
      const uriPrefix = _$(global.__ojobHttpUriPrefix[String(options.port)], "__ojobHttpUriPrefix1").default(_$(global.__ojobHttpUriPrefix[options.port], "__ojobHttpUriPrefix2").default(""))
      const prefixURL = aURL => {
        aURL = _$(aURL).default("")
        if (aURL == "") return aURL
        aURL = String(aURL)
        if ((/^[a-z]+:/i).test(aURL) || aURL.startsWith("//")) return aURL
        if (!aURL.startsWith("/")) return aURL
        return (uriPrefix + "/" + aURL.replace(/^\/+/, "")).replace(/\/+/g, "/")
      }

      var puri = uri.replace(new RegExp("^" + options.parentURI + "/?"), "").replace(/\/$/, "")
      const relDir = aDepth => (aDepth <= 0 ? "./" : "../".repeat(aDepth))

      if (request.params.raw == "true") {
        log("Downloading raw file: " + puri)  
        if (isDef(obj.stream)) {
          return server.replyStream(obj.stream, ow.server.httpd.getMimeType(puri))
        }
        if (isDef(obj.file)) {
          return server.replyStream(io.readFileStream(obj.file), ow.server.httpd.getMimeType(puri))
        }
        if (isDef(obj.data)) {
          return server.replyOKJSON(obj.data, ow.server.httpd.getMimeType(puri))
        }
      }

      if (obj.type == "asciidoc" && isDef(getOPackPath("Asciidoc"))) {
        loadLib("asciidoc.js")
        if (isUnDef(obj.file) && isDef(obj.stream)) {
          return  ow.server.httpd.replyAsciidoc(server, obj.stream)
        } else {
          return ow.server.httpd.replyAsciidoc(server, obj.file)
        }
      }

      if (isDef(obj.stream)) {
        return server.replyStream(obj.stream, ow.server.httpd.getMimeType(puri))
      }

      if (isDef(obj.file)) {
        return server.replyStream(io.readFileStream(obj.file), ow.server.httpd.getMimeType(puri))
      }

      if (obj.type == "md") {
        return server.replyOKHTML(ow.template.parseMD2HTML(obj.data, true))
      }

      if (obj.type == "json" && (isUnDef(request.params.parse) || request.params.parse != "false")) {
        return ow.server.httpd.replyJSMap(server, obj.data)
      }

      const breadcrumb = p => {
        if (p == "") return "[/](<./>) [" + (options.showURI ? options.parentURI.replace(/^\//, "") : "") + "](<./>)"
        var parts = p.split("/")
        var b = "[/](<" + relDir(parts.length).replace(/ +/g, "") + ">) [" + (options.showURI ? options.parentURI.replace(/^\//, "") : "") + "](<" + relDir(parts.length).replace(/ +/g, "") + ">)"
        for (var i = 0; i < parts.length; i++) {
          if (i == parts.length - 1) {
            b += (!options.showURI && i == 0 ? "" : " / ") + parts[i] + " "
          } else {
            b += " [" + (!options.showURI && i == 0 ? "" : " / ") + " " + parts[i] + "](<" + relDir(parts.length - i - 1) + ">)"
          }
        }
        return b
      }

      const _downloadcode = `<span><script>
        function downloadText(aFile) {
          var selectedText = document.querySelectorAll("pre")[0].innerText
          const blob = new Blob([selectedText], { type: "text/plain" })
          const url = URL.createObjectURL(blob)
          const a = document.createElement("a")
          a.href = url
          a.download = aFile
          document.body.appendChild(a)
          a.click()
          document.body.removeChild(a)
          URL.revokeObjectURL(url)
        }
      </script></span>`

      if (obj.type == "rawjson") obj.type = "json"

      const logo = prefixURL(_$(options.logo, "logo").isString().default("/fonts/openaf_small.png"))
      var content
      if (obj.type == "raw") {
        content = "## <span style=\"display: flex; justify-content: space-between\"><span>" + breadcrumb( puri ) + "</span><span style=\"display: inline-flex; justify-content: space-between; float: inline-end; align-items: start\"><span onclick=\"history.back()\" onmouseout=\"this.style.textDecoration='none';\" onmouseover=\"this.style.textDecoration='underline';\" style=\"padding-left: 1em; text-decoration: none; cursor: pointer; font-family: -apple-system, Calibri, DejaVu Sans;\"><a href=\"javascript:history.back()\">&larr;</a></span></span></span>\n\n"
        content += String(obj.data)
        content += "\n\n"

        if (isDef(options.footer)) {
          content += "\n" + options.footer + "\n"
        }
      } else {
        content = "## <span style=\"display: flex; justify-content: space-between\"><span>" + breadcrumb( puri ) + "</span><span style=\"display: inline-flex; justify-content: space-between; float: inline-end; align-items: start\"><span onclick=\"history.back()\" onmouseout=\"this.style.textDecoration='none';\" onmouseover=\"this.style.textDecoration='underline';\" style=\"padding-left: 1em; text-decoration: none; cursor: pointer; font-family: -apple-system, Calibri, DejaVu Sans;\"><a href=\"javascript:history.back()\">&larr;</a></span><span onclick=\"downloadText('" + puri.replace(/\/?$/,"").substr(puri.replace(/\/?$/,"").lastIndexOf("/")+1) + "')\" onmouseout=\"this.style.textDecoration='none';\" onmouseover=\"this.style.textDecoration='underline';\" style=\"padding-left: 1em; float: right; text-decoration: none; cursor: pointer; font-family: -apple-system, Calibri, DejaVu Sans;\"><a href=\"javascript:downloadText('" + puri.replace(/\/?$/,"").substr(puri.replace(/\/?$/,"").lastIndexOf("/")+1) + "')\">&darr;</a></span></span></span>\n\n"
        content += "```" + obj.type + "\n"
        content += isMap(obj.data) ? stringify(obj.data) : String(obj.data)
        content += "\n```\n\n"

        if (isDef(options.footer)) {
          content += "\n" + options.footer + "\n"
        }
        content += _downloadcode
      }


      return server.replyOKHTML( ow.template.parseMD2HTML( content, true ) )
    })
    args.fns.renderEmpty = _$(args.fns.renderEmpty, "args.fns.renderEmpty").isFunction().default((request, options) => {
      const uri = request.uri

      var puri = uri.replace(new RegExp("^" + options.parentURI + "/?"), "")

      var content = "# " + (options.showURI ? options.parentURI + "/" : "") + puri + "\n\n"
      content += "*No content found.*\n"

      return ow.template.parseMD2HTML( content, true )
    })

    args.fns.init = _$(args.fns.init, "args.fns.init").isFunction().default(() => {
      // Check the templates provided
      // args.templates.thead = _$(args.templates.thead, "templates.thead")
      //                       .isString()
      //                       .default("## {{{breadcrumb prefix '" + args.uri + "'}}{{extra}}\n")
      // args.templates.tline = _$(args.templates.tline, "templates.tline")
      //                       .isString()
      //                       .default("{{#each this}}| {{#if isDirectory}}<span style=\"color: #a0a0a0;\">&#8600;</span>{{else}}<a href=\"{{encodeURI prefix}}{{encodeURI filepath}}{{encodeURI filename}}?raw=true\" download=\"{{encodeURI realPrefix}}{{encodeURI filepath}}{{encodeURI filename}}\">&darr;</a>{{/if}} | {{#if isDirectory}}__[{{encodeURI realPrefix}}{{escapeMDTable filepath}}{{escapeMDTable filename}}{{escapeMDTable filename}}](<{{encodeURI realPrefix}}{{encodeURI filepath}}{{encodeURI filename}}>)__ | {{fLastModified}} | | {{else}} [{{escapeMDTable filename}}](<{{encodeURI realPrefix}}{{encodeURI filepath}}{{encodeURI filename}}>) | {{fLastModified}} {{/if}} | {{fSize}} | {{size}} | \n{{/each}}")
      // args.templates.tfoot = _$(args.templates.tfoot, "templates.tfoot")
      //                       .isString()
      //                       .default("")
    })
  
    // Add basic helpers
    ow.template.addHelper("encodeURI", encodeURI)
    ow.template.addHelper("escapeMDTable", str => str.replace(/\|/g, "\\|"))

    var _options = args.options
    _options._fns = args.fns
    _options._fns.init()
    if (isUnDef(global.__GBHTTPD)) global.__GBHTTPD = {}

    _options.parentURI  = args.uri
    _options.parentPath = args.path
    _options.port       = args.port
    global.__GBHTTPD[String(args.port) + args.uri] = _options

# ----------------------
# http://127.0.0.1:11224/test?browseUri=/test&path=a/b/destination.txt&action=obj
# http://127.0.0.1:11224/test?browseUri=/test&path=a/b&action=list
#
- name : HTTP Browse API
  deps :
  - HTTP Start Server
  to   : HTTP Service
  typeArgs:
    noLog: false
    shortcut:
      name  : httpdBrowserAPI
      keyArg: port
      args  :
        uri       : uri
        browseUri : browseUri
  help :
   text   : Provides a HTTP API to access getList/getObj for any HTTP Browse generic implementation.
   expects:
   - name: port
     desc: (Number) The port where the server was made available (default is 8091)
   - name: uri
     desc: (String) The URI where the HTTP Browser API will be available.
   - name: browseUri
     desc: (String) The HTTP Browse generic URI to target (can be overridden by request param browseUri)
  check:
    in:
      port      : toNumber.isNumber.default(8091)
      uri       : isString.default("/api/browse")
      browseUri : isString.default(__)
      path      : isString.default("")
  args :
    execURI: | #js
      try {
        var targetUri = args.browseUri
        if (isUnDef(targetUri) || targetUri === "") targetUri = request.params.browseUri
        if (isUnDef(targetUri) || targetUri === "") targetUri = request.params.uri
        if (isUnDef(targetUri) || targetUri === "") {
          return { data: "Missing browseUri", mimetype: "text/plain", status: 400, header: {} }
        }

        var _options = global.__GBHTTPD[String(port) + targetUri]
        if (isUnDef(_options)) {
          return { data: "Unknown browseUri", mimetype: "text/plain", status: 404, header: {} }
        }

        var targetPath = _$(request.params.path).isString().default("")
        var _req = merge({}, request)
        _req.uri = targetUri + (targetPath.length > 0 ? "/" + targetPath.replace(/^\/+/, "") : "")

        var action = _$(request.params.action).isString().default("list")
        if (action == "obj") {
          var _obj = _options._fns.getObj(_req, merge(_options, { _api: true }))
          //if (request.params.raw == "true") {
            if (isDef(_obj.stream)) return server.replyStream(_obj.stream, ow.server.httpd.getMimeType(targetPath))
            if (isDef(_obj.file)) return server.replyStream(io.readFileStream(_obj.file), ow.server.httpd.getMimeType(targetPath))
            if (isDef(_obj.data)) return ow.server.httpd.reply(_obj.data)
          //}
          return ow.server.httpd.reply(_obj)
        }

        var _lst = _options._fns.getList(_req, merge(_options, { _api: true }))
        return ow.server.httpd.reply(_lst)
      } catch(e) {
        logErr(`Error: ${e.message}`)
        return { data: "Internal error", mimetype: "text/plain", status: 500, header: {} }
      }
  exec : | #js
    var _options = args.options
    _options._fns = args.fns
    _options._fns.init()
    if (isUnDef(global.__GBHTTPD)) global.__GBHTTPD = {}

    _options.parentURI  = args.uri
    _options.parentPath = args.path
    _options.port       = args.port
    global.__GBHTTPD[String(args.port) + args.uri] = _options