Proyectos de Subversion Moodle

// Copyright (c) 2013 Tim Perry

//

// Permission is hereby granted, free of charge, to any person

// obtaining a copy of this software and associated documentation

// files (the "Software"), to deal in the Software without

// restriction, including without limitation the rights to use,

// copy, modify, merge, publish, distribute, sublicense, and/or sell

// copies of the Software, and to permit persons to whom the

// Software is furnished to do so, subject to the following

// conditions:

//

// The above copyright notice and this permission notice shall be

// included in all copies or substantial portions of the Software.

//

// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES

// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

// OTHER DEALINGS IN THE SOFTWARE.

// Description of import into Moodle:

// Download from https://github.com/pimterry/loglevel/tree/main/dist

// Copy loglevel.js into lib/amd/src/ in Moodle folder, and use grunt to build the code

// Add the license as a comment to the file and these instructions.

/*! loglevel - v1.9.2 - https://github.com/pimterry/loglevel - (c) 2024 Tim Perry - licensed MIT */

(function (root, definition) {

    "use strict";

    if (typeof define === 'function' && define.amd) {

        define(definition);

    } else if (typeof module === 'object' && module.exports) {

        module.exports = definition();

    } else {

        root.log = definition();

    }

}(this, function () {

    "use strict";

    // Slightly dubious tricks to cut down minimized file size

    var noop = function() {};

    var undefinedType = "undefined";

    var isIE = (typeof window !== undefinedType) && (typeof window.navigator !== undefinedType) && (

        /Trident\/|MSIE /.test(window.navigator.userAgent)

    );

    var logMethods = [

        "trace",

        "debug",

        "info",

        "warn",

        "error"

    ];

    var _loggersByName = {};

    var defaultLogger = null;

    // Cross-browser bind equivalent that works at least back to IE6

    function bindMethod(obj, methodName) {

        var method = obj[methodName];

        if (typeof method.bind === 'function') {

            return method.bind(obj);

        } else {

            try {

                return Function.prototype.bind.call(method, obj);

            } catch (e) {

                // Missing bind shim or IE8 + Modernizr, fallback to wrapping

                return function() {

                    return Function.prototype.apply.apply(method, [obj, arguments]);

                };

            }

        }

    }

    // Trace() doesn't print the message in IE, so for that case we need to wrap it

    function traceForIE() {

        if (console.log) {

            if (console.log.apply) {

                console.log.apply(console, arguments);

            } else {

                // In old IE, native console methods themselves don't have apply().

                Function.prototype.apply.apply(console.log, [console, arguments]);

            }

        }

        if (console.trace) console.trace();

    }

    // Build the best logging method possible for this env

    // Wherever possible we want to bind, not wrap, to preserve stack traces

    function realMethod(methodName) {

        if (methodName === 'debug') {

            methodName = 'log';

        }

        if (typeof console === undefinedType) {

            return false; // No method possible, for now - fixed later by enableLoggingWhenConsoleArrives

        } else if (methodName === 'trace' && isIE) {

            return traceForIE;

        } else if (console[methodName] !== undefined) {

            return bindMethod(console, methodName);

        } else if (console.log !== undefined) {

            return bindMethod(console, 'log');

        } else {

            return noop;

        }

    }

    // These private functions always need `this` to be set properly

    function replaceLoggingMethods() {

        /*jshint validthis:true */

        var level = this.getLevel();

        // Replace the actual methods.

        for (var i = 0; i < logMethods.length; i++) {

            var methodName = logMethods[i];

            this[methodName] = (i < level) ?

                noop :

                this.methodFactory(methodName, level, this.name);

        }

        // Define log.log as an alias for log.debug

        this.log = this.debug;

        // Return any important warnings.

        if (typeof console === undefinedType && level < this.levels.SILENT) {

            return "No console available for logging";

        }

    }

    // In old IE versions, the console isn't present until you first open it.

    // We build realMethod() replacements here that regenerate logging methods

    function enableLoggingWhenConsoleArrives(methodName) {

        return function () {

            if (typeof console !== undefinedType) {

                replaceLoggingMethods.call(this);

                this[methodName].apply(this, arguments);

            }

        };

    }

    // By default, we use closely bound real methods wherever possible, and

    // otherwise we wait for a console to appear, and then try again.

    function defaultMethodFactory(methodName, _level, _loggerName) {

        /*jshint validthis:true */

        return realMethod(methodName) ||

               enableLoggingWhenConsoleArrives.apply(this, arguments);

    }

    function Logger(name, factory) {

      // Private instance variables.

      var self = this;

      /**

       * The level inherited from a parent logger (or a global default). We

       * cache this here rather than delegating to the parent so that it stays

       * in sync with the actual logging methods that we have installed (the

       * parent could change levels but we might not have rebuilt the loggers

       * in this child yet).

       * @type {number}

       */

      var inheritedLevel;

      /**

       * The default level for this logger, if any. If set, this overrides

       * `inheritedLevel`.

       * @type {number|null}

       */

      var defaultLevel;

      /**

       * A user-specific level for this logger. If set, this overrides

       * `defaultLevel`.

       * @type {number|null}

       */

      var userLevel;

      var storageKey = "loglevel";

      if (typeof name === "string") {

        storageKey += ":" + name;

      } else if (typeof name === "symbol") {

        storageKey = undefined;

      }

      function persistLevelIfPossible(levelNum) {

          var levelName = (logMethods[levelNum] || 'silent').toUpperCase();

          if (typeof window === undefinedType || !storageKey) return;

          // Use localStorage if available

          try {

              window.localStorage[storageKey] = levelName;

              return;

          } catch (ignore) {}

          // Use session cookie as fallback

          try {

              window.document.cookie =

                encodeURIComponent(storageKey) + "=" + levelName + ";";

          } catch (ignore) {}

      }

      function getPersistedLevel() {

          var storedLevel;

          if (typeof window === undefinedType || !storageKey) return;

          try {

              storedLevel = window.localStorage[storageKey];

          } catch (ignore) {}

          // Fallback to cookies if local storage gives us nothing

          if (typeof storedLevel === undefinedType) {

              try {

                  var cookie = window.document.cookie;

                  var cookieName = encodeURIComponent(storageKey);

                  var location = cookie.indexOf(cookieName + "=");

                  if (location !== -1) {

                      storedLevel = /^([^;]+)/.exec(

                          cookie.slice(location + cookieName.length + 1)

                      )[1];

                  }

              } catch (ignore) {}

          }

          // If the stored level is not valid, treat it as if nothing was stored.

          if (self.levels[storedLevel] === undefined) {

              storedLevel = undefined;

          }

          return storedLevel;

      }

      function clearPersistedLevel() {

          if (typeof window === undefinedType || !storageKey) return;

          // Use localStorage if available

          try {

              window.localStorage.removeItem(storageKey);

          } catch (ignore) {}

          // Use session cookie as fallback

          try {

              window.document.cookie =

                encodeURIComponent(storageKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 UTC";

          } catch (ignore) {}

      }

      function normalizeLevel(input) {

          var level = input;

          if (typeof level === "string" && self.levels[level.toUpperCase()] !== undefined) {

              level = self.levels[level.toUpperCase()];

          }

          if (typeof level === "number" && level >= 0 && level <= self.levels.SILENT) {

              return level;

          } else {

              throw new TypeError("log.setLevel() called with invalid level: " + input);

          }

      }

      /*

       *

       * Public logger API - see https://github.com/pimterry/loglevel for details

       *

       */

      self.name = name;

      self.levels = { "TRACE": 0, "DEBUG": 1, "INFO": 2, "WARN": 3,

          "ERROR": 4, "SILENT": 5};

      self.methodFactory = factory || defaultMethodFactory;

      self.getLevel = function () {

          if (userLevel != null) {

            return userLevel;

          } else if (defaultLevel != null) {

            return defaultLevel;

          } else {

            return inheritedLevel;

          }

      };

      self.setLevel = function (level, persist) {

          userLevel = normalizeLevel(level);

          if (persist !== false) {  // defaults to true

              persistLevelIfPossible(userLevel);

          }

          // NOTE: in v2, this should call rebuild(), which updates children.

          return replaceLoggingMethods.call(self);

      };

      self.setDefaultLevel = function (level) {

          defaultLevel = normalizeLevel(level);

          if (!getPersistedLevel()) {

              self.setLevel(level, false);

          }

      };

      self.resetLevel = function () {

          userLevel = null;

          clearPersistedLevel();

          replaceLoggingMethods.call(self);

      };

      self.enableAll = function(persist) {

          self.setLevel(self.levels.TRACE, persist);

      };

      self.disableAll = function(persist) {

          self.setLevel(self.levels.SILENT, persist);

      };

      self.rebuild = function () {

          if (defaultLogger !== self) {

              inheritedLevel = normalizeLevel(defaultLogger.getLevel());

          }

          replaceLoggingMethods.call(self);

          if (defaultLogger === self) {

              for (var childName in _loggersByName) {

                _loggersByName[childName].rebuild();

              }

          }

      };

      // Initialize all the internal levels.

      inheritedLevel = normalizeLevel(

          defaultLogger ? defaultLogger.getLevel() : "WARN"

      );

      var initialLevel = getPersistedLevel();

      if (initialLevel != null) {

          userLevel = normalizeLevel(initialLevel);

      }

      replaceLoggingMethods.call(self);

    }

    /*

     *

     * Top-level API

     *

     */

    defaultLogger = new Logger();

    defaultLogger.getLogger = function getLogger(name) {

        if ((typeof name !== "symbol" && typeof name !== "string") || name === "") {

            throw new TypeError("You must supply a name when creating a logger.");

        }

        var logger = _loggersByName[name];

        if (!logger) {

            logger = _loggersByName[name] = new Logger(

                name,

                defaultLogger.methodFactory

            );

        }

        return logger;

    };

    // Grab the current global log variable in case of overwrite

    var _log = (typeof window !== undefinedType) ? window.log : undefined;

    defaultLogger.noConflict = function() {

        if (typeof window !== undefinedType &&

               window.log === defaultLogger) {

            window.log = _log;

        }

        return defaultLogger;

    };

    defaultLogger.getLoggers = function getLoggers() {

        return _loggersByName;

    };

    // ES6 default export, for compatibility

    defaultLogger['default'] = defaultLogger;

    return defaultLogger;

}));