✨ Add section components

- add overview page for each section showing components in main section folder

Author: enryH

src/vuegen/config_manager.py

@@ -257,14 +257,25 @@ def _create_sect_config_fromdir(
         )
 
         subsections = []
+        components = []
         for subsection_dir in sorted_subsections:
             if subsection_dir.is_dir():
                 subsections.append(self._create_subsect_config_fromdir(subsection_dir))
+            else:
+                file_in_subsection_dir = (
+                    subsection_dir  # ! maybe take more generic names?
+                )
+                component_config = self._create_component_config_fromfile(
+                    file_in_subsection_dir
+                )
+                if component_config is not None:
+                    components.append(component_config)
 
         section_config = {
             "title": self._create_title_fromdir(section_dir_path.name),
             "description": self._read_description_file(section_dir_path),
             "subsections": subsections,
+            "components": components,
         }
         return section_config
 

src/vuegen/streamlit_reportview.py

@@ -1,5 +1,4 @@
 import os
-import re
 import subprocess
 import sys
 from pathlib import Path
@@ -148,6 +147,18 @@ def generate_report(self, output_dir: str = SECTIONS_DIR) -> None:
                     self.report.logger.debug(
                         f"Section directory already existed: {section_dir_path}"
                     )
+                # add an overview page to section of components exist
+                if section.components:
+                    subsection_file_path = (
+                        Path(section_name_var)
+                        / f"0_overview_{section.title.lower()}.py"
+                    ).as_posix()  # Make sure it's Posix Paths
+
+                    # Create a Page object for each subsection and add it to the home page content
+                    report_manag_content.append(
+                        f"{section_name_var}_overview = st.Page('{subsection_file_path}', title='Overview {section.title}')"
+                    )
+                    subsection_page_vars.append(f"{section_name_var}_overview")
 
                 for subsection in section.subsections:
                     # ! could add a non-integer to ensure it's a valid identifier
@@ -386,6 +397,25 @@ def _generate_sections(self, output_dir: str) -> None:
                     f"Processing section '{section.id}': '{section.title}' - {len(section.subsections)} subsection(s)"
                 )
 
+                if section.components:
+                    # add an section overview page
+                    section_content, section_imports, _ = self._combine_components(
+                        section.components
+                    )
+                    _filepath_overview = (
+                        Path(output_dir)
+                        / section_name_var
+                        / f"0_overview_{section.title.lower()}.py"
+                        # ! tighly coupled to generate_report fct:
+                        # ! check how to pass file names
+                    )
+
+                    write_python_file(
+                        fpath=_filepath_overview,
+                        imports=section_imports,
+                        contents=section_content,
+                    )
+
                 if not section.subsections:
                     self.report.logger.warning(
                         f"No subsections found in section: '{section.title}'. "
@@ -394,6 +424,7 @@ def _generate_sections(self, output_dir: str) -> None:
                     continue
 
                 # Iterate through subsections and integrate them into the section file
+                # subsection should have the subsection_file_path as file_path?
                 for subsection in section.subsections:
                     self.report.logger.debug(
                         f"Processing subsection '{subsection.id}': '{subsection.title} -"