Updates several comments

Author: chalmerlowe

scripts/microgenerator/bigqueryclient.py.j2

@@ -1,3 +1,10 @@
+# TODO: Add a header if needed.
+
+# ======== 🦕 HERE THERE BE DINOSAURS 🦖 =========
+# This content is subject to significant change. Not for review yet.
+# Included as a proof of concept for context or testing ONLY.
+# ================================================
+
 class BigQueryClient:
     def __init__(self):
         self._clients = {}

scripts/microgenerator/bigqueryclient_generator.py

@@ -1,3 +1,5 @@
+# TODO: Add a header if needed.
+
 import ast
 import os
 from collections import defaultdict
@@ -140,8 +142,8 @@ def generate_client_class_source(data):
     data = parse_files(FILES_TO_PARSE)
 
     final_code = generate_client_class_source(data)
-    # TODO: write final code to file.
 
+    # TODO: write final code to file instead of print to screen.
     print(final_code)
 
-    # Ensure black gets called on the generated source files as a final step.
+    # TODO: Ensure blacken gets called on the generated source files as a final step.

scripts/microgenerator/config_helper.py

@@ -1,4 +1,4 @@
-# config_helper.py
+# TODO: Add a header if needed.
 
 import yaml
 import os

scripts/microgenerator/template_utils.py

@@ -1,3 +1,5 @@
+# TODO: Add a header if needed.
+
 import os
 import jinja2
 
@@ -9,7 +11,7 @@ def load_template(template_name):
     template_dir = os.path.dirname(os.path.abspath(__file__))
     env = jinja2.Environment(
         loader=jinja2.FileSystemLoader(template_dir),
-        trim_blocks=True,
-        lstrip_blocks=True,
+        trim_blocks=True, # prevents blank lines by removing '\n' after block tags (e.g. {% if condition %}\n)
+        lstrip_blocks=True, # prevents unwanted empty spaces before lines of text by removing non-explicit spaces, tabs, etc
     )
     return env.get_template(template_name)