/*jslint indent: 2, nomen: true, maxlen: 100, sloppy: true, vars: true, white: true, plusplus: true, nonpropdel: true, proto: true */ /*global require, module, Module, FS_MOVE, FS_REMOVE, FS_EXISTS, FS_IS_DIRECTORY, FS_LIST_TREE, SYS_EXECUTE, SYS_LOAD, SYS_LOG, SYS_LOG_LEVEL, SYS_OUTPUT, SYS_PROCESS_STAT, SYS_READ, SYS_SPRINTF, SYS_TIME, SYS_START_PAGER, SYS_STOP_PAGER, SYS_SHA256, SYS_WAIT, SYS_GETLINE, SYS_PARSE, ARANGO_QUIET, MODULES_PATH, COLOR_OUTPUT, COLOR_OUTPUT_RESET, COLOR_BRIGHT, COLOR_BLACK, COLOR_BOLD_BLACK, COLOR_BLINK, COLOR_BLUE, COLOR_BOLD_BLUE, COLOR_BOLD_GREEN, COLOR_RED, COLOR_BOLD_RED, COLOR_GREEN, COLOR_WHITE, COLOR_BOLD_WHITE, COLOR_YELLOW, COLOR_BOLD_YELLOW, PRETTY_PRINT */ //////////////////////////////////////////////////////////////////////////////// /// @brief module "internal" /// /// @file /// /// DISCLAIMER /// /// Copyright 2010-2013 triagens GmbH, Cologne, Germany /// /// Licensed under the Apache License, Version 2.0 (the "License"); /// you may not use this file except in compliance with the License. /// You may obtain a copy of the License at /// /// http://www.apache.org/licenses/LICENSE-2.0 /// /// Unless required by applicable law or agreed to in writing, software /// distributed under the License is distributed on an "AS IS" BASIS, /// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. /// See the License for the specific language governing permissions and /// limitations under the License. /// /// Copyright holder is triAGENS GmbH, Cologne, Germany /// /// @author Dr. Frank Celler /// @author Copyright 2010-2013, triAGENS GmbH, Cologne, Germany //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- Module "internal" // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup V8ModuleInternal /// @{ //////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////// /// @brief internal module //////////////////////////////////////////////////////////////////////////////// (function () { var internal = Module.prototype.ModuleCache["/internal"].exports; // system functions if (typeof SYS_EXECUTE !== "undefined") { internal.execute = SYS_EXECUTE; delete SYS_EXECUTE; } if (typeof SYS_GETLINE !== "undefined") { internal.getline = SYS_GETLINE; delete SYS_GETLINE; } if (typeof SYS_LOAD !== "undefined") { internal.load = SYS_LOAD; delete SYS_LOAD; } if (typeof SYS_LOG !== "undefined") { internal.log = SYS_LOG; delete SYS_LOG; } if (typeof SYS_LOG_LEVEL !== "undefined") { internal.logLevel = SYS_LOG_LEVEL; delete SYS_LOG_LEVEL; } if (typeof SYS_OUTPUT !== "undefined") { internal.output = SYS_OUTPUT; delete SYS_OUTPUT; } if (typeof SYS_PARSE !== "undefined") { internal.parse= SYS_PARSE; delete SYS_PARSE; } if (typeof SYS_PROCESS_STAT !== "undefined") { internal.processStat = SYS_PROCESS_STAT; delete SYS_PROCESS_STAT; } if (typeof SYS_READ !== "undefined") { internal.read = SYS_READ; delete SYS_READ; } if (typeof SYS_SHA256 !== "undefined") { internal.sha256 = SYS_SHA256; delete SYS_SHA256; } if (typeof SYS_SPRINTF !== "undefined") { internal.sprintf = SYS_SPRINTF; delete SYS_SPRINTF; } if (typeof SYS_TIME !== "undefined") { internal.time = SYS_TIME; delete SYS_TIME; } if (typeof SYS_WAIT !== "undefined") { internal.wait = SYS_WAIT; delete SYS_WAIT; } if (typeof FS_EXISTS !== "undefined") { internal.exists = FS_EXISTS; delete FS_EXISTS; } if (typeof FS_IS_DIRECTORY !== "undefined") { internal.isDirectory = FS_IS_DIRECTORY; delete FS_IS_DIRECTORY; } if (typeof FS_LIST_TREE !== "undefined") { internal.listTree = FS_LIST_TREE; delete FS_LIST_TREE; } if (typeof FS_MOVE !== "undefined") { internal.move = FS_MOVE; delete FS_MOVE; } if (typeof FS_REMOVE !== "undefined") { internal.remove = FS_REMOVE; delete FS_REMOVE; } //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- public constants // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup V8ModuleInternal /// @{ //////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////// /// @brief modules path //////////////////////////////////////////////////////////////////////////////// internal.MODULES_PATH = ""; if (typeof MODULES_PATH !== "undefined") { internal.MODULES_PATH = MODULES_PATH; delete MODULES_PATH; } //////////////////////////////////////////////////////////////////////////////// /// @brief quiet flag //////////////////////////////////////////////////////////////////////////////// internal.ARANGO_QUIET = false; //////////////////////////////////////////////////////////////////////////////// /// @brief pretty print flag //////////////////////////////////////////////////////////////////////////////// internal.PRETTY_PRINT = false; if (typeof PRETTY_PRINT !== "undefined") { internal.PRETTY_PRINT = PRETTY_PRINT; delete PRETTY_PRINT; } //////////////////////////////////////////////////////////////////////////////// /// @brief color constants //////////////////////////////////////////////////////////////////////////////// internal.COLOR_OUTPUT = false; internal.COLOR_OUTPUT_DEFAULT = ""; internal.COLOR_OUTPUT_RESET = ""; internal.COLOR_BRIGHT = ""; if (typeof COLOR_OUTPUT !== "undefined") { internal.COLOR_OUTPUT = COLOR_OUTPUT; delete COLOR_OUTPUT; } if (typeof COLOR_OUTPUT_RESET !== "undefined") { internal.COLOR_OUTPUT_RESET = COLOR_OUTPUT_RESET; delete COLOR_OUTPUT_RESET; } if (typeof COLOR_BRIGHT !== "undefined") { internal.COLOR_BRIGHT = COLOR_BRIGHT; delete COLOR_BRIGHT; } if (internal.COLOR_OUTPUT) { internal.COLOR_OUTPUT_DEFAULT = internal.COLOR_BRIGHT; internal.COLOR_BLACK = COLOR_BLACK; delete COLOR_BLACK; internal.COLOR_BOLD_BLACK = COLOR_BOLD_BLACK; delete COLOR_BOLD_BLACK; internal.COLOR_BLINK = COLOR_BLINK; delete COLOR_BLINK; internal.COLOR_BLUE = COLOR_BLUE; delete COLOR_BLUE; internal.COLOR_BOLD_BLUE = COLOR_BOLD_BLUE; delete COLOR_BOLD_BLUE; internal.COLOR_GREEN = COLOR_GREEN; delete COLOR_GREEN; internal.COLOR_BOLD_GREEN = COLOR_BOLD_GREEN; delete COLOR_BOLD_GREEN; internal.COLOR_RED = COLOR_RED; delete COLOR_RED; internal.COLOR_BOLD_RED = COLOR_BOLD_RED; delete COLOR_BOLD_RED; internal.COLOR_WHITE = COLOR_WHITE; delete COLOR_WHITE; internal.COLOR_BOLD_WHITE = COLOR_BOLD_WHITE; delete COLOR_BOLD_WHITE; internal.COLOR_YELLOW = COLOR_YELLOW; delete COLOR_YELLOW; internal.COLOR_BOLD_YELLOW = COLOR_BOLD_YELLOW; delete COLOR_BOLD_YELLOW; } //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- private functions // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup V8ModuleInternal /// @{ //////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////// /// @brief prints objects to standard output /// /// @FUN{internal.printShell(@FA{arg1}, @FA{arg2}, @FA{arg3}, ...)} /// /// Only available in shell mode. /// /// Prints the arguments. If an argument is an object having a /// function @FN{_PRINT}, then this function is called. Otherwise @FN{toJson} is /// used. A final newline is printed /// /// @verbinclude fluent40 //////////////////////////////////////////////////////////////////////////////// internal.printShell = function () { var i; for (i = 0; i < arguments.length; ++i) { if (0 < i) { internal.output(" "); } if (typeof(arguments[i]) === "string") { internal.output(arguments[i]); } else { internal.printRecursive(arguments[i], [], "~", [], 0); } } if (internal.COLOR_OUTPUT) { internal.output(internal.COLOR_OUTPUT_DEFAULT); internal.output(internal.COLOR_OUTPUT_RESET); } internal.output("\n"); }; //////////////////////////////////////////////////////////////////////////////// /// @brief quote cache //////////////////////////////////////////////////////////////////////////////// internal.characterQuoteCache = { '\b': '\\b', // ASCII 8, Backspace '\t': '\\t', // ASCII 9, Tab '\n': '\\n', // ASCII 10, Newline '\f': '\\f', // ASCII 12, Formfeed '\r': '\\r', // ASCII 13, Carriage Return '\"': '\\"', '\\': '\\\\' }; //////////////////////////////////////////////////////////////////////////////// /// @brief quotes a single character //////////////////////////////////////////////////////////////////////////////// internal.quoteSingleJsonCharacter = function (c) { if (internal.characterQuoteCache.hasOwnProperty[c]) { return internal.characterQuoteCache[c]; } var charCode = c.charCodeAt(0); var result; if (charCode < 16) { result = '\\u000'; } else if (charCode < 256) { result = '\\u00'; } else if (charCode < 4096) { result = '\\u0'; } else { result = '\\u'; } result += charCode.toString(16); internal.characterQuoteCache[c] = result; return result; }; //////////////////////////////////////////////////////////////////////////////// /// @brief quotes a string character //////////////////////////////////////////////////////////////////////////////// internal.quoteJsonString = function (str) { var quotable = /[\\\"\x00-\x1f]/g; return '"' + str.replace(quotable, internal.quoteSingleJsonCharacter) + '"'; }; //////////////////////////////////////////////////////////////////////////////// /// @brief prints objects to standard output without a new-line //////////////////////////////////////////////////////////////////////////////// internal.printRecursive = function (value, seen, path, names, level) { var p; if (seen === undefined) { seen = []; names = []; } p = seen.indexOf(value); if (0 <= p) { internal.output(names[p]); } else { if (value instanceof Object) { seen.push(value); names.push(path); } if (value instanceof Object) { if (typeof value._PRINT === "function") { value._PRINT(seen, path, names, level); } else if (value instanceof Array) { internal.printArray(value, seen, path, names, level); } else if (value.__proto__ === Object.prototype) { internal.printObject(value, seen, path, names, level); } else if (typeof value.toString === "function") { internal.output(value.toString()); } else { internal.printObject(value, seen, path, names, level); } } else if (value === undefined) { internal.output("undefined"); } else { if (typeof(value) === "string") { internal.output(internal.quoteJsonString(value)); } else { internal.output(String(value)); } } } }; //////////////////////////////////////////////////////////////////////////////// /// @brief JSON representation of an array //////////////////////////////////////////////////////////////////////////////// internal.printArray = function (object, seen, path, names, level) { if (object.length === 0) { internal.output("[ ]"); } else { var i; var sep = ""; internal.output("["); var newLevel = level + 1; for (i = 0; i < object.length; i++) { internal.output(sep); internal.printIndent(newLevel); internal.printRecursive(object[i], seen, path + "[" + i + "]", names, newLevel); sep = ", "; } if (object.length > 1) { internal.output(" "); } internal.printIndent(level); internal.output("]"); } }; //////////////////////////////////////////////////////////////////////////////// /// @brief prints an object //////////////////////////////////////////////////////////////////////////////// internal.printObject = function (object, seen, path, names, level) { var sep = " "; var k; internal.output("{"); var newLevel = level + 1; for (k in object) { if (object.hasOwnProperty(k)) { var val = object[k]; internal.output(sep); internal.printIndent(newLevel); if (internal.COLOR_OUTPUT) { internal.output(internal.COLOR_OUTPUT_DEFAULT); internal.output(internal.quoteJsonString(k)); internal.output(internal.COLOR_OUTPUT_RESET); internal.output(" : "); } else { internal.output(internal.quoteJsonString(k), " : "); } internal.printRecursive(val, seen, path + "[" + k + "]", names, newLevel); sep = ", "; } } if (sep === ", ") { internal.output(" "); } internal.printIndent(level); internal.output("}"); }; //////////////////////////////////////////////////////////////////////////////// /// @brief prints the ident for pretty printing //////////////////////////////////////////////////////////////////////////////// internal.printIndent = function (level) { var j; if (internal.PRETTY_PRINT) { internal.output("\n"); for (j = 0; j < level; ++j) { internal.output(" "); } } }; //////////////////////////////////////////////////////////////////////////////// /// @brief flushes the module cache //////////////////////////////////////////////////////////////////////////////// internal.flushModuleCache = function() { module.unloadAll(); }; //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- public methods // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup V8ModuleInternal /// @{ //////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////// /// @brief global print //////////////////////////////////////////////////////////////////////////////// internal.print = internal.printShell; if (typeof internal.printBrowser === "function") { internal.print = internal.printBrowser; } //////////////////////////////////////////////////////////////////////////////// /// @brief global print //////////////////////////////////////////////////////////////////////////////// internal.printf = function () { var text = internal.sprintf.apply(internal.springf, arguments); internal.output(text); } //////////////////////////////////////////////////////////////////////////////// /// @brief start pager //////////////////////////////////////////////////////////////////////////////// internal.start_pager = function () {}; if (typeof SYS_START_PAGER !== "undefined") { internal.start_pager = SYS_START_PAGER; delete SYS_START_PAGER; } //////////////////////////////////////////////////////////////////////////////// /// @brief stop pager //////////////////////////////////////////////////////////////////////////////// internal.stop_pager = function () {}; if (typeof SYS_STOP_PAGER !== "undefined") { internal.stop_pager = SYS_STOP_PAGER; delete SYS_STOP_PAGER; } //////////////////////////////////////////////////////////////////////////////// /// @brief encode password using SHA256 //////////////////////////////////////////////////////////////////////////////// internal.encodePassword = function (password) { var salt; var encoded; salt = internal.sha256("time:" + internal.time()); salt = salt.substr(0,8); encoded = "$1$" + salt + "$" + internal.sha256(salt + password); return encoded; }; //////////////////////////////////////////////////////////////////////////////// /// @brief extends a prototype //////////////////////////////////////////////////////////////////////////////// internal.extend = function (target, source) { Object.getOwnPropertyNames(source) .forEach(function(propName) { Object.defineProperty(target, propName, Object.getOwnPropertyDescriptor(source, propName)); }); return target; }; //////////////////////////////////////////////////////////////////////////////// /// @brief reads a file from the module path or the database //////////////////////////////////////////////////////////////////////////////// internal.loadDatabaseFile = function (path) { var i; var mc; var n; // try to load the file var paths = internal.MODULES_PATH; for (i = 0; i < paths.length; ++i) { var p = paths[i]; if (p === "") { n = "." + path + ".js"; } else { n = p + "/" + path + ".js"; } if (internal.exists(n)) { Module.prototype.ModuleExistsCache[path] = true; return { path : n, content : internal.read(n) }; } } // try to load the module from the database if (internal.db !== undefined) { mc = internal.db._collection("_modules"); if (mc !== null && typeof mc.firstExample === "function") { n = mc.firstExample({ path: path }); if (n !== null) { if (n.hasOwnProperty('content')) { Module.prototype.ModuleExistsCache[path] = true; return { path : "_collection/" + path, content : n.content }; } if (Module.prototype.ModuleExistsCache.hasOwnProperty("/console")) { var console = Module.prototype.ModuleExistsCache["/console"]; console.error("found empty content in '%s'", JSON.stringify(n)); } } } } Module.prototype.ModuleExistsCache[path] = false; throw "cannot find a file named '" + path + "' using the module path(s) '" + internal.MODULES_PATH + "'"; }; //////////////////////////////////////////////////////////////////////////////// /// @brief loads a file from the file-system //////////////////////////////////////////////////////////////////////////////// internal.loadFile = function (path) { var i; // try to load the file var paths = internal.MODULES_PATH; for (i = 0; i < paths.length; ++i) { var p = paths[i]; var n; if (p === "") { n = "." + path + ".js"; } else { n = p + "/" + path + ".js"; } if (internal.exists(n)) { return internal.load(n); } } throw "cannot find a file named '" + path + "' using the module path(s) '" + internal.MODULES_PATH + "'"; }; //////////////////////////////////////////////////////////////////////////////// /// @brief defines a module //////////////////////////////////////////////////////////////////////////////// internal.defineModule = function (path, file) { var content; var m; var mc; content = internal.read(file); mc = internal.db._collection("_modules"); if (mc === null) { mc = internal.db._create("_modules", { isSystem: true }); } path = module.normalise(path); m = mc.firstExample({ path: path }); if (m === null) { mc.save({ path: path, content: content }); } else { mc.replace(m, { path: path, content: content }); } }; //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// }()); // ----------------------------------------------------------------------------- // --SECTION-- END-OF-FILE // ----------------------------------------------------------------------------- // Local Variables: // mode: outline-minor // outline-regexp: "^\\(/// @brief\\|/// @addtogroup\\|// --SECTION--\\|/// @page\\|/// @}\\)" // End: