Update wmts-hidpi, add nicer-api-docs

nicer-api-docs/closure-library/closure/goog/storage/mechanism/mechanismsharingtester.js

@@ -0,0 +1,87 @@
+// Copyright 2011 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 Unit tests for storage mechanism sharing.
+ *
+ * These tests should be included in tests of any storage mechanism in which
+ * separate mechanism instances share the same underlying storage. Most (if
+ * not all) storage mechanisms should have this property. If the mechanism
+ * employs namespaces, make sure the same namespace is used for both objects.
+ *
+ */
+
+goog.provide('goog.storage.mechanism.mechanismSharingTester');
+
+goog.require('goog.iter.Iterator');
+goog.require('goog.storage.mechanism.IterableMechanism');
+goog.require('goog.testing.asserts');
+goog.setTestOnly('goog.storage.mechanism.mechanismSharingTester');
+
+
+var mechanism = null;
+var mechanism_shared = null;
+
+
+function testSharedSet() {
+  if (!mechanism || !mechanism_shared) {
+    return;
+  }
+  mechanism.set('first', 'one');
+  assertEquals('one', mechanism_shared.get('first'));
+  assertEquals(1, mechanism_shared.getCount());
+  var iterator = mechanism_shared.__iterator__();
+  assertEquals('one', iterator.next());
+  assertEquals(goog.iter.StopIteration,
+               assertThrows(iterator.next));
+}
+
+
+function testSharedSetInverse() {
+  if (!mechanism || !mechanism_shared) {
+    return;
+  }
+  mechanism_shared.set('first', 'two');
+  assertEquals('two', mechanism.get('first'));
+  assertEquals(1, mechanism.getCount());
+  var iterator = mechanism.__iterator__();
+  assertEquals('two', iterator.next());
+  assertEquals(goog.iter.StopIteration,
+               assertThrows(iterator.next));
+}
+
+
+function testSharedRemove() {
+  if (!mechanism || !mechanism_shared) {
+    return;
+  }
+  mechanism_shared.set('first', 'three');
+  mechanism.remove('first');
+  assertNull(mechanism_shared.get('first'));
+  assertEquals(0, mechanism_shared.getCount());
+  assertEquals(goog.iter.StopIteration,
+               assertThrows(mechanism_shared.__iterator__().next));
+}
+
+
+function testSharedClean() {
+  if (!mechanism || !mechanism_shared) {
+    return;
+  }
+  mechanism.set('first', 'four');
+  mechanism_shared.clear();
+  assertEquals(0, mechanism.getCount());
+  assertEquals(goog.iter.StopIteration,
+               assertThrows(mechanism.__iterator__().next));
+}