Dynamically generate a heading for Extension Docs API pages

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

+# 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 logging
+import os
+
+class ChromeVersionUtility(object):
+  '''Generates and stores API data sources corresponding to the latest branch
+  number for a given version of Chrome.
+
+  Accesses data found on omahaproxy in order to link branch numbers to version
+  numbers.
+  '''
+
+  def __init__(self, base_path, fetcher, object_store_creator):
+    self._base_path = base_path
+    self._fetcher = fetcher
+    self._object_store = object_store_creator.Create(ChromeVersionUtility,
+                                                     channel=None)
+
+  def GetBranchNumberForVersion(self, version):
+    '''Returns the most recent branch number for a given chrome version number
+    using data stored on omahaproxy (see url_constants)
+    '''
+    if version == 'trunk':
+      return 'trunk'
+
+    branch = self._object_store.Get(str(version)).Get()
+    if branch is not None:
+      return branch
+    version_json = json.loads(self._fetcher.Fetch(self._base_path).content)
+    for entry in version_json['events']:
+      # Here, entry['title'] looks like: 'title - version#.#.branch#.#'
+      version_title = entry['title'].split(' - ')[1].split('.')
+      if version_title[0] == str(version):
+        self._object_store.Set(str(version), version_title[2])
+        return int(version_title[2])
+    raise ValueError(
+        'A branch number for the given version could not be determined')
+
+  def GetLatestVersionNumber(self):
+    version_json = json.loads(self._fetcher.Fetch(self._base_path).content)
+    latest_version = 0
+    for entry in version_json['events']:
+      version_title = entry['title'].split(' - ')[1].split('.')
+      version = int(version_title[0])
+      if version > latest_version:
+        latest_version = version
+    return latest_version