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):
+    # Easy: maybe it's just a ref to an API.
+    if ref in api_list:

[Jeffrey Yasskin, 2013/01/18 18:27:31]

Are the elements of api_list like "tabs" or "chrome.tabs"? Do you intend
$ref:tabs or $ref:chrome.tabs to work?

[not at google - send to devlin, 2013/01/18 18:30:25]

They're just like "tabs". There's no need for "chrome.tabs" to work.

Though I just realised that it may be better for this block to move below the
resolve-within-namespaces logic - say that the tabs API has a function called
windows. We probably want $ref:windows within the tabs API to resolve to the
windows function, not the windows namespace.

+      return {
+        'href': '%s.html' % ref,
+        'text': title if title else ref,
+        'name': ref
+      }
+
+    # Harder: maybe it's a ref to a node within an API.
     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 100 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)