fixes #286

Author: o-smirnov

scabha/configuratt/deps.py

@@ -15,9 +15,9 @@
 @dataclass
 class FailRecord(object):
     filename: str
-    origin: Optional[str]
-    modulename: Optional[str]
-    fname: Optional[str]
+    origin: Optional[str] = None
+    modulename: Optional[str] = None
+    fname: Optional[str] = None
 
 @dataclass
 class RequirementRecord(object):

stimela/commands/doc.py

@@ -82,7 +82,7 @@ def load_recipe(name: str, section: Dict):
 
     # load config and recipes from all given files
     if files_to_load:
-        load_recipe_files(files_to_load)
+        top_level_recipes = load_recipe_files(files_to_load)
 
     destroy_progress_bar()
 
@@ -109,9 +109,10 @@ def load_recipe(name: str, section: Dict):
 
     # if nothing was specified, and only one cab/only one recipe is defined, print that
     if not names_to_document:
-        if len(stimela.CONFIG.lib.recipes) == 1 and not stimela.CONFIG.cabs:
-            recipes_to_document.update(stimela.CONFIG.lib.recipes.keys())
-        elif len(stimela.CONFIG.cabs) == 1 and not stimela.CONFIG.lib.recipes:
+        if len(top_level_recipes) == 1:
+            recipes_to_document.update(top_level_recipes)
+            log.info("a single top-level recipe is defined, documenting it by default. Use -l to list all defined recipes/cabs")
+        elif len(stimela.CONFIG.cabs) == 1 and not top_level_recipes:
             cabs_to_document.update(stimela.CONFIG.cabs.keys())
 
     if recipes_to_document or cabs_to_document: