#!/usr/bin/env python # # Copyright 2013 Pixar # # Licensed under the terms set forth in the LICENSE.txt file available at # https://opensubdiv.org/license. # from __future__ import print_function import os import sys import string import re #------------------------------------------------------------------------------- def ReadFile(inputfile): try: f = open( inputfile, "r") except IOError: print("Could not read file \'"+inputfile+"\'") content = f.read() f.close() return content #------------------------------------------------------------------------------- def WriteToFile(outputfile, content): outputPath = os.path.dirname(outputfile) try: os.makedirs(outputPath) except: pass try: f = open(outputfile, "w") except IOError: print("Could not write file \'"+outputfile+"\'") f.write(content) f.close() #------------------------------------------------------------------------------- # Reformats the C++ tutorial file as a ReST file for publication on the # documentation site def Process(srcfile, title): basename = os.path.basename(srcfile) rest = "\n" rest += basename+"\n" rest += ("-" * len(basename))+"\n\n" rest += "``_\n" rest += ("\n" "----\n" "\n" ".. code:: c++\n" "\n") code = ReadFile(srcfile) lines = code.split('\n') # cut license header (line 24) for line in lines[24:]: rest += ' ' + line + '\n' #lines = [i.start() for i in re.finditer("\n", code)] #rest += code[lines[25]:] return rest #------------------------------------------------------------------------------- def Usage(): print(str(sys.argv[0])+" ") exit(1) #------------------------------------------------------------------------------- # Main # XXXX manuelk we should have this script traverse the tutorials folders and # automatically generate both the ReST from the C++ code as well # as the tutorials.rst file based on what is found if (len(sys.argv)!=4): Usage() srcfile = str(sys.argv[1]) title = str(sys.argv[3]) rest = Process(srcfile, title) dstfile = str(sys.argv[2]) WriteToFile(dstfile, rest)