Extensions Docs Server: devtools API

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

 # 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
 import logging
 import os
 
+from docs_server_utils import GetLinkToRefType
 import third_party.json_schema_compiler.model as model
 
 def _RemoveNoDocs(item):
   if type(item) == dict:
     if item.get('nodoc', False):
       return True
     for key, value in item.items():
       if _RemoveNoDocs(value):
         del item[key]
   elif type(item) == list:
     for i in item:
       if _RemoveNoDocs(i):
         item.remove(i)
   return False
 
-def _GetLinkToRefType(namespace_name, ref_type):
-  if ref_type.startswith(namespace_name + '.'):
-    type_name = ref_type[len(namespace_name + '.'):]
-    return { 'href': '#type-' + type_name, 'text': type_name }
-  elif '.' not in ref_type:
-    return { 'href': '#type-' + ref_type, 'text': ref_type }
-  api, type_name = ref_type.rsplit('.', 1)
-  return { 'href': api + '.html#type-' + type_name, 'text': ref_type }
-
 def _FormatValue(value):
   """Inserts commas every three digits for integer values. It is magic.
   """
   s = str(value)
   return ','.join([s[max(0, i - 3):i] for i in range(len(s), 0, -3)][::-1])
 
 class HandlebarDictGenerator(object):
   """Uses a Model from the JSON Schema Compiler and generates a dict that
   a Handlebar template can use for a data source.
   """
@@ skipping 20 matching lines @@
       parts = ref.split(' ', 1)
       if len(parts) == 1:
         ref = parts[0]
         rest = ''
       else:
         ref, rest = parts
         rest = ' ' + rest
       if not ref[-1].isalnum():
         rest = ref[-1] + rest
         ref = ref[:-1]
-      ref_dict = _GetLinkToRefType(self._namespace.name, ref)
+      ref_dict = GetLinkToRefType(self._namespace.name, ref)
       formatted_description.append('<a href="%(href)s">%(text)s</a>%(rest)s' %
           { 'href': ref_dict['href'], 'text': ref_dict['text'], 'rest': rest })
     return ''.join(formatted_description)
 
   def Generate(self):
     try:
       return {
         'name': self._namespace.name,
         'types': map(self._GenerateType, self._namespace.types.values()),
         'functions': self._GenerateFunctions(self._namespace.functions),
@@ skipping 86 matching lines @@
     if property_.type_ == model.PropertyType.CHOICES:
       dst_dict['choices'] = map(self._GenerateProperty,
                                 property_.choices.values())
       # We keep track of which is last for knowing when to add "or" between
       # choices in templates.
       if len(dst_dict['choices']) > 0:
         dst_dict['choices'][-1]['last'] = True
     elif property_.type_ == model.PropertyType.ADDITIONAL_PROPERTIES:
       dst_dict['additional_properties'] = True
     elif property_.type_ == model.PropertyType.REF:
-      dst_dict['link'] = _GetLinkToRefType(self._namespace.name,
-                                        property_.ref_type)
+      dst_dict['link'] = GetLinkToRefType(self._namespace.name,
+                                          property_.ref_type)
     elif property_.type_ == model.PropertyType.ARRAY:
       dst_dict['array'] = self._GenerateProperty(property_.item_type)
     elif property_.type_ == model.PropertyType.ENUM:
       dst_dict['enum_values'] = []
       for enum_value in property_.enum_values:
         dst_dict['enum_values'].append({'name': enum_value})
       if len(dst_dict['enum_values']) > 0:
         dst_dict['enum_values'][-1]['last'] = True
     elif property_.instance_of:
       dst_dict['simple_type'] = property_.instance_of.lower()
     else:
       dst_dict['simple_type'] = property_.type_.name.lower()