handle None; split do_main; link eval types

Author: dwhswenson

paths_cli/compiling/_gendocs/json_type_handlers.py

@@ -53,6 +53,12 @@ def _is_listof(json_type):
 )
 
 
+handle_none = JsonTypeHandler(
+    is_my_type=lambda obj: obj is None,
+    handler=lambda json_type: "type information missing",
+)
+
+
 class RefTypeHandler(JsonTypeHandler):
     """Handle JSON types of the form {"$ref": "#/definitions/..."}
 
@@ -122,13 +128,17 @@ class EvalHandler(RefTypeHandler):
         to the anchor given by ``link_to``
     """
     def __init__(self, type_name, link_to=None):
+        if link_to is None:
+            link_to = type_name
+
         super().__init__(
             type_name=type_name, def_string=type_name, link_to=link_to
         )
 
 
 JSON_TYPE_HANDLERS = [
     handle_object,
+    handle_none,
     handle_listof,
     CategoryHandler("engine"),
     CategoryHandler("cv"),

paths_cli/compiling/gendocs.py

@@ -9,6 +9,11 @@
 @click.option("--stdout", type=bool, is_flag=True, default=False)
 def main(config_file, stdout):
     """Generate documentation for installed compiling plugins."""
+    do_main(config_file, stdout)
+
+
+def do_main(config_file, stdout=False):
+    """Separate method so this can be imported and run"""
     register_installed_plugins()
     config = load_config(config_file)
     generator = DocsGenerator(config)