Dynamically generate a heading for Extension Docs API pages

chrome/common/extensions/docs/server2/availability_data_source_test.py

+#!/usr/bin/env python
+# Copyright (c) 2013 The Chromium Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+import json
+import os
+import unittest
+
+from availability_data_source import AvailabilityDataSource
+from caching_file_system import CachingFileSystem
+from object_store_creator import ObjectStoreCreator
+from test_file_system import TestFileSystem
+
+def _LoadJson(name, mode='rb'):
+  return json.load(
+      open(os.path.join('test_data', 'availability_data_source', name), mode))
+
+def _CreateSvnFileSystem(branch):
+  return TestFileSystem(_LoadJson('test_avail_file_system.json')[branch])
+
+class _FakeChromeVersionUtility(object):
+  def GetLatestVersionNumber(self):
+    return '27'
+
+  def GetBranchNumberForVersion(self, version_number):
+    return _LoadJson('test_avail_branch_list.json')[version_number]
+
+class AvailabilityDataSourceTest(unittest.TestCase):
+  def setUp(self):
+    self._avail_ds_factory = AvailabilityDataSource.Factory(
+        _FakeChromeVersionUtility(),
+        ObjectStoreCreator.ForTest(),
+        _CreateSvnFileSystem)
+    self._avail_ds = self._avail_ds_factory.Create()
+    self._avail_ds._existing_availabilities = {'earlyAPI' : '10'}
+    self._avail_ds._permission_apis = ['alarms', 'bookmarks', 'cookies']
+    self._avail_ds._manifest_apis = ['storage', 'runtime']
+    self._avail_ds._orphan_apis = ['idle', 'menus', 'tabs', 'windows']
+
+  def testCheckFileSystemExistence(self):
+    self.assertEquals(True,
+        self._avail_ds._CheckFileSystemExistence('tabs', '20'))

[not at google - send to devlin, 2013/05/13 21:26:41]

The way that GetAvailability is implemented is irrelevant - e.g. don't test the
private methods. Just test the single public method, but choose test cases that
would need to trigger each code path (e.g. commands API for manifest, bluetooth
for permissions, etc etc).

+    self.assertEquals(True,
+        self._avail_ds._CheckFileSystemExistence('tabs', '19'))
+    self.assertEquals(True,
+        self._avail_ds._CheckFileSystemExistence('tabs', '18'))
+    self.assertEquals(False,
+        self._avail_ds._CheckFileSystemExistence('windows', '22'))
+    self.assertEquals(True,
+        self._avail_ds._CheckFileSystemExistence('windows', '24'))
+
+  def testCheckManifestExistence(self):
+    self.assertEquals(True,
+        self._avail_ds._CheckManifestExistence('storage', '27'))
+    self.assertEquals(False,
+        self._avail_ds._CheckManifestExistence('storage', '26'))
+    self.assertEquals(True,
+        self._avail_ds._CheckManifestExistence('runtime', '21'))
+    self.assertEquals(False,
+        self._avail_ds._CheckManifestExistence('runtime', '20'))
+    self.assertEquals(False,
+        self._avail_ds._CheckManifestExistence('cookies', '27'))
+
+  def testCheckPermissionExistence(self):
+    self.assertEquals(False,
+        self._avail_ds._CheckStablePermissionExistence('cookies', '27'))
+    self.assertEquals(True,
+        self._avail_ds._CheckStablePermissionExistence('alarms', '24'))
+    self.assertEquals(False,
+        self._avail_ds._CheckStablePermissionExistence('alarms', '23'))
+    self.assertEquals(True,
+        self._avail_ds._CheckStablePermissionExistence('bookmarks', '21'))
+    self.assertEquals(False,
+        self._avail_ds._CheckStablePermissionExistence('bookmarks', '20'))
+
+  def testCheckExtensionAPIExistence(self):
+    self.assertEquals(True,
+        self._avail_ds._CheckExtensionAPIExistence('idle', '17'))
+    self.assertEquals(True,
+        self._avail_ds._CheckExtensionAPIExistence('idle', '12'))
+    self.assertEquals(True,
+        self._avail_ds._CheckExtensionAPIExistence('idle', '5'))
+    self.assertEquals(True,
+        self._avail_ds._CheckExtensionAPIExistence('menus', '6'))
+    self.assertEquals(False,
+        self._avail_ds._CheckExtensionAPIExistence('menus', '5'))
+
+  def testFindEarliestStableAvailability(self):
+    self.assertEquals('18',
+        self._avail_ds._FindEarliestStableAvailability('tabs', 27))
+    self.assertEquals('24',
+        self._avail_ds._FindEarliestStableAvailability('alarms', 27))
+    self.assertEquals('23',
+        self._avail_ds._FindEarliestStableAvailability('windows', 27))
+    self.assertEquals('27',
+        self._avail_ds._FindEarliestStableAvailability('storage', 27))
+    self.assertEquals('6',
+        self._avail_ds._FindEarliestStableAvailability('menus', 27))
+    self.assertEquals('5',
+        self._avail_ds._FindEarliestStableAvailability('idle', 27))
+
+  def testGetAvailability(self):
+    self.assertEquals('10',

[not at google - send to devlin, 2013/05/13 21:26:41]

see comment in that other file. If GetAvailability returned a (channel, version)
tuple it'd be less magical and easier for the caller to intepret.

+        self._avail_ds.GetAvailability('earlyAPI'))
+    self.assertEquals('18',
+        self._avail_ds.GetAvailability('tabs'))
+    self.assertEquals('21',
+        self._avail_ds.GetAvailability('bookmarks'))
+    self.assertEquals('23',
+        self._avail_ds.GetAvailability('windows'))
+    self.assertEquals('27',
+        self._avail_ds.GetAvailability('storage'))
+    self.assertEquals('24',
+        self._avail_ds.GetAvailability('alarms'))
+    self.assertEquals('dev',
+        self._avail_ds.GetAvailability('cookies'))
+    self.assertEquals('beta',
+        self._avail_ds.GetAvailability('betaAPI'))
+    self.assertEquals('trunk',
+        self._avail_ds.GetAvailability('trunkAPI'))
+    self.assertEquals('6',
+        self._avail_ds.GetAvailability('menus'))
+    self.assertEquals('5',
+        self._avail_ds.GetAvailability('idle'))
+
+if __name__ == '__main__':
+  unittest.main()