Add support for $ref'ing namespaces to server2.

chrome/common/extensions/docs/server2/reference_resolver.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.
 
 from file_system import FileNotFoundError
 import logging
 import object_store
 import string
 
 def _ClassifySchemaNode(node_name, api):
@@ skipping 49 matching lines @@
           self._api_data_source_factory.Create(None, disable_refs=True),
           self._api_list_data_source_factory.Create(),
           self._object_store)
 
   def __init__(self, api_data_source, api_list_data_source, object_store):
     self._api_data_source = api_data_source
     self._api_list_data_source = api_list_data_source
     self._object_store = object_store
 
   def _GetRefLink(self, ref, api_list, namespace, title):
+    # Check nodes within each API the ref might refer to.
     parts = ref.split('.')
     for i, part in enumerate(parts):
       api_name = '.'.join(parts[:i])
       if api_name not in api_list:
         continue
       try:
         api = self._api_data_source.get(api_name)
       except FileNotFoundError:
         continue
       name = '.'.join(parts[i:])
@@ skipping 17 matching lines @@
       else:
         text = ref
       category, node_name = node_info
       if namespace is not None and text.startswith('%s.' % namespace):
         text = text[len('%s.' % namespace):]
       return {
         'href': '%s.html#%s-%s' % (api_name, category, name.replace('.', '-')),
         'text': title if title else text,
         'name': node_name
       }
+
+    # If it's not a reference to an API node it might just be a reference to an
+    # API. Check this last so that links within APIs take precedence over links
+    # to other APIs.
+    if ref in api_list:
+      return {
+        'href': '%s.html' % ref,
+        'text': title if title else ref,
+        'name': ref
+      }
+
     return None
 
   def GetLink(self, ref, namespace=None, title=None):
     """Resolve $ref |ref| in namespace |namespace| if not None, returning None
     if it cannot be resolved.
     """
     link = self._object_store.Get(_MakeKey(namespace, ref, title),
                                   object_store.REFERENCE_RESOLVER).Get()
     if link is not None:
       return link
@@ skipping 63 matching lines @@
         index += 1
       rest = '%s%s' % (ref[index:], rest)
       ref = ref[:index]
       while not ref[-1].isalnum():
         rest = '%s%s' % (ref[-1], rest)
         ref = ref[:-1]
       ref_dict = self.SafeGetLink(ref, namespace=namespace, title=title)
       formatted_text.append('<a href="%(href)s">%(text)s</a>%(rest)s' %
           { 'href': ref_dict['href'], 'text': ref_dict['text'], 'rest': rest })
     return ''.join(formatted_text)