structui 0.2.0__tar.gz → 0.3.0__tar.gz

{structui-0.2.0 → structui-0.3.0}/PKG-INFO

@@ -1,62 +1,76 @@
-Metadata-Version: 2.4
-Name: structui
-Version: 0.2.0
-Summary: A format-agnostic, schema-driven, hierarchical configuration UI.
-Author: structui contributors
-License: MIT
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: nicegui>=1.4.0
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: pywin32>=300; sys_platform == "win32"
-
-# StructUI
-
-[![PyPI version](https://img.shields.io/pypi/v/structui.svg)](https://pypi.org/project/structui/)
-[![CI](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml)
-[![CD](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-StructUI is a format-agnostic, schema-driven, hierarchical configuration UI engine built in Python. Designed as a flexible architectural backbone, it parses standard configuration files (YAML, JSON, CSV, XML) and dynamically generates a live web-based property editor based on constraints and metadata defined in a schema file.
-
-The architecture is explicitly decoupled, making it readily extensible to strict domain-specific specifications (e.g., AUTOSAR configurators) and agent-driven programmatic workflows.
-
-## Features
-
-- **Pillar A: Format-Agnostic Parsers:** cleanly separate UI generation from underlying data formats. Out-of-the-box support for YAML, JSON, and XML (including schema-driven arrays and attributes), with abstract base classes extensible to CSV and others.
-- **Pillar B: Hierarchical UI:** Dynamic tree-based rendering with full support for multidimensional containers, dynamic polymorphic list additions, and node mapping. Powered natively by NiceGUI.
-- **Pillar C: Data Validity:** Enforces schema metadata strictly at the UI layer. Missing fields gracefully populate via defaults, required flags trigger locking, and nested typings are continuously evaluated.
-- **Pillar D: Extensibility & Programmatic Control:** Decomposed core logic (App, Parser, State, Schema, UI) allowing external tools and wrappers (e.g. CLI, Agent Workflows) to invoke the editor or inject properties safely.
-
-## Installation
-
-### From PyPI (recommended)
-
-```bash
-pip install structui
-```
-
-### From Source (development)
-
-```bash
-git clone https://github.com/MoSaeedHammad/structui.git
-cd structui
-pip install -e .
-```
-
-## Quick Start
-
-Launch the editor in the current directory against your local configuration files by simply typing:
-
-```bash
-structui --dir . --schema .structui_schema.yaml --port 8080
-```
+Metadata-Version: 2.4
+Name: structui
+Version: 0.3.0
+Summary: A format-agnostic, schema-driven, hierarchical configuration UI.
+Author: structui contributors
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: nicegui>=1.4.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: pywin32>=300; sys_platform == "win32"
+
+# StructUI
+
+[![PyPI version](https://img.shields.io/pypi/v/structui.svg)](https://pypi.org/project/structui/)
+[![CI](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml)
+[![CD](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+StructUI is a format-agnostic, schema-driven, hierarchical configuration UI engine built in Python. Designed as a flexible architectural backbone, it parses standard configuration files (YAML, JSON, CSV, XML) and dynamically generates a live web-based property editor based on constraints and metadata defined in a schema file.
+
+The architecture is explicitly decoupled, making it readily extensible to strict domain-specific specifications (e.g., AUTOSAR configurators) and agent-driven programmatic workflows.
+
+## Features
+
+- **Pillar A: Format-Agnostic Parsers:** cleanly separate UI generation from underlying data formats. Out-of-the-box support for YAML, JSON, and XML (including schema-driven arrays and attributes), with abstract base classes extensible to CSV and others.
+- **Pillar B: Hierarchical UI:** Dynamic tree-based rendering with full support for multidimensional containers, dynamic polymorphic list additions, and node mapping. Powered natively by NiceGUI.
+- **Pillar C: Data Validity:** Enforces schema metadata strictly at the UI layer. Missing fields gracefully populate via defaults, required flags trigger locking, and nested typings are continuously evaluated.
+- **Pillar D: Extensibility & Programmatic Control:** Decomposed core logic (App, Parser, State, Schema, UI) allowing external tools and wrappers (e.g. CLI, Agent Workflows) to invoke the editor or inject properties safely.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install structui
+```
+
+### From Source (development)
+
+```bash
+git clone https://github.com/MoSaeedHammad/structui.git
+cd structui
+pip install -e .
+```
+
+## Quick Start
+
+Launch the editor in the current directory against your local configuration files by simply typing:
+
+```bash
+structui --dir . --schema .structui_schema.yaml --port 8080
+```
+
+## Testing
+
+To run the test suite and verify code coverage, first install the necessary development dependencies:
+
+```bash
+pip install -e . pytest pytest-cov pytest-asyncio pyyaml nicegui
+```
+
+Then, run `pytest` with coverage reporting:
+
+```bash
+PYTHONPATH=src python3 -m pytest tests/ --cov=structui --cov-report=term-missing
+```

{structui-0.2.0 → structui-0.3.0}/README.md

@@ -39,3 +39,17 @@ Launch the editor in the current directory against your local configuration file
 ```bash
 structui --dir . --schema .structui_schema.yaml --port 8080
 ```
+
+## Testing
+
+To run the test suite and verify code coverage, first install the necessary development dependencies:
+
+```bash
+pip install -e . pytest pytest-cov pytest-asyncio pyyaml nicegui
+```
+
+Then, run `pytest` with coverage reporting:
+
+```bash
+PYTHONPATH=src python3 -m pytest tests/ --cov=structui --cov-report=term-missing
+```

{structui-0.2.0 → structui-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "structui"
-version = "0.2.0"
+version = "0.3.0"
 description = "A format-agnostic, schema-driven, hierarchical configuration UI."
 readme = "README.md"
 authors = [

{structui-0.2.0 → structui-0.3.0}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+

{structui-0.2.0 → structui-0.3.0}/src/structui/app.py

@@ -4,7 +4,7 @@ from structui.ui import StructUI
 from structui.state import AppState
 from structui.schema import SchemaManager
 
-def run_app(data_dir: str = ".", schema_filepath: str = ".structui_schema.yaml", port: int = 8080, dark_mode: Optional[bool] = False):
+def run_app(data_dir: str = ".", schema_filepath: str = ".structui_schema.yaml", port: int = 8080, dark_mode: bool = False):
     schema_manager = SchemaManager(schema_filepath)
     try:
         app_state = AppState(data_dir, schema_manager)

{structui-0.2.0 → structui-0.3.0}/src/structui/cli.py

@@ -16,5 +16,5 @@ def main():
         print(f"Error starting StructUI: {e}", file=sys.stderr)
         sys.exit(1)
 
-if __name__ in {"__main__", "__mp_main__"}:
+if __name__ in {"__main__", "__mp_main__"}:  # pragma: no cover
     main()

{structui-0.2.0 → structui-0.3.0}/src/structui/file_picker.py

@@ -7,8 +7,8 @@ from nicegui import events, ui
 
 class LocalFilePicker(ui.dialog):
 
-    def __init__(self, directory: str, *,
-                 upper_limit: Optional[str] = ..., multiple: bool = False, show_hidden_files: bool = False,
+    def __init__(self, directory: str, *, allowed_extensions: Optional[list] = None,
+                 upper_limit: Optional[str] = None, multiple: bool = False, show_hidden_files: bool = False,
                  dirs_only: bool = False) -> None:
         """Local File Picker
 
@@ -29,6 +29,7 @@ class LocalFilePicker(ui.dialog):
             self.upper_limit = Path(directory if upper_limit == ... else upper_limit).expanduser().resolve()
         self.show_hidden_files = show_hidden_files
         self.dirs_only = dirs_only
+        self.allowed_extensions = allowed_extensions
 
         with self, ui.card():
             self.add_drives_toggle()
@@ -57,7 +58,11 @@ class LocalFilePicker(ui.dialog):
             paths = [p for p in paths if not p.name.startswith('.')]
         if self.dirs_only:
             paths = [p for p in paths if p.is_dir()]
+        elif self.allowed_extensions:
+            allowed_exts = [ext.lower() if ext.startswith('.') else f'.{ext.lower()}' for ext in self.allowed_extensions]
+            paths = [p for p in paths if p.is_dir() or p.suffix.lower() in allowed_exts]
         paths.sort(key=lambda p: p.name.lower())
+
         paths.sort(key=lambda p: not p.is_dir())
 
         self.grid.options['rowData'] = [

{structui-0.2.0 → structui-0.3.0}/src/structui/parser.py

@@ -1,5 +1,5 @@
 import os
-import yaml
+import yaml  # type: ignore
 import json
 import xml.etree.ElementTree as ET
 from abc import ABC, abstractmethod

{structui-0.2.0 → structui-0.3.0}/src/structui/schema.py

@@ -1,5 +1,5 @@
 import os
-from typing import Dict, Any
+from typing import Dict, Any, Optional
 from .parser import get_parser
 
 class SchemaManager:
@@ -22,7 +22,7 @@ class SchemaManager:
         """Safely fetch metadata for a property key."""
         return self.schema_meta.get(key, {})
 
-    def get_default_val_for_type(self, type_str: str) -> Any:
+    def get_default_val_for_type(self, type_str: Optional[str]) -> Any:
         """Returns a sensible default value based on the given schema type."""
         if type_str == 'boolean': return False
         if type_str in ['integer', 'number', 'float']: return 0
@@ -88,9 +88,9 @@ class SchemaManager:
                         current_schema_key = meta.get('list_item_type', current_schema_key)
             else:
                 current_schema_key = p
-        return current_schema_key
+        return str(current_schema_key)
 
-    def get_label_key_for_schema(self, schema_key: str) -> str:
+    def get_label_key_for_schema(self, schema_key: str) -> Optional[str]:
         """Finds which sub-property should be dynamically used as the naming label for UI containers."""
         if schema_key and schema_key in self.schema_meta:
             meta = self.get_meta(schema_key)
@@ -99,12 +99,12 @@ class SchemaManager:
             for child in meta.get('allowed_children', []):
                 if child in self.schema_meta and self.schema_meta[child].get('is_label', False):
                     return child
-        return None
+        return ''
 
     def get_item_label(self, item_data: Any, item_path: str, root_data: Any, default_label: str) -> str:
         """Agnostically determines the display label for an object via schema rules."""
         if not isinstance(item_data, dict):
-            return default_label
+            return default_label or ''
             
         schema_key = self.get_schema_key_for_path(item_path, root_data)
         label_key = self.get_label_key_for_schema(schema_key)
@@ -120,4 +120,4 @@ class SchemaManager:
             if isinstance(v, str):
                 return v
                 
-        return default_label
+        return default_label or ''

{structui-0.2.0 → structui-0.3.0}/src/structui/state.py

@@ -88,7 +88,7 @@ class AppState:
             return self.config_data
             
         keys = path.split('/')[1:]
-        curr = self.config_data
+        curr: Any = self.config_data
         
         try:
             for key in keys:

{structui-0.2.0 → structui-0.3.0}/src/structui/ui.py

@@ -9,17 +9,17 @@ from .file_picker import LocalFilePicker
 class StructUI:
     """The central view abstraction for managing the hierarchical NiceGUI visualization."""
 
-    def __init__(self, state: AppState, schema_manager: SchemaManager, dark_mode: bool = None):
+    def __init__(self, state: AppState, schema_manager: SchemaManager, dark_mode: bool = False):
         self.state = state
         self.schema_manager = schema_manager
         
-        self.selected_path = {"value": "root"}
-        self.tree = None
-        self.editor_scroll_area = None
-        self.footer_pane = None
-        self.dark_mode = None
+        self.selected_path: dict[str, Any] = {"value": "root"}
+        self.tree: Any = None
+        self.editor_scroll_area: Any = None
+        self.footer_pane: Any = None
+        self.dark_mode: Any = None
         self.initial_dark_mode = dark_mode
-        self.save_btn = None
+        self.save_btn: Any = None
 
     def get_allowed_options(self, path: str, data_node: Any) -> List[Dict[str, str]]:
         schema_key = self.schema_manager.get_schema_key_for_path(path, self.state.config_data)
@@ -58,8 +58,8 @@ class StructUI:
         return allowed_options
 
     def build_tree_nodes(self, data: Any, path: str = "root", name: str = "Configurations") -> Dict[str, Any]:
-        node = {'id': path, 'label': name}
-        children = []
+        node: Dict[str, Any] = {'id': path, 'label': name}
+        children: list[Dict[str, Any]] = []
         node['allowed'] = self.get_allowed_options(path, data)
         has_prims = False
         
@@ -162,17 +162,17 @@ class StructUI:
         if opt_type == 'dict_key':
             if isinstance(data_node, dict):
                 k = option.get('key')
-                meta_type = self.schema_manager.get_meta(k).get('type')
+                meta_type = self.schema_manager.get_meta(str(k)).get('type')
                 if meta_type == 'list':
                     data_node[k] = []
                 elif meta_type in ['container', 'dict']:
                     data_node[k] = {}
-                elif meta_type == 'bool':
+                elif meta_type in ['bool', 'boolean']:
                     data_node[k] = False
-                elif meta_type in ['int', 'number', 'float']:
+                elif meta_type in ['int', 'integer', 'number', 'float']:
                     data_node[k] = 0
                 else:
-                    data_node[k] = ""
+                    data_node[k] = self.schema_manager.get_default_val_for_type(meta_type)
         elif opt_type == 'custom_dict':
             if isinstance(data_node, dict):
                 with ui.dialog() as dialog, ui.card().classes('min-w-[300px]'):
@@ -209,15 +209,22 @@ class StructUI:
         if not path:
             path = "root"
         self.selected_path["value"] = path
+        assert self.editor_scroll_area is not None
+
         self.editor_scroll_area.clear()
         self.update_footer(None)
 
         data_node = self.state.get_data_by_path(path)
         if data_node is None:
+            assert self.editor_scroll_area is not None
+
             with self.editor_scroll_area:
                 ui.label("This node no longer exists or was deleted.").classes('text-red-500 mt-10 text-lg font-bold')
             return 
 
+        assert self.editor_scroll_area is not None
+
+
         with self.editor_scroll_area:
             # INTERACTIVE BREADCRUMBS
             parts = path.split('/')
@@ -275,14 +282,23 @@ class StructUI:
             props_container = ui.column().classes('w-full gap-4')
             
             def render_primitive_input(k, v, parent_node):
-                def make_on_change(prop_key=k):
+                meta = self.schema_manager.get_meta(str(k))
+
+                def make_on_change(prop_key=k, prop_type=meta.get('type')):
                     def handler(e):
-                        self.state.set_data_by_path(self.selected_path["value"], str(prop_key), e.value)
+                        val = getattr(e, 'value', getattr(getattr(e, 'sender', None), 'value', None))
+                        if prop_type == 'integer' and val is not None and val != '':
+                            try: val = int(float(val))
+                            except ValueError: pass
+                        elif prop_type in ['number', 'float'] and val is not None and val != '':
+                            try: val = float(val)
+                            except ValueError: pass
+
+                        self.state.set_data_by_path(self.selected_path["value"], str(prop_key), val)
                         self.state.commit()
                         self.update_save_btn_state()
                     return handler
                     
-                meta = self.schema_manager.get_meta(str(k))
                 is_required = meta.get('required', False)
                 label_text = f"{k} *" if is_required else str(k)
                 options = meta.get('options')
@@ -294,8 +310,43 @@ class StructUI:
                         inp = ui.select(safe_options, value=v, label=label_text).classes('flex-grow').on_value_change(make_on_change())
                     elif isinstance(v, bool):
                         inp = ui.switch(text=label_text, value=v).on_value_change(make_on_change())
-                    elif isinstance(v, (int, float)):
-                        inp = ui.number(label=label_text, value=v).classes('flex-grow').on_value_change(make_on_change())
+                    elif meta.get('type') == 'file':
+                        async def pick_file(k=k, val=v):
+                            result = await LocalFilePicker(directory=self.state.data_dir, multiple=False, show_hidden_files=True, allowed_extensions=meta.get('extensions', []))
+                            if result:
+                                self.state.set_data_by_path(self.selected_path["value"], str(k), result[0])
+                                self.state.commit()
+                                self.update_save_btn_state()
+                                self.refresh_tree_and_editor()
+
+                        inp = ui.input(label=label_text, value=str(v)).classes('flex-grow').on_value_change(make_on_change())
+                        ui.button(icon='folder_open', on_click=pick_file).props('flat round size=sm').tooltip('Select File')
+                    elif isinstance(v, float) or (isinstance(v, int) and type(v) is not bool and meta.get('type') != 'integer'):
+                        inp = ui.input(type='number', label=label_text, value=str(v)).classes('flex-grow').on('blur', make_on_change())
+                    elif isinstance(v, int) and type(v) is not bool:
+                        # For integers, we add a Dec/Hex toggle switch
+                        with ui.row().classes('flex-grow items-center gap-2 flex-nowrap'):
+                            is_hex = getattr(self, f'_is_hex_{k}_{self.selected_path["value"].replace("/", "_")}', False)
+
+                            def toggle_hex(e, key=k, path_val=self.selected_path["value"]):
+                                setattr(self, f'_is_hex_{key}_{path_val.replace("/", "_")}', e.value)
+                                self.refresh_tree_and_editor()
+
+                            hex_toggle = ui.switch('Hex', value=is_hex).on_value_change(toggle_hex)
+
+                            if is_hex:
+                                hex_val = hex(v) if isinstance(v, int) else ""
+                                def on_hex_change(e, pk=k):
+                                    try:
+                                        new_val = int(e.value, 16) if e.value else 0
+                                        self.state.set_data_by_path(self.selected_path["value"], str(pk), new_val)
+                                        self.state.commit()
+                                        self.update_save_btn_state()
+                                    except ValueError:
+                                        pass
+                                inp = ui.input(label=label_text, value=hex_val).classes('flex-grow').on_value_change(on_hex_change)
+                            else:
+                                inp = ui.input(type='number', label=label_text, value=str(v)).classes('flex-grow').on('blur', make_on_change())
                     else:
                         inp = ui.input(label=label_text, value=str(v)).classes('flex-grow').on_value_change(make_on_change())
                         

{structui-0.2.0 → structui-0.3.0}/src/structui/xml_parser.py

@@ -18,7 +18,7 @@ def _parse_element(element: ET.Element, current_schema: Optional[Dict[str, Any]]
     if text_content:
         result["#text"] = text_content
         
-    child_groups = {}
+    child_groups: dict = {}
     for child in element:
         child_schema = None
         if current_schema and "schema" in current_schema and child.tag in current_schema["schema"]:

{structui-0.2.0 → structui-0.3.0}/src/structui.egg-info/PKG-INFO

@@ -1,62 +1,76 @@
-Metadata-Version: 2.4
-Name: structui
-Version: 0.2.0
-Summary: A format-agnostic, schema-driven, hierarchical configuration UI.
-Author: structui contributors
-License: MIT
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: nicegui>=1.4.0
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: pywin32>=300; sys_platform == "win32"
-
-# StructUI
-
-[![PyPI version](https://img.shields.io/pypi/v/structui.svg)](https://pypi.org/project/structui/)
-[![CI](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml)
-[![CD](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-StructUI is a format-agnostic, schema-driven, hierarchical configuration UI engine built in Python. Designed as a flexible architectural backbone, it parses standard configuration files (YAML, JSON, CSV, XML) and dynamically generates a live web-based property editor based on constraints and metadata defined in a schema file.
-
-The architecture is explicitly decoupled, making it readily extensible to strict domain-specific specifications (e.g., AUTOSAR configurators) and agent-driven programmatic workflows.
-
-## Features
-
-- **Pillar A: Format-Agnostic Parsers:** cleanly separate UI generation from underlying data formats. Out-of-the-box support for YAML, JSON, and XML (including schema-driven arrays and attributes), with abstract base classes extensible to CSV and others.
-- **Pillar B: Hierarchical UI:** Dynamic tree-based rendering with full support for multidimensional containers, dynamic polymorphic list additions, and node mapping. Powered natively by NiceGUI.
-- **Pillar C: Data Validity:** Enforces schema metadata strictly at the UI layer. Missing fields gracefully populate via defaults, required flags trigger locking, and nested typings are continuously evaluated.
-- **Pillar D: Extensibility & Programmatic Control:** Decomposed core logic (App, Parser, State, Schema, UI) allowing external tools and wrappers (e.g. CLI, Agent Workflows) to invoke the editor or inject properties safely.
-
-## Installation
-
-### From PyPI (recommended)
-
-```bash
-pip install structui
-```
-
-### From Source (development)
-
-```bash
-git clone https://github.com/MoSaeedHammad/structui.git
-cd structui
-pip install -e .
-```
-
-## Quick Start
-
-Launch the editor in the current directory against your local configuration files by simply typing:
-
-```bash
-structui --dir . --schema .structui_schema.yaml --port 8080
-```
+Metadata-Version: 2.4
+Name: structui
+Version: 0.3.0
+Summary: A format-agnostic, schema-driven, hierarchical configuration UI.
+Author: structui contributors
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: nicegui>=1.4.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: pywin32>=300; sys_platform == "win32"
+
+# StructUI
+
+[![PyPI version](https://img.shields.io/pypi/v/structui.svg)](https://pypi.org/project/structui/)
+[![CI](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/ci.yml)
+[![CD](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml/badge.svg)](https://github.com/MoSaeedHammad/structui/actions/workflows/publish.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+StructUI is a format-agnostic, schema-driven, hierarchical configuration UI engine built in Python. Designed as a flexible architectural backbone, it parses standard configuration files (YAML, JSON, CSV, XML) and dynamically generates a live web-based property editor based on constraints and metadata defined in a schema file.
+
+The architecture is explicitly decoupled, making it readily extensible to strict domain-specific specifications (e.g., AUTOSAR configurators) and agent-driven programmatic workflows.
+
+## Features
+
+- **Pillar A: Format-Agnostic Parsers:** cleanly separate UI generation from underlying data formats. Out-of-the-box support for YAML, JSON, and XML (including schema-driven arrays and attributes), with abstract base classes extensible to CSV and others.
+- **Pillar B: Hierarchical UI:** Dynamic tree-based rendering with full support for multidimensional containers, dynamic polymorphic list additions, and node mapping. Powered natively by NiceGUI.
+- **Pillar C: Data Validity:** Enforces schema metadata strictly at the UI layer. Missing fields gracefully populate via defaults, required flags trigger locking, and nested typings are continuously evaluated.
+- **Pillar D: Extensibility & Programmatic Control:** Decomposed core logic (App, Parser, State, Schema, UI) allowing external tools and wrappers (e.g. CLI, Agent Workflows) to invoke the editor or inject properties safely.
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install structui
+```
+
+### From Source (development)
+
+```bash
+git clone https://github.com/MoSaeedHammad/structui.git
+cd structui
+pip install -e .
+```
+
+## Quick Start
+
+Launch the editor in the current directory against your local configuration files by simply typing:
+
+```bash
+structui --dir . --schema .structui_schema.yaml --port 8080
+```
+
+## Testing
+
+To run the test suite and verify code coverage, first install the necessary development dependencies:
+
+```bash
+pip install -e . pytest pytest-cov pytest-asyncio pyyaml nicegui
+```
+
+Then, run `pytest` with coverage reporting:
+
+```bash
+PYTHONPATH=src python3 -m pytest tests/ --cov=structui --cov-report=term-missing
+```

{structui-0.2.0 → structui-0.3.0}/src/structui.egg-info/SOURCES.txt

@@ -17,7 +17,6 @@ src/structui.egg-info/requires.txt
 src/structui.egg-info/top_level.txt
 tests/test_app.py
 tests/test_cli.py
-tests/test_cli_entry.py
 tests/test_coverage_boost.py
 tests/test_file_picker.py
 tests/test_final_gap.py
@@ -25,5 +24,9 @@ tests/test_parser.py
 tests/test_schema.py
 tests/test_state.py
 tests/test_ui.py
+tests/test_ui_blur.py
+tests/test_ui_coverage.py
 tests/test_ui_extra.py
+tests/test_ui_extra2.py
+tests/test_ui_final.py
 tests/test_xml_parser.py