3 # Copyright (c) 2014 The Chromium Authors. All rights reserved.
4 # Use of this source code is governed by a BSD-style license that can be
5 # found in the LICENSE file.
18 SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
19 DOC_DIR = os.path.dirname(SCRIPT_DIR)
22 ChannelInfo = collections.namedtuple('ChannelInfo', ['branch', 'version'])
27 sys.stderr.write(str(msg) + '\n')
33 url = 'http://omahaproxy.appspot.com/json'
34 u = urllib2.urlopen(url)
36 data = json.loads(u.read())
43 if osname not in ('win', 'mac', 'linux'):
45 for version_row in os_row['versions']:
46 channel = version_row['channel']
47 # We don't display canary docs.
48 if channel == 'canary':
51 version = version_row['version'].split('.')[0] # Major version
52 branch = version_row['true_branch']
56 if channel in channel_info:
57 existing_info = channel_info[channel]
58 if branch != existing_info.branch:
59 sys.stderr.write('Warning: found different branch numbers for '
60 'channel %s: %s vs %s. Using %s.\n' % (
61 channel, branch, existing_info.branch, existing_info.branch))
63 channel_info[channel] = ChannelInfo(branch, version)
68 def RemoveFile(filename):
69 if os.path.exists(filename):
73 def RemoveDir(dirname):
74 if os.path.exists(dirname):
75 shutil.rmtree(dirname)
78 def GetSVNRepositoryRoot(branch):
80 return 'http://src.chromium.org/chrome/trunk/src'
81 return 'http://src.chromium.org/chrome/branches/%s/src' % branch
84 def CheckoutPepperDocs(branch, doc_dirname):
85 Trace('Removing directory %s' % doc_dirname)
86 RemoveDir(doc_dirname)
88 svn_root_url = GetSVNRepositoryRoot(branch)
90 for subdir in ('api', 'generators', 'cpp', 'utility'):
91 url = svn_root_url + '/ppapi/%s' % subdir
92 cmd = ['svn', 'co', url, os.path.join(doc_dirname, subdir)]
93 Trace('Checking out docs into %s:\n %s' % (doc_dirname, ' '.join(cmd)))
94 subprocess.check_call(cmd)
96 # The IDL generator needs PLY (a python lexing library); check it out into
98 url = svn_root_url + '/third_party/ply'
99 ply_dirname = os.path.join(doc_dirname, 'generators', 'ply')
100 cmd = ['svn', 'co', url, ply_dirname]
101 Trace('Checking out PLY into %s:\n %s' % (ply_dirname, ' '.join(cmd)))
102 subprocess.check_call(cmd)
105 def GenerateCHeaders(pepper_version, doc_dirname):
106 script = os.path.join(os.pardir, 'generators', 'generator.py')
107 cwd = os.path.join(doc_dirname, 'api')
108 out_dirname = os.path.join(os.pardir, 'c')
109 cmd = [sys.executable, script, '--cgen', '--release', 'M' + pepper_version,
110 '--wnone', '--dstroot', out_dirname]
111 Trace('Generating C Headers for version %s\n %s' % (
112 pepper_version, ' '.join(cmd)))
113 subprocess.check_call(cmd, cwd=cwd)
116 def GenerateDoxyfile(template_filename, out_dirname, doc_dirname, doxyfile):
117 Trace('Writing Doxyfile "%s" (from template %s)' % (
118 doxyfile, template_filename))
120 with open(template_filename) as f:
123 with open(doxyfile, 'w') as f:
125 'out_dirname': out_dirname,
126 'doc_dirname': doc_dirname,
127 'script_dirname': SCRIPT_DIR})
130 def RunDoxygen(out_dirname, doxyfile):
131 Trace('Removing old output directory %s' % out_dirname)
132 RemoveDir(out_dirname)
134 Trace('Making new output directory %s' % out_dirname)
135 os.makedirs(out_dirname)
137 cmd = ['doxygen', doxyfile]
138 Trace('Running Doxygen:\n %s' % ' '.join(cmd))
139 subprocess.check_call(cmd)
142 def RunDoxyCleanup(out_dirname):
143 script = os.path.join(SCRIPT_DIR, 'doxy_cleanup.py')
144 cmd = [sys.executable, script, out_dirname]
147 Trace('Running doxy_cleanup:\n %s' % ' '.join(cmd))
148 subprocess.check_call(cmd)
151 def RunRstIndex(kind, channel, pepper_version, out_dirname, out_rst_filename):
152 assert kind in ('root', 'c', 'cpp')
153 script = os.path.join(SCRIPT_DIR, 'rst_index.py')
154 cmd = [sys.executable, script,
156 '--channel', channel,
157 '--version', pepper_version,
159 '-o', out_rst_filename]
160 Trace('Running rst_index:\n %s' % ' '.join(cmd))
161 subprocess.check_call(cmd)
164 def GenerateDocs(root_dirname, channel, pepper_version, branch):
165 Trace('Generating docs for %s (branch %s)' % (channel, branch))
166 pepper_dirname = 'pepper_%s' % channel
167 out_dirname = os.path.join(root_dirname, pepper_dirname)
170 svn_dirname = tempfile.mkdtemp(prefix=pepper_dirname)
171 doxyfile_dirname = tempfile.mkdtemp(prefix='%s_doxyfiles' % pepper_dirname)
173 CheckoutPepperDocs(branch, svn_dirname)
174 GenerateCHeaders(pepper_version, svn_dirname)
179 # Generate Root index
180 rst_index_root = os.path.join(DOC_DIR, pepper_dirname, 'index.rst')
181 RunRstIndex('root', channel, pepper_version, out_dirname, rst_index_root)
184 out_dirname_c = os.path.join(out_dirname, 'c')
185 doxyfile_c = os.path.join(doxyfile_dirname, 'Doxyfile.c.%s' % channel)
186 doxyfile_c_template = os.path.join(SCRIPT_DIR, 'Doxyfile.c.template')
187 rst_index_c = os.path.join(root_dirname, pepper_dirname, 'c', 'index.rst')
188 GenerateDoxyfile(doxyfile_c_template, out_dirname_c, svn_dirname,
190 RunDoxygen(out_dirname_c, doxyfile_c)
191 RunDoxyCleanup(out_dirname_c)
192 RunRstIndex('c', channel, pepper_version, out_dirname_c, rst_index_c)
195 out_dirname_cpp = os.path.join(out_dirname, 'cpp')
196 doxyfile_cpp = os.path.join(doxyfile_dirname, 'Doxyfile.cpp.%s' % channel)
197 doxyfile_cpp_template = os.path.join(SCRIPT_DIR, 'Doxyfile.cpp.template')
198 rst_index_cpp = os.path.join(root_dirname, pepper_dirname, 'cpp',
200 GenerateDoxyfile(doxyfile_cpp_template, out_dirname_cpp, svn_dirname,
202 RunDoxygen(out_dirname_cpp, doxyfile_cpp)
203 RunDoxyCleanup(out_dirname_cpp)
204 RunRstIndex('cpp', channel, pepper_version, out_dirname_cpp, rst_index_cpp)
207 RemoveDir(svn_dirname)
208 RemoveDir(doxyfile_dirname)
212 parser = optparse.OptionParser(usage='Usage: %prog [options] <out_directory>')
213 parser.add_option('-v', '--verbose',
214 help='Verbose output', action='store_true')
215 options, dirs = parser.parse_args(argv)
221 parser.error('Expected an output directory')
223 channel_info = GetChannelInfo()
224 for channel, info in channel_info.iteritems():
225 GenerateDocs(dirs[0], channel, info.version, info.branch)
230 if __name__ == '__main__':
232 rtn = main(sys.argv[1:])
233 except KeyboardInterrupt:
234 sys.stderr.write('%s: interrupted\n' % os.path.basename(__file__))