Method _run_sub_modules

codewiki/src/be/caw_toolkit.py:271–316

(self, sub_module_specs: dict[str, list[str]])

    # ------------------------------------------------------------------

    def _run_sub_modules(self, sub_module_specs: dict[str, list[str]]) -> str:
        deps = self._deps
        previous_module_name = deps.current_module_name

        # Add sub-modules to the in-memory module tree.
        value = deps.module_tree
        for key in deps.path_to_current_module:
            value = value[key]["children"]
        for sub_name, core_ids in sub_module_specs.items():
            value[sub_name] = {"components": core_ids, "children": {}}

        try:
            for sub_name, core_ids in sub_module_specs.items():
                indent = "  " * deps.current_depth
                arrow = "└─" if deps.current_depth > 0 else "→"
                logger.info("%s%s Generating documentation for sub-module: %s", indent, arrow, sub_name)

                deps.current_module_name = sub_name
                deps.path_to_current_module.append(sub_name)
                deps.current_depth += 1
                try:
                    # Spawn a fresh caw session for the sub-module.  We already
                    # run inside a worker thread (started by the parent tool
                    # call), so call the sync entry point directly to avoid
                    # double-wrapping.  ``start_depth`` carries the parent's
                    # depth so the sub-agent's max_depth guard stays accurate.
                    self._backend._run_module_agent_sync(
                        module_name=sub_name,
                        components=deps.components,
                        core_component_ids=core_ids,
                        module_path=list(deps.path_to_current_module),
                        working_dir=deps.absolute_docs_path,
                        start_depth=deps.current_depth,
                        module_tree=deps.module_tree,
                    )
                finally:
                    deps.path_to_current_module.pop()
                    deps.current_depth -= 1
        finally:
            deps.current_module_name = previous_module_name

        return (
            "Generate successfully. Documentations: "
            + ", ".join(key + ".md" for key in sub_module_specs.keys())
            + " are saved in the working directory."
        )