Make required folder structure more flexible (#108)

* 🚧♻️ Refactor creating and writing components streamlit files

- writing of imports + component code (write python file)
- component - fct map for generation
- building list of components

* 🎨 move static_dir to init, remove some old code

* ✨ add components to streamlit home site

- first section is home section recording it's compents
- needs to be treated separately

* ✨ Add section components

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

* 🎨 pass relative section file paths on using Section dataclasses

- Section could be used everywhere, Subsection is not really necessary. If a Section has subsections, the logic changes. Else nothing changes.

* 🔥 remove old code (unused)

* ♻️ move is_static_report to init for quarto

- set based on report type, and this is set on init
- avoid to pass on variable to all functions.

* 🎨 move static_dir to quarto_report init

- same as for streamlit_report to prepare refactoring
  of components parsing.

* ♻️ factor out component creation

- very similar to _combine_components in streamlit_report
- imports has to be a list of list -> figure this out
- added debug message for skipping components in
  static reports-> should maybe be a warining?

* 🎨 remove blank line from logs

* ✨ add components from main and section folders

* 🎨 align import handling in streamlit and quarto reports

* 🐛 single curley-brackets

- I removed an empty f-string and this lead to doubled curely brackets...

* 🎨 add tabs to overview sections

* 🐛 handle single descripton.md files

⚠️ duplicated code

- description files are parsed by configuration_manager
- skipped for section content. So a section can have content, which is not used - a single description.md file

Author: enryH

src/vuegen/config_manager.py

@@ -145,7 +145,7 @@ def _create_component_config_fromfile(self, file_path: Path) -> Dict[str, str]:
             component_config["component_type"] = r.ComponentType.MARKDOWN.value
         else:
             self.logger.error(
-                f"Unsupported file extension: {file_ext}. Skipping file: {file_path}\n"
+                f"Unsupported file extension: {file_ext}. Skipping file: {file_path}"
             )
             return None
 
@@ -227,6 +227,9 @@ def _create_subsect_config_fromdir(
                     continue
                 # Add component config to list
                 components.append(component_config)
+            # ! if folder go into folder and pull files out?
+            # nesting level already at point 2
+            # loop of components in a folder
 
         subsection_config = {
             "title": self._create_title_fromdir(subsection_dir_path.name),
@@ -257,14 +260,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
 
@@ -301,12 +315,27 @@ def create_yamlconfig_fromdir(
         # Sort sections by their number prefix
         sorted_sections = self._sort_paths_by_numprefix(list(base_dir_path.iterdir()))
 
+        main_section_config = {
+            "title": "",  # self._create_title_fromdir("home_components"),
+            "description": "Components added to homepage.",
+            "components": [],
+        }
+        yaml_config["sections"].append(main_section_config)
+
         # Generate sections and subsections config
         for section_dir in sorted_sections:
             if section_dir.is_dir():
                 yaml_config["sections"].append(
                     self._create_sect_config_fromdir(section_dir)
                 )
+            # could be single plots?
+            else:
+                file_in_main_section_dir = section_dir
+                component_config = self._create_component_config_fromfile(
+                    file_in_main_section_dir
+                )
+                if component_config is not None:
+                    main_section_config["components"].append(component_config)
 
         return yaml_config, base_dir_path
 
@@ -372,6 +401,10 @@ def _create_section(self, section_data: dict) -> r.Section:
             description=section_data.get("description"),
         )
 
+        for component_data in section_data.get("components", []):
+            component = self._create_component(component_data)
+            section.components.append(component)
+
         # Create subsections
         for subsection_data in section_data.get("subsections", []):
             subsection = self._create_subsection(subsection_data)