Dynamically generate a heading for Extension Docs API pages

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

 #!/usr/bin/env python
 # Copyright (c) 2012 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 copy
+from copy import deepcopy
 import json
 import os
 import sys
 import unittest
 
 from api_data_source import (_JSCModel,
                              _FormatValue,
                              _RemoveNoDocs,
                              _DetectInlineableTypes,
                              _InlineDocs)
+from compiled_file_system import CompiledFileSystem
 from file_system import FileNotFoundError
 from object_store_creator import ObjectStoreCreator
 from reference_resolver import ReferenceResolver
+from test_data.canned_data import CANNED_TEST_FILE_SYSTEM_DATA
+from test_file_system import TestFileSystem
+import third_party.json_schema_compiler.json_parse as json_parse
 
 def _MakeLink(href, text):
   return '<a href="%s">%s</a>' % (href, text)
 
 def _GetType(dict_, name):
   for type_ in dict_['types']:
     if type_['name'] == name:
       return type_
 
+class FakeAvailabilityFinder(object):
+  def GetApiAvailability(self, version):
+    return None
+
 class FakeSamplesDataSource(object):
   def Create(self, request):
     return {}
 
 class FakeAPIAndListDataSource(object):
   def __init__(self, json_data):
     self._json = json_data
 
   def Create(self, *args, **kwargs):
     return self
 
   def get(self, key):
     if key not in self._json:
       raise FileNotFoundError(key)
     return self._json[key]
 
   def GetAllNames(self):
     return self._json.keys()
 
 class APIDataSourceTest(unittest.TestCase):
   def setUp(self):
     self._base_path = os.path.join(sys.path[0], 'test_data', 'test_json')
+    self._compiled_fs_factory = CompiledFileSystem.Factory(
+        TestFileSystem(CANNED_TEST_FILE_SYSTEM_DATA),
+        ObjectStoreCreator.ForTest())
+    self._json_cache = self._compiled_fs_factory.Create(
+    lambda _, json: json_parse.Parse(json),
+    APIDataSourceTest,
+    'test')
 
   def _ReadLocalFile(self, filename):
     with open(os.path.join(self._base_path, filename), 'r') as f:
       return f.read()
 
   def _CreateRefResolver(self, filename):
     data_source = FakeAPIAndListDataSource(
         self._LoadJSON(filename))
     return ReferenceResolver.Factory(data_source,
                                      data_source,
                                      ObjectStoreCreator.ForTest()).Create()
 
   def _LoadJSON(self, filename):
     return json.loads(self._ReadLocalFile(filename))
 
   def testCreateId(self):
     data_source = FakeAPIAndListDataSource(
         self._LoadJSON('test_file_data_source.json'))
     dict_ = _JSCModel(self._LoadJSON('test_file.json')[0],
                       self._CreateRefResolver('test_file_data_source.json'),
-                      False).ToDict()
+                      False,
+                      FakeAvailabilityFinder(),
+                      self._json_cache).ToDict()
     self.assertEquals('type-TypeA', dict_['types'][0]['id'])
     self.assertEquals('property-TypeA-b',
                       dict_['types'][0]['properties'][0]['id'])
     self.assertEquals('method-get', dict_['functions'][0]['id'])
     self.assertEquals('event-EventA', dict_['events'][0]['id'])
 
   # TODO(kalman): re-enable this when we have a rebase option.
   def DISABLED_testToDict(self):
     filename = 'test_file.json'
     expected_json = self._LoadJSON('expected_' + filename)
     data_source = FakeAPIAndListDataSource(
         self._LoadJSON('test_file_data_source.json'))
     dict_ = _JSCModel(self._LoadJSON(filename)[0],
                       self._CreateRefResolver('test_file_data_source.json'),
-                      False).ToDict()
+                      False,
+                      FakeAvailabilityFinder(),
+                      self._json_cache).ToDict()
     self.assertEquals(expected_json, dict_)
 
   def testFormatValue(self):
     self.assertEquals('1,234,567', _FormatValue(1234567))
     self.assertEquals('67', _FormatValue(67))
     self.assertEquals('234,567', _FormatValue(234567))
 
   def testFormatDescription(self):
     dict_ = _JSCModel(self._LoadJSON('ref_test.json')[0],
                       self._CreateRefResolver('ref_test_data_source.json'),
-                      False).ToDict()
+                      False,
+                      FakeAvailabilityFinder(),
+                      self._json_cache).ToDict()
     self.assertEquals(_MakeLink('ref_test.html#type-type2', 'type2'),
                       _GetType(dict_, 'type1')['description'])
     self.assertEquals(
         'A %s, or %s' % (_MakeLink('ref_test.html#type-type3', 'type3'),
                          _MakeLink('ref_test.html#type-type2', 'type2')),
         _GetType(dict_, 'type2')['description'])
     self.assertEquals(
         '%s != %s' % (_MakeLink('other.html#type-type2', 'other.type2'),
                       _MakeLink('ref_test.html#type-type2', 'type2')),
         _GetType(dict_, 'type3')['description'])
 
   def testRemoveNoDocs(self):
     d = self._LoadJSON('nodoc_test.json')
     _RemoveNoDocs(d)
-    self.assertEqual(self._LoadJSON('expected_nodoc.json'), d)
+    self.assertEquals(self._LoadJSON('expected_nodoc.json'), d)
+
+  def testGetPermissions(self):
+    model = _JSCModel(self._LoadJSON('test_file.json')[0],
+                      self._CreateRefResolver('test_file_data_source.json'),
+                      False,
+                      FakeAvailabilityFinder(),
+                      self._json_cache)
+    self.assertEquals(model._GetPermissions(),
+                      [
+                        { "permission": "tester" },
+                        { "extra": "is an API." }
+                      ])
+
+  def testGetMoreLearning(self):
+    model = _JSCModel(self._LoadJSON('test_file.json')[0],
+                      self._CreateRefResolver('test_file_data_source.json'),
+                      False,
+                      FakeAvailabilityFinder(),
+                      self._json_cache)
+    self.assertEquals(model._GetMoreLearning(),
+                      [{
+                        'href': 'https://tester.test.com/welcome.html',
+                        'content': 'Welcome!'
+                      }])
 
   def testInlineDocs(self):
     schema = {
       "namespace": "storage",
       "properties": {
         "key2": {
           "description": "second key",
           "$ref": "Key"
         },
         "key1": {
@@ skipping 41 matching lines @@
             "marker": True,
             "type": "string"
           },
           "type": "array",
           "id": "KeyList",
           "description": "A list of keys"
         }
       ]
     }
 
-    inlined_schema = copy.deepcopy(schema)
+    inlined_schema = deepcopy(schema)
     _InlineDocs(inlined_schema)
     self.assertEqual(expected_schema, inlined_schema)
 
   def testDetectInline(self):
     schema = {
       "types": [
         {
           "id": "Key",
           "items": {
             "$ref": "Value"
@@ skipping 16 matching lines @@
         }
       ]
     }
 
     _DetectInlineableTypes(schema)
     _InlineDocs(schema)
     self.assertEqual(expected_schema, schema)
 
 if __name__ == '__main__':
   unittest.main()