Update wmts-hidpi, add nicer-api-docs

nicer-api-docs/closure-library/closure/goog/testing/strictmock.js

@@ -0,0 +1,128 @@
+// Copyright 2008 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 This file defines a strict mock implementation.
+ */
+
+goog.provide('goog.testing.StrictMock');
+
+goog.require('goog.array');
+goog.require('goog.testing.Mock');
+
+
+
+/**
+ * This is a mock that verifies that methods are called in the order that they
+ * are specified during the recording phase. Since it verifies order, it
+ * follows 'fail fast' semantics. If it detects a deviation from the
+ * expectations, it will throw an exception and not wait for verify to be
+ * called.
+ * @param {Object} objectToMock The object to mock.
+ * @param {boolean=} opt_mockStaticMethods An optional argument denoting that
+ *     a mock should be constructed from the static functions of a class.
+ * @param {boolean=} opt_createProxy An optional argument denoting that
+ *     a proxy for the target mock should be created.
+ * @constructor
+ * @extends {goog.testing.Mock}
+ */
+goog.testing.StrictMock = function(objectToMock, opt_mockStaticMethods,
+    opt_createProxy) {
+  goog.testing.Mock.call(this, objectToMock, opt_mockStaticMethods,
+      opt_createProxy);
+
+  /**
+   * An array of MockExpectations.
+   * @type {Array.<goog.testing.MockExpectation>}
+   * @private
+   */
+  this.$expectations_ = [];
+};
+goog.inherits(goog.testing.StrictMock, goog.testing.Mock);
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$recordExpectation = function() {
+  this.$expectations_.push(this.$pendingExpectation);
+};
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$recordCall = function(name, args) {
+  if (this.$expectations_.length == 0) {
+    this.$throwCallException(name, args);
+  }
+
+  // If the current expectation has a different name, make sure it was called
+  // enough and then discard it. We're through with it.
+  var currentExpectation = this.$expectations_[0];
+  while (!this.$verifyCall(currentExpectation, name, args)) {
+
+    // This might be an item which has passed its min, and we can now
+    // look past it, or it might be below its min and generate an error.
+    if (currentExpectation.actualCalls < currentExpectation.minCalls) {
+      this.$throwCallException(name, args, currentExpectation);
+    }
+
+    this.$expectations_.shift();
+    if (this.$expectations_.length < 1) {
+      // Nothing left, but this may be a failed attempt to call the previous
+      // item on the list, which may have been between its min and max.
+      this.$throwCallException(name, args, currentExpectation);
+    }
+    currentExpectation = this.$expectations_[0];
+  }
+
+  if (currentExpectation.maxCalls == 0) {
+    this.$throwCallException(name, args);
+  }
+
+  currentExpectation.actualCalls++;
+  // If we hit the max number of calls for this expectation, we're finished
+  // with it.
+  if (currentExpectation.actualCalls == currentExpectation.maxCalls) {
+    this.$expectations_.shift();
+  }
+
+  return this.$do(currentExpectation, args);
+};
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$reset = function() {
+  goog.testing.StrictMock.superClass_.$reset.call(this);
+
+  goog.array.clear(this.$expectations_);
+};
+
+
+/** @override */
+goog.testing.StrictMock.prototype.$verify = function() {
+  goog.testing.StrictMock.superClass_.$verify.call(this);
+
+  while (this.$expectations_.length > 0) {
+    var expectation = this.$expectations_[0];
+    if (expectation.actualCalls < expectation.minCalls) {
+      this.$throwException('Missing a call to ' + expectation.name +
+          '\nExpected: ' + expectation.minCalls + ' but was: ' +
+          expectation.actualCalls);
+
+    } else {
+      // Don't need to check max, that's handled when the call is made
+      this.$expectations_.shift();
+    }
+  }
+};
+
+