Android ANDROID_VERSION Compatibility Definition

#!/usr/bin/python """ Utility for building the CDD from component markdown files. From the compatibility/cdd directory, run: python make-cdd.py --version --branch --output TODO(gdimino): Clean up and comment this code. """ from bs4 import BeautifulSoup import argparse import hashlib import markdown import os import pprint import re import tidylib import subprocess # TODO (gdimino): Clean up this code using templates # from jinja2 import Template HEADERS_FOR_TOC = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'h7'] TOC_PER_COL = 34 def get_section_info(my_path): # (_, _, filenames) = os.walk(my_path).next() section_info = []; # Get section info from every file whose name contains a number. TODO: fix # this ugly hack. # for rootdir, subdirs, files in os.walk(my_path): for dir in get_immediate_subdirs(my_path): # for dir in subdirs: if (not dir.isalpha() and dir != 'older-versions' and dir != '.git'): child_data = [] print 'dir = ' + dir for file in os.listdir(dir): if '.md' in file: if file == 'index.md': number = 0 else: number = int((file.split('_')[1])) print 'file = ' + file + ', dir = ' + dir html_string = markdown.markdown(unicode(open(my_path + '/' + dir + '/' + file, 'r').read(), 'utf-8')) child_data.append({'file': file, 'number': number, 'title': dir.split('_')[-1], 'html': html_string, 'children':[]}) child_data.sort(key=lambda child: child['number']) section_info.append({'id': dir, 'number': int(''.join((dir.split('_')[:-1])).replace("_", ".")), 'title': dir.split('_')[-1], 'html': '', 'children':child_data}) section_info.sort(key=lambda section: section['number']) return section_info def get_soup(section_info): html_body_text = ''' Android ANDROID_VERSION Compatibility Definition

''' for section in section_info: for child in section['children']: html_body_text += child['html'] html_body_text += '

' return BeautifulSoup(html_body_text) def add_id_to_section_headers(soup): header_tags = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'h7'] for tag in soup.find_all(header_tags): tag['id'] = create_id(tag) def generate_toc(soup): toc_html = '

' header_tags = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'h7'] toc_entries = soup.find_all(header_tags) toc_chunks = [toc_entries[i:i + TOC_PER_COL] for i in xrange(0, len(toc_entries), TOC_PER_COL)] print 'Number of chunks = %d' % len(toc_chunks) for chunk in toc_chunks: if not toc_chunks.index(chunk) %2: toc_html = toc_html + ('

') for tag in chunk: toc_html = toc_html + '

' + tag.contents[0] + '

' toc_html = toc_html + ('

') else: toc_html = toc_html + ('

') for tag in chunk: toc_html = toc_html + '

' + tag.contents[0] + '

' toc_html = toc_html + ('

') toc_html = toc_html + '

' toc_html = toc_html + '

' return (BeautifulSoup(toc_html).body.contents) def add_toc(soup): toc_contents = generate_toc(soup)[0] toc_title = BeautifulSoup("

").body.contents[0] soup.body.insert(0, toc_contents) soup.body.insert(0, toc_title) return soup def create_id(header_tag): return header_tag.contents[0].lower().replace('. ', '_').replace(' ', '_').replace('.', '_') # Utilities def get_immediate_subdirs(dir): return [name for name in os.listdir(dir) if os.path.isdir(os.path.join(dir, name))] # Odds and ends def check_section_numbering(soup): header_tags = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'h7'] for tag in header_tags: headings = soup.find_all(tag) header_numbers = [] for heading in headings: header_numbers.append(re.sub(r"([\d.]*).*", r"\1"), heading.contents) return true def get_version_branch_and_output(): # Get command-line args. If there aren't any, then prompt for user input. parser = argparse.ArgumentParser() parser.add_argument('--version', help='Android version') parser.add_argument('--branch', help='AOSP branch') parser.add_argument('--output', help='Base name of output file') args = parser.parse_args() if not args.version: args.version = raw_input('Android version for CDD: ') if not args.branch: args.branch = raw_input('Current AOSP branch for changelog: ') if not args.output: args.output = raw_input('Base name of desired output file: ') return (args.version, args.branch, args.output) def remove_space_before_punctuation(input): space_before_punc = r'\s+([.,:])' return re.sub(space_before_punc, '\1') def main(): # Read version and branch info and output file name. (ANDROID_VERSION, CURRENT_BRANCH, output_filename) = get_version_branch_and_output() # Scan current directory for source files and compile info for the toc.. my_path = os.getcwd() section_info = get_section_info(my_path) # Generate the HTML soup = get_soup(section_info) add_id_to_section_headers(soup) add_toc(soup) html = soup.prettify(formatter='html') # Add version and branch info html = re.sub(re.compile(r"ANDROID_VERSION"), ANDROID_VERSION, html) html = re.sub(re.compile(r"CURRENT_BRANCH"), CURRENT_BRANCH, html) # Apply HTML Tidy to output (document, errors) = tidylib.tidy_document(html, options={}) # Write output file output = open('%s.html' % output_filename, "w") output.write(document.encode('utf-8')) output.close() if __name__ == '__main__': main()

Table of Contents