closure 1.2.701 → 1.3.0

data/closure-library/closure/goog/debug/formatter.js

@@ -1,314 +0,0 @@
-// Copyright 2006 The Closure Library Authors. All Rights Reserved.
-//
-// 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.
-
-/**
- * @fileoverview Definition of various formatters for logging. Please minimize
- * dependencies this file has on other closure classes as any dependency it
- * takes won't be able to use the logging infrastructure.
- *
- */
-
-goog.provide('goog.debug.Formatter');
-goog.provide('goog.debug.HtmlFormatter');
-goog.provide('goog.debug.TextFormatter');
-
-goog.require('goog.debug.RelativeTimeProvider');
-goog.require('goog.string');
-
-
-
-/**
- * Base class for Formatters. A Formatter is used to format a LogRecord into
- * something that can be displayed to the user.
- *
- * @param {string=} opt_prefix The prefix to place before text records.
- * @constructor
- */
-goog.debug.Formatter = function(opt_prefix) {
-  this.prefix_ = opt_prefix || '';
-
-  /**
-   * A provider that returns the relative start time.
-   * @type {goog.debug.RelativeTimeProvider}
-   * @private
-   */
-  this.startTimeProvider_ =
-      goog.debug.RelativeTimeProvider.getDefaultInstance();
-};
-
-
-/**
- * Whether to show absolute time in the DebugWindow
- * @type {boolean}
- */
-goog.debug.Formatter.prototype.showAbsoluteTime = true;
-
-
-/**
- * Whether to show relative time in the DebugWindow
- * @type {boolean}
- */
-goog.debug.Formatter.prototype.showRelativeTime = true;
-
-
-/**
- * Whether to show the logger name in the DebugWindow
- * @type {boolean}
- */
-goog.debug.Formatter.prototype.showLoggerName = true;
-
-
-/**
- * Whether to show the logger exception text
- * @type {boolean}
- */
-goog.debug.Formatter.prototype.showExceptionText = false;
-
-
-/**
- * Whether to show the severity level
- * @type {boolean}
- */
-goog.debug.Formatter.prototype.showSeverityLevel = false;
-
-
-/**
- * Formats a record
- * @param {goog.debug.LogRecord} logRecord the logRecord to format.
- * @return {string} The formatted string.
- */
-goog.debug.Formatter.prototype.formatRecord = goog.abstractMethod;
-
-
-/**
- * Sets the start time provider. By default, this is the default instance
- * but can be changed.
- * @param {goog.debug.RelativeTimeProvider} provider The provider to use.
- */
-goog.debug.Formatter.prototype.setStartTimeProvider = function(provider) {
-  this.startTimeProvider_ = provider;
-};
-
-
-/**
- * Returns the start time provider. By default, this is the default instance
- * but can be changed.
- * @return {goog.debug.RelativeTimeProvider} The start time provider.
- */
-goog.debug.Formatter.prototype.getStartTimeProvider = function() {
-  return this.startTimeProvider_;
-};
-
-
-/**
- * Resets the start relative time.
- */
-goog.debug.Formatter.prototype.resetRelativeTimeStart = function() {
-  this.startTimeProvider_.reset();
-};
-
-
-/**
- * Returns a string for the time/date of the LogRecord.
- * @param {goog.debug.LogRecord} logRecord The record to get a time stamp for.
- * @return {string} A string representation of the time/date of the LogRecord.
- * @private
- */
-goog.debug.Formatter.getDateTimeStamp_ = function(logRecord) {
-  var time = new Date(logRecord.getMillis());
-  return goog.debug.Formatter.getTwoDigitString_((time.getFullYear() - 2000)) +
-         goog.debug.Formatter.getTwoDigitString_((time.getMonth() + 1)) +
-         goog.debug.Formatter.getTwoDigitString_(time.getDate()) + ' ' +
-         goog.debug.Formatter.getTwoDigitString_(time.getHours()) + ':' +
-         goog.debug.Formatter.getTwoDigitString_(time.getMinutes()) + ':' +
-         goog.debug.Formatter.getTwoDigitString_(time.getSeconds()) + '.' +
-         goog.debug.Formatter.getTwoDigitString_(
-             Math.floor(time.getMilliseconds() / 10));
-};
-
-
-/**
- * Returns the number as a two-digit string, meaning it prepends a 0 if the
- * number if less than 10.
- * @param {number} n The number to format.
- * @return {string} A two-digit string representation of {@code n}.
- * @private
- */
-goog.debug.Formatter.getTwoDigitString_ = function(n) {
-  if (n < 10) {
-    return '0' + n;
-  }
-  return String(n);
-};
-
-
-/**
- * Returns a string for the number of seconds relative to the start time.
- * Prepads with spaces so that anything less than 1000 seconds takes up the
- * same number of characters for better formatting.
- * @param {goog.debug.LogRecord} logRecord The log to compare time to.
- * @param {number} relativeTimeStart The start time to compare to.
- * @return {string} The number of seconds of the LogRecord relative to the
- *     start time.
- * @private
- */
-goog.debug.Formatter.getRelativeTime_ = function(logRecord,
-                                                 relativeTimeStart) {
-  var ms = logRecord.getMillis() - relativeTimeStart;
-  var sec = ms / 1000;
-  var str = sec.toFixed(3);
-
-  var spacesToPrepend = 0;
-  if (sec < 1) {
-    spacesToPrepend = 2;
-  } else {
-    while (sec < 100) {
-      spacesToPrepend++;
-      sec *= 10;
-    }
-  }
-  while (spacesToPrepend-- > 0) {
-    str = ' ' + str;
-  }
-  return str;
-};
-
-
-
-/**
- * Formatter that returns formatted html. See formatRecord for the classes
- * it uses for various types of formatted output.
- *
- * @param {string=} opt_prefix The prefix to place before text records.
- * @constructor
- * @extends {goog.debug.Formatter}
- */
-goog.debug.HtmlFormatter = function(opt_prefix) {
-  goog.debug.Formatter.call(this, opt_prefix);
-};
-goog.inherits(goog.debug.HtmlFormatter, goog.debug.Formatter);
-
-
-/**
- * Whether to show the logger exception text
- * @type {boolean}
- */
-goog.debug.HtmlFormatter.prototype.showExceptionText = true;
-
-
-/**
- * Formats a record
- * @param {goog.debug.LogRecord} logRecord the logRecord to format.
- * @return {string} The formatted string as html.
- */
-goog.debug.HtmlFormatter.prototype.formatRecord = function(logRecord) {
-  var className;
-  switch (logRecord.getLevel().value) {
-    case goog.debug.Logger.Level.SHOUT.value:
-      className = 'dbg-sh';
-      break;
-    case goog.debug.Logger.Level.SEVERE.value:
-      className = 'dbg-sev';
-      break;
-    case goog.debug.Logger.Level.WARNING.value:
-      className = 'dbg-w';
-      break;
-    case goog.debug.Logger.Level.INFO.value:
-      className = 'dbg-i';
-      break;
-    case goog.debug.Logger.Level.FINE.value:
-    default:
-      className = 'dbg-f';
-      break;
-  }
-
-  // Build message html
-  var sb = [];
-  sb.push(this.prefix_, ' ');
-  if (this.showAbsoluteTime) {
-    sb.push('[', goog.debug.Formatter.getDateTimeStamp_(logRecord), '] ');
-  }
-  if (this.showRelativeTime) {
-    sb.push('[',
-        goog.string.whitespaceEscape(
-            goog.debug.Formatter.getRelativeTime_(logRecord,
-                this.startTimeProvider_.get())),
-        's] ');
-  }
-
-  if (this.showLoggerName) {
-    sb.push('[', goog.string.htmlEscape(logRecord.getLoggerName()), '] ');
-  }
-  sb.push('<span class="', className, '">',
-      goog.string.newLineToBr(goog.string.whitespaceEscape(
-          goog.string.htmlEscape(logRecord.getMessage()))));
-
-  if (this.showExceptionText && logRecord.getException()) {
-    sb.push('<br>',
-        goog.string.newLineToBr(goog.string.whitespaceEscape(
-            logRecord.getExceptionText() || '')));
-  }
-  sb.push('</span><br>');
-
-  // If the logger is enabled, open window and write html message to log
-  // otherwise save it
-  return sb.join('');
-};
-
-
-
-/**
- * Formatter that returns formatted plain text
- *
- * @param {string=} opt_prefix The prefix to place before text records.
- * @constructor
- * @extends {goog.debug.Formatter}
- */
-goog.debug.TextFormatter = function(opt_prefix) {
-  goog.debug.Formatter.call(this, opt_prefix);
-};
-goog.inherits(goog.debug.TextFormatter, goog.debug.Formatter);
-
-
-/**
- * Formats a record as text
- * @param {goog.debug.LogRecord} logRecord the logRecord to format.
- * @return {string} The formatted string.
- */
-goog.debug.TextFormatter.prototype.formatRecord = function(logRecord) {
-  // Build message html
-  var sb = [];
-  sb.push(this.prefix_, ' ');
-  if (this.showAbsoluteTime) {
-    sb.push('[', goog.debug.Formatter.getDateTimeStamp_(logRecord), '] ');
-  }
-  if (this.showRelativeTime) {
-    sb.push('[', goog.debug.Formatter.getRelativeTime_(logRecord,
-        this.startTimeProvider_.get()), 's] ');
-  }
-
-  if (this.showLoggerName) {
-    sb.push('[', logRecord.getLoggerName(), '] ');
-  }
-  if (this.showSeverityLevel) {
-    sb.push('[', logRecord.getLevel().name, '] ');
-  }
-  sb.push(logRecord.getMessage(), '\n');
-  if (this.showExceptionText && logRecord.getException()) {
-    sb.push(logRecord.getExceptionText(), '\n');
-  }
-  // If the logger is enabled, open window and write html message to log
-  // otherwise save it
-  return sb.join('');
-};

data/closure-library/closure/goog/debug/gcdiagnostics.js

@@ -1,143 +0,0 @@
-// Copyright 2007 The Closure Library Authors. All Rights Reserved.
-//
-// 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.
-
-/**
- * @fileoverview Definition of the GcDiagnostics class.
- *
- */
-
-goog.provide('goog.debug.GcDiagnostics');
-
-goog.require('goog.debug.Logger');
-goog.require('goog.debug.Trace');
-goog.require('goog.userAgent');
-
-
-
-/**
- * Class used for singleton goog.debug.GcDiagnostics.  Used to hook into
- * the L2 ActiveX controller to profile garbage collection information in IE.
- * Can be used in combination with tracers (goog.debug.Trace), to provide object
- * allocation counts from within the tracers or used alone by invoking start and
- * stop.
- *
- * See http://go/l2binary for the install.
- * TODO(user): Move the L2 installer somewhere more general.
- * @constructor
- * @private
- */
-goog.debug.GcDiagnostics_ = function() {};
-
-
-/**
- * Install the GcDiagnostics tool.
- */
-goog.debug.GcDiagnostics_.prototype.install = function() {
-  if (goog.userAgent.IE) {
-    /** @preserveTry */
-    try {
-      var l2Helper = new ActiveXObject('L2.NativeHelper');
-
-      // If using tracers, use the higher precision timer provided by L2.
-      if (goog.debug.Trace_) {
-        goog.debug.Trace_.now = function() {
-          return l2Helper['getMilliSeconds']();
-        };
-      }
-
-      if (l2Helper['gcTracer']) {
-        l2Helper['gcTracer']['installGcTracing']();
-        this.gcTracer_ = l2Helper['gcTracer'];
-        if (goog.debug.Trace) {
-          // If tracers are in use, register the gcTracer so that per tracer
-          // allocations are recorded.
-          goog.debug.Trace.setGcTracer(this.gcTracer_);
-        }
-      }
-      this.logger_.info('Installed L2 native helper');
-    } catch (e) {
-      this.logger_.info('Failed to install L2 native helper: ' + e);
-    }
-  }
-};
-
-
-/**
- * Logger for the gcDiagnotics
- * @type {goog.debug.Logger}
- * @private
- */
-goog.debug.GcDiagnostics_.prototype.logger_ =
-    goog.debug.Logger.getLogger('goog.debug.GcDiagnostics');
-
-
-/**
- * Starts recording garbage collection information.  If a trace is already in
- * progress, it is ended.
- */
-goog.debug.GcDiagnostics_.prototype.start = function() {
-  if (this.gcTracer_) {
-    if (this.gcTracer_['isTracing']()) {
-      this.gcTracer_['endGcTracing']();
-    }
-    this.gcTracer_['startGcTracing']();
-  }
-};
-
-
-/**
- * Stops recording garbage collection information.  Logs details on the garbage
- * collections that occurred between start and stop.  If tracers are in use,
- * adds comments where each GC occurs.
- */
-goog.debug.GcDiagnostics_.prototype.stop = function() {
-  if (this.gcTracer_ && this.gcTracer_['isTracing']()) {
-    var gcTracer = this.gcTracer_;
-    this.gcTracer_['endGcTracing']();
-
-    var numGCs = gcTracer['getNumTraces']();
-    this.logger_.info('*********GC TRACE*********');
-    this.logger_.info('GC ran ' + numGCs + ' times.');
-    var totalTime = 0;
-    for (var i = 0; i < numGCs; i++) {
-      var trace = gcTracer['getTrace'](i);
-
-      var msStart = trace['gcStartTime'];
-      var msElapsed = trace['gcElapsedTime'];
-
-      var msRounded = Math.round(msElapsed * 10) / 10;
-      var s = 'GC ' + i + ': ' + msRounded + ' ms, ' +
-          'numVValAlloc=' + trace['numVValAlloc'] + ', ' +
-          'numVarAlloc=' + trace['numVarAlloc'] + ', ' +
-          'numBytesSysAlloc=' + trace['numBytesSysAlloc'];
-      if (goog.debug.Trace) {
-        goog.debug.Trace.addComment(s, null, msStart);
-      }
-      this.logger_.info(s);
-      totalTime += msElapsed;
-    }
-    if (goog.debug.Trace) {
-      goog.debug.Trace.addComment('Total GC time was ' + totalTime + ' ms.');
-    }
-    this.logger_.info('Total GC time was ' + totalTime + ' ms.');
-    this.logger_.info('*********GC TRACE*********');
-  }
-};
-
-
-/**
- * Singleton GcDiagnostics object
- * @type {goog.debug.GcDiagnostics_}
- */
-goog.debug.GcDiagnostics = new goog.debug.GcDiagnostics_();

data/closure-library/closure/goog/debug/logbuffer.js

@@ -1,147 +0,0 @@
-// Copyright 2010 The Closure Library Authors. All Rights Reserved.
-//
-// 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.
-
-/**
- * @fileoverview A buffer for log records. The purpose of this is to improve
- * logging performance by re-using old objects when the buffer becomes full and
- * to eliminate the need for each app to implement their own log buffer. The
- * disadvantage to doing this is that log handlers cannot maintain references to
- * log records and expect that they are not overwriten at a later point.
- *
- * @author agrieve@google.com (Andrew Grieve)
- */
-
-goog.provide('goog.debug.LogBuffer');
-
-goog.require('goog.asserts');
-goog.require('goog.debug.LogRecord');
-
-
-
-/**
- * Creates the log buffer.
- * @constructor
- */
-goog.debug.LogBuffer = function() {
-  goog.asserts.assert(goog.debug.LogBuffer.isBufferingEnabled(),
-      'Cannot use goog.debug.LogBuffer without defining ' +
-      'goog.debug.LogBuffer.CAPACITY.');
-  this.clear();
-};
-
-
-/**
- * A static method that always returns the same instance of LogBuffer.
- * @return {!goog.debug.LogBuffer} The LogBuffer singleton instance.
- */
-goog.debug.LogBuffer.getInstance = function() {
-  if (!goog.debug.LogBuffer.instance_) {
-    // This function is written with the return statement after the assignment
-    // to avoid the jscompiler StripCode bug described in http://b/2608064.
-    // After that bug is fixed this can be refactored.
-    goog.debug.LogBuffer.instance_ = new goog.debug.LogBuffer();
-  }
-  return goog.debug.LogBuffer.instance_;
-};
-
-
-/**
- * @define {number} The number of log records to buffer. 0 means disable
- * buffering.
- */
-goog.debug.LogBuffer.CAPACITY = 0;
-
-
-/**
- * The array to store the records.
- * @type {!Array.<!goog.debug.LogRecord|undefined>}
- * @private
- */
-goog.debug.LogBuffer.prototype.buffer_;
-
-
-/**
- * The index of the most recently added record or -1 if there are no records.
- * @type {number}
- * @private
- */
-goog.debug.LogBuffer.prototype.curIndex_;
-
-
-/**
- * Whether the buffer is at capacity.
- * @type {boolean}
- * @private
- */
-goog.debug.LogBuffer.prototype.isFull_;
-
-
-/**
- * Adds a log record to the buffer, possibly overwriting the oldest record.
- * @param {goog.debug.Logger.Level} level One of the level identifiers.
- * @param {string} msg The string message.
- * @param {string} loggerName The name of the source logger.
- * @return {!goog.debug.LogRecord} The log record.
- */
-goog.debug.LogBuffer.prototype.addRecord = function(level, msg, loggerName) {
-  var curIndex = (this.curIndex_ + 1) % goog.debug.LogBuffer.CAPACITY;
-  this.curIndex_ = curIndex;
-  if (this.isFull_) {
-    var ret = this.buffer_[curIndex];
-    ret.reset(level, msg, loggerName);
-    return ret;
-  }
-  this.isFull_ = curIndex == goog.debug.LogBuffer.CAPACITY - 1;
-  return this.buffer_[curIndex] =
-      new goog.debug.LogRecord(level, msg, loggerName);
-};
-
-
-/**
- * @return {boolean} Whether the log buffer is enabled.
- */
-goog.debug.LogBuffer.isBufferingEnabled = function() {
-  return goog.debug.LogBuffer.CAPACITY > 0;
-};
-
-
-/**
- * Removes all buffered log records.
- */
-goog.debug.LogBuffer.prototype.clear = function() {
-  this.buffer_ = new Array(goog.debug.LogBuffer.CAPACITY);
-  this.curIndex_ = -1;
-  this.isFull_ = false;
-};
-
-
-/**
- * Calls the given function for each buffered log record, starting with the
- * oldest one.
- * @param {function(!goog.debug.LogRecord)} func The function to call.
- */
-goog.debug.LogBuffer.prototype.forEachRecord = function(func) {
-  var buffer = this.buffer_;
-  // Corner case: no records.
-  if (!buffer[0]) {
-    return;
-  }
-  var curIndex = this.curIndex_;
-  var i = this.isFull_ ? curIndex : -1;
-  do {
-    i = (i + 1) % goog.debug.LogBuffer.CAPACITY;
-    func(/** @type {!goog.debug.LogRecord} */ (buffer[i]));
-  } while (i != curIndex);
-};
-

data/closure-library/closure/goog/debug/logbuffer_test.html

@@ -1,105 +0,0 @@
-<!DOCTYPE html>
-<html>
-<!--
-Copyright 2010 The Closure Library Authors. All Rights Reserved.
-
-Use of this source code is governed by the Apache License, Version 2.0.
-See the COPYING file for details.
--->
-<head>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<title>Closure Unit Tests - goog.debug.LogBuffer</title>
-<script src="../base.js"></script>
-<script>
-  goog.require('goog.debug.LogRecord');
-  goog.require('goog.debug.LogBuffer');
-  goog.require('goog.debug.Logger');
-  goog.require('goog.testing.jsunit');
-</script>
-</head>
-<body>
-<script>
-
-var DUMMY_LEVELS = [
-    goog.debug.Logger.Level.INFO,
-    goog.debug.Logger.Level.WARNING,
-    goog.debug.Logger.Level.SEVERE];
-var DUMMY_MESSAGES = ['a', 'b', 'c'];
-var DUMMY_NAMES = ['X', 'Y', 'Z'];
-
-var buffer;
-var dummyIndex = 0;
-
-function setUp() {
-  goog.debug.LogBuffer.CAPACITY = 4;
-  goog.debug.LogBuffer.instance_ = null;
-  buffer = goog.debug.LogBuffer.getInstance();
-}
-
-function verifyRecord(expectedIndex, record) {
-  var index = expectedIndex % DUMMY_MESSAGES.length;
-  var message = DUMMY_MESSAGES[index];
-  var level = DUMMY_LEVELS[index];
-  var name = DUMMY_NAMES[index];
-  assertEquals('Wrong level for record ' + expectedIndex, level,
-      record.getLevel());
-  assertEquals('Wrong message for record ' + expectedIndex, message,
-      record.getMessage());
-  assertEquals('Wrong name for record ' + expectedIndex, name,
-      record.getLoggerName());
-}
-
-function addAndVerifyRecord() {
-  var index = dummyIndex % DUMMY_MESSAGES.length;
-  var level = DUMMY_LEVELS[index];
-  var message = DUMMY_MESSAGES[index];
-  var name = DUMMY_NAMES[index];
-  var record = buffer.addRecord(level, message, name);
-  verifyRecord(dummyIndex, record);
-  dummyIndex++;
-}
-
-function addSomeRecords(howMany) {
-  for (var i = 0; i < howMany; i++) {
-    addAndVerifyRecord();
-  }
-}
-
-function testAddRecord() {
-  addSomeRecords(goog.debug.LogBuffer.CAPACITY * 3);
-}
-
-function testIsFull() {
-  assertFalse('Should not be full.', buffer.isFull_);
-  addSomeRecords(goog.debug.LogBuffer.CAPACITY * 1.5);
-  assertTrue('Should be full.', buffer.isFull_);
-  buffer.clear();
-  assertFalse('Should not be full after clear().', buffer.isFull_);
-  addSomeRecords(goog.debug.LogBuffer.CAPACITY - 1);
-  assertFalse('Should not be full but almost full.', buffer.isFull_);
-}
-
-function testForEachRecord() {
-  // Test with it half full.
-  var howMany1 = goog.debug.LogBuffer.CAPACITY / 2;
-  addSomeRecords(howMany1);
-  var counter1 = 0;
-  buffer.forEachRecord(function(record) {
-    verifyRecord(counter1++, record);
-  });
-  assertEquals('Wrong number of records when half full.', howMany1, counter1);
-
-  // Test with it full.
-  var howMany2 = goog.debug.LogBuffer.CAPACITY;
-  addSomeRecords(howMany2);
-  var index = counter1;
-  buffer.forEachRecord(function(record) {
-    verifyRecord(index++, record);
-  });
-  assertEquals('Wrong number of records when full.', howMany1 + howMany2,
-      index);
-}
-
-</script>
-</body>
-</html>