Add support for retrieving Git Log history as revision history in RST.

Signed-off-by: Jeff Scheel <scheel@us.ibm.com>

rst_template/bk_main.xml

@@ -66,15 +66,8 @@
     
     <abstract>TBD</abstract>
 
-    <revhistory>
-      <!-- TODO: Set the initial version information and clear any old information out -->
-      <revision>
-          <date>2017-02-17</date>
-          <revdescription>
-            <para>TBD</para>
-          </revdescription>
-      </revision>
-     </revhistory>
+    <!-- Note: The tooling converts the Git Log into a revision history -->
+    <revhistory>TBD</revhistory>
     </info>
 
   <!-- The ch_preface.xml file is required by all documents -->

rst_template/opf_docbook.py

@@ -137,6 +137,32 @@ def insert_toc_into_book(toc_file, book_file):
         print 'Error: key string of "', key_string, '" not found in ', book_file
         sys.exit(-7)
 
+def build_revhistory()
+    from subprocess import Popen, PIPE
+    
+    # Variables for formating git log
+    log_format = '%h%x01%an%x01%ad%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x01%s%x02'
+    log_fields = ['id', 'author', 'date', 'subject']
+
+    # Retrieve log
+    pipe = Popen('git log --date=iso --format="%s"' % log_format, shell=True, stdout=PIPE)
+    log, _ = pipe.communicate()
+    log = log.replace('&','&amp;').replace('<','&lt;').replace('>','&gt;').replace('\n','').strip('\x02').split('\x02')
+    log = [row.split('\01') for row in log]
+    log = [dict(zip(log_fields, row)) for row in log]
+
+    # Format log into revision history    
+    revision = '<revhistory>\n'
+    for entry in log:
+        revision = revision + '<revision><date>' + entry['date'] + '</date><revdescription><para>' +\
+            entry['subject'] + ' (' + entry['id'] + ')</para></revdescription></revision>\n'
+    revision = revision + '</revhistory>\n'
+
+    # Update file
+    rev_str = '<revhistory>TBD</revhistory>'
+    update_file('bk_main.xml', rev_str, revision)
+
+    
 def main(argv):
     build_dir = ''
     db_dir = ''
@@ -202,6 +228,9 @@ def main(argv):
     # Update link to first file
     insert_toc_into_book(full_toc_file_tmp2, book_file)
     
+    # Create revision history from Git Log
+    build_revhistory()
+       
     sys.exit(0)