fh-matui 0.9.16__py3-none-any.whl → 0.9.18__py3-none-any.whl

fh_matui/__init__.py

@@ -1 +1 @@
-__version__ = "0.9.16"
+__version__ = "0.9.17"

fh_matui/_modidx.py

@@ -162,6 +162,7 @@ d = { 'settings': { 'branch': 'master',
                                     'fh_matui.datatable.DataTableResource._wrap_response': ( 'datatable.html#datatableresource._wrap_response',
                                                                                              'fh_matui/datatable.py'),
                                     'fh_matui.datatable._action_menu': ('datatable.html#_action_menu', 'fh_matui/datatable.py'),
+                                    'fh_matui.datatable._group_data': ('datatable.html#_group_data', 'fh_matui/datatable.py'),
                                     'fh_matui.datatable._is_htmx_request': ('datatable.html#_is_htmx_request', 'fh_matui/datatable.py'),
                                     'fh_matui.datatable._page_size_select': ('datatable.html#_page_size_select', 'fh_matui/datatable.py'),
                                     'fh_matui.datatable._safe_int': ('datatable.html#_safe_int', 'fh_matui/datatable.py'),

fh_matui/components.py

@@ -685,8 +685,8 @@ def Select(*options, label=None, value='', name='', id=None, placeholder=None, c
     
     select_el = fc.Select(*opt_elements, **select_attrs)
     
-    # Build field wrapper
-    field_cls = ['field', 'border', 'round']
+    # Build field wrapper - 'max' ensures full width like LabelInput
+    field_cls = ['field', 'border', 'round', 'max']
     if label: field_cls.append('label')
     if cls: field_cls.extend(normalize_tokens(cls))
     cls_str = stringify(field_cls)

fh_matui/datatable.py

@@ -23,8 +23,9 @@ from .components import *
 #| code-fold: true
 from math import ceil
 from urllib.parse import urlencode
-from typing import Callable, Optional, Any
+from typing import Callable, Optional, Any, Union
 from dataclasses import asdict, is_dataclass
+from collections import OrderedDict
 
 # Default page size options
 PAGE_SIZES = [5, 10, 20, 50]
@@ -81,6 +82,25 @@ def _safe_int(value, default):
     except (TypeError, ValueError):
         return default
 
+
+def _group_data(data: list[dict], group_key: str) -> list[tuple[Any, list[dict]]]:
+    """
+    Group data by a column value, preserving input order.
+    
+    Args:
+        data: List of row dicts
+        group_key: Column key to group by
+        
+    Returns:
+        List of (group_value, [rows...]) tuples in order of first appearance
+    """
+    groups = OrderedDict()
+    for row in data:
+        val = row.get(group_key)
+        groups.setdefault(val, []).append(row)
+    return list(groups.items())
+
+
 def table_state_from_request(req, page_sizes=None):
     """
     Extract pagination state from request query params.
@@ -217,7 +237,12 @@ def DataTable(
     # BeerCSS table styling options
     table_style: str = 'border',      # border, stripes, min, fixed (can combine: 'border stripes')
     space: str = 'small-space',       # no-space, small-space, medium-space, large-space
-    align: str = None                 # left-align, right-align, center-align (None = default left)
+    align: str = None,                # left-align, right-align, center-align (None = default left)
+    # Grouping options
+    group_by: str = None,             # Column key to group rows by
+    group_header_format: Callable[[Any], str] = None,  # Format group header text
+    group_header_cls: str = 'surface-container',       # CSS classes for group header row
+    group_header_icon: Union[str, Callable[[Any], str]] = None  # Icon name or callable
 ):
     """
     Generic data table with server-side pagination, search, and row actions.
@@ -226,6 +251,12 @@ def DataTable(
         table_style: Table visual style - 'border', 'stripes', 'min', 'fixed' or combine like 'border stripes'
         space: Row spacing - 'no-space', 'small-space', 'medium-space', 'large-space'  
         align: Text alignment - 'left-align', 'right-align', 'center-align' (None for default)
+    
+    Grouping:
+        group_by: Column key to group rows by (e.g., 'transaction_date')
+        group_header_format: Callable to format group value for display (e.g., lambda d: d.strftime('%B %d, %Y'))
+        group_header_cls: CSS classes for group header rows (default: 'surface-container')
+        group_header_icon: Icon name (str) or callable returning icon name per group value
     """
     # Defaults
     crud_ops = crud_ops or {"create": False, "update": False, "delete": False}
@@ -254,9 +285,11 @@ def DataTable(
     header_keys = [col["key"] for col in columns] + ["actions"]
     header_labels = [col.get("label", col["key"]) for col in columns] + [""]
     
-    # Build table rows
-    table_rows = []
-    for row in data:
+    # Calculate colspan for group headers (all visible columns)
+    group_colspan = len(header_keys)
+    
+    # Helper to build a single data row
+    def build_data_row(row: dict) -> Tr:
         row_id = row.get(row_id_field)
         row_dict = {}
         
@@ -283,7 +316,49 @@ def DataTable(
             container_id=container_id,
             feedback_id=feedback_id
         )
-        table_rows.append(row_dict)
+        return Tr(*[Td(row_dict.get(key, '')) for key in header_keys])
+    
+    # Helper to build a group header row
+    def build_group_header(group_value: Any) -> Tr:
+        # Format the group label
+        if group_header_format and callable(group_header_format):
+            label = group_header_format(group_value)
+        else:
+            label = str(group_value) if group_value is not None else "Ungrouped"
+        
+        # Get icon if specified
+        icon_content = None
+        if group_header_icon:
+            if callable(group_header_icon):
+                icon_name = group_header_icon(group_value)
+            else:
+                icon_name = group_header_icon
+            if icon_name:
+                icon_content = Icon(icon_name, cls="small")
+        
+        # Build header cell content
+        cell_content = []
+        if icon_content:
+            cell_content.append(icon_content)
+        cell_content.append(Span(label, cls="bold"))
+        
+        return Tr(
+            Td(*cell_content, colspan=group_colspan, cls="padding"),
+            cls=f"group-header {group_header_cls}"
+        )
+    
+    # Build table rows - grouped or flat
+    if group_by and data:
+        # Grouped rendering
+        grouped = _group_data(data, group_by)
+        tbody_rows = []
+        for group_value, group_rows in grouped:
+            tbody_rows.append(build_group_header(group_value))
+            for row in group_rows:
+                tbody_rows.append(build_data_row(row))
+    else:
+        # Flat rendering (original behavior)
+        tbody_rows = [build_data_row(row) for row in data]
     
     # Create button - use crud_enabled for callable support
     create_button = None
@@ -343,10 +418,7 @@ def DataTable(
     # Build table with proper Thead/Tbody structure
     data_table = Table(
         Thead(Tr(*[Th(label) for label in header_labels])),
-        Tbody(*[
-            Tr(*[Td(row_dict.get(key, '')) for key in header_keys])
-            for row_dict in table_rows
-        ]),
+        Tbody(*tbody_rows),
         cls=table_cls
     ) if data else Div(empty_message, cls="center-align padding")
     
@@ -517,12 +589,26 @@ class DataTableResource:
     - Auto-refresh table via HX-Trigger after mutations
     - Layout wrapper for full-page (non-HTMX) responses
     - Optional `get_count` for efficient DB-level pagination
+    - **Row grouping** with `group_by` for visual organization
     
     **Auto-registers 3 routes:**
     - `GET {base_route}` → DataTable list view
     - `GET {base_route}/action` → FormModal for create/edit/view/delete
     - `POST {base_route}/save` → Save handler with hooks
     
+    **Row Grouping:**
+    
+    Group rows by a column value with formatted section headers:
+    
+    ```python
+    DataTableResource(
+        ...,
+        group_by="transaction_date",
+        group_header_format=lambda d: d.strftime("%B %d, %Y"),
+        group_header_icon="calendar_today"
+    )
+    ```
+    
     **DB-Level Pagination (Recommended for large datasets):**
     
     For efficient pagination, provide both `get_all` (returning paginated rows) 
@@ -580,7 +666,12 @@ class DataTableResource:
         layout_wrapper: Callable[[Any, Any], Any] = None,  # (content, req) -> wrapped
         # Custom generators
         id_generator: Callable[[], Any] = None,
-        timestamp_fields: dict = None
+        timestamp_fields: dict = None,
+        # Grouping options
+        group_by: str = None,                              # Column key to group rows by
+        group_header_format: Callable[[Any], str] = None,  # Format group header text
+        group_header_cls: str = "surface-container",       # CSS classes for group header row
+        group_header_icon: Union[str, Callable[[Any], str]] = None  # Icon name or callable
     ):
         self.app = app
         self.base_route = base_route.rstrip("/")
@@ -598,6 +689,12 @@ class DataTableResource:
         self.create_label = create_label
         self.empty_message = empty_message
         
+        # Grouping options
+        self.group_by = group_by
+        self.group_header_format = group_header_format
+        self.group_header_cls = group_header_cls
+        self.group_header_icon = group_header_icon
+        
         # Determine CRUD ops from provided functions
         if crud_ops is None:
             self.crud_ops = {
@@ -796,7 +893,12 @@ class DataTableResource:
             page_sizes=self.page_sizes,
             search_placeholder=self.search_placeholder,
             create_label=self.create_label,
-            empty_message=self.empty_message
+            empty_message=self.empty_message,
+            # Grouping options
+            group_by=self.group_by,
+            group_header_format=self.group_header_format,
+            group_header_cls=self.group_header_cls,
+            group_header_icon=self.group_header_icon
         )
         
         # Wrap table in auto-refresh container

{fh_matui-0.9.16.dist-info → fh_matui-0.9.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fh-matui
-Version: 0.9.16
+Version: 0.9.18
 Summary: material-ui for fasthtml
 Home-page: https://github.com/abhisheksreesaila/fh-matui
 Author: abhishek sreesaila
@@ -84,22 +84,24 @@ responsive web interfaces entirely in Python — no JavaScript required.
 
 fh-matui includes 15+ pre-configured Material Design 3 color themes:
 
-| Theme                 | Preview | Theme                 | Preview |
-|-----------------------|---------|-----------------------|---------|
-| `MatTheme.red`        | 🔴      | `MatTheme.pink`       | 🩷      |
-| `MatTheme.purple`     | 🟣      | `MatTheme.deepPurple` | 💜      |
-| `MatTheme.indigo`     | 🔵      | `MatTheme.blue`       | 💙      |
-| `MatTheme.lightBlue`  | 🩵      | `MatTheme.cyan`       | 🌊      |
-| `MatTheme.teal`       | 🩶      | `MatTheme.green`      | 💚      |
-| `MatTheme.lightGreen` | 🍀      | `MatTheme.lime`       | 💛      |
-| `MatTheme.yellow`     | 🌟      | `MatTheme.amber`      | 🧡      |
-| `MatTheme.orange`     | 🟠      | `MatTheme.deepOrange` | 🔶      |
+| Theme                  | Preview | Theme                  | Preview |
+|------------------------|---------|------------------------|---------|
+| `MatTheme.red`         | 🔴      | `MatTheme.pink`        | 🩷      |
+| `MatTheme.purple`      | 🟣      | `MatTheme.deep_purple` | 💜      |
+| `MatTheme.indigo`      | 🔵      | `MatTheme.blue`        | 💙      |
+| `MatTheme.light_blue`  | 🩵      | `MatTheme.cyan`        | 🌊      |
+| `MatTheme.teal`        | 🩶      | `MatTheme.green`       | 💚      |
+| `MatTheme.light_green` | 🍀      | `MatTheme.lime`        | 💛      |
+| `MatTheme.yellow`      | 🌟      | `MatTheme.amber`       | 🧡      |
+| `MatTheme.orange`      | 🟠      | `MatTheme.deep_orange` | 🔶      |
+| `MatTheme.brown`       | 🟤      | `MatTheme.grey`        | ⚪      |
+| `MatTheme.blue_grey`   | 🔘      |                        |         |
 
 **Usage:**
 
 ``` python
 # Choose your theme
-app, rt = fast_app(hdrs=[MatTheme.deepPurple.headers()])
+app, rt = fast_app(hdrs=[MatTheme.deep_purple.headers()])
 ```
 
 ## 🚀 Quick Start
@@ -120,7 +122,6 @@ def home():
         Card(
             H3("Welcome to fh-matui!"),
             P("Build beautiful Material Design apps with Python."),
-            FormField("email", label="Email", type="email"),
             Button("Get Started", cls="primary"),
         ),
         cls="padding"
@@ -145,8 +146,10 @@ styling
 
 1.  **`MatTheme.indigo.headers()`** - Loads BeerCSS with the indigo
     color scheme
-2.  **`Card`** - Creates a Material Design card component with elevation
-3.  **`FormField`** - Generates a styled input with floating label
+2.  **[`Card`](https://abhisheksreesaila.github.io/fh-matui/components.html#card)** -
+    Creates a Material Design card component with elevation
+3.  **[`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield)** -
+    Generates a styled input with floating label
 4.  **`Button`** - Renders a Material Design button with ripple effects
 
 ## 📚 Module Reference
@@ -155,9 +158,9 @@ styling
 |----|----|----|
 | [Foundations](foundations.html) | Base utilities and helper functions | `BeerHeaders`, `display`, styling helpers |
 | [Core](core.html) | Theme system and styling | `MatTheme`, color presets, theme configuration |
-| [Components](components.html) | UI component library | `Button`, `Card`, `FormField`, `FormModal`, `Grid` |
+| [Components](components.html) | UI component library | `Button`, [`Card`](https://abhisheksreesaila.github.io/fh-matui/components.html#card), [`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield), [`FormModal`](https://abhisheksreesaila.github.io/fh-matui/components.html#formmodal), [`Grid`](https://abhisheksreesaila.github.io/fh-matui/components.html#grid) |
 | [App Pages](app_pages.html) | Application layouts | Navigation, sidebars, full-page layouts |
-| [Data Tables](05_table.html) | Data management components | `DataTable`, `DataTableResource`, CRUD operations |
+| [Data Tables](05_table.html) | Data management components | [`DataTable`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatable), [`DataTableResource`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatableresource), CRUD operations |
 | [Web Pages](web_pages.html) | Marketing/landing pages | Hero sections, feature grids, testimonials |
 
 ## 🛠️ Development
@@ -185,8 +188,8 @@ nbdev_prepare
 | **Component consistency** | Unified API across all components |
 | **Dark mode support** | Built-in with automatic system preference detection |
 | **Responsive design** | Mobile-first grid system and responsive utilities |
-| **Form handling** | `FormField`, `FormGrid`, `FormModal` for rapid form building |
-| **Data management** | `DataTable` and `DataTableResource` for CRUD operations |
+| **Form handling** | [`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield), [`FormGrid`](https://abhisheksreesaila.github.io/fh-matui/components.html#formgrid), [`FormModal`](https://abhisheksreesaila.github.io/fh-matui/components.html#formmodal) for rapid form building |
+| **Data management** | [`DataTable`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatable) and [`DataTableResource`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatableresource) for CRUD operations |
 
 ## 🤖 For LLM Users
 

fh_matui-0.9.18.dist-info/RECORD

@@ -0,0 +1,14 @@
+fh_matui/__init__.py,sha256=LnwynovXVEl6Umz2kNcDZKVZFDV0K6olFWasW49esS4,24
+fh_matui/_modidx.py,sha256=n9f6vJZfytT_mZBD4RpZJD4QngGf7KMeyCA6IZdvqZI,24290
+fh_matui/app_pages.py,sha256=DtaStRuYJ_oiEB2nBzMApCv0NfBkE2wUZMUfKBMhMFs,10378
+fh_matui/components.py,sha256=y00glXXR5dB4zHwCDnqXCeGiYKMETK1WO6l7Ee2Bdls,59103
+fh_matui/core.py,sha256=3j-4ot0MgmyBpsIg7qRh3-KTlRYmgVeetQhQNQPQ19E,11108
+fh_matui/datatable.py,sha256=NwyPcpltqA_wH2qo7n6SqfBLUxzBGMzDiB3he806WkA,46783
+fh_matui/foundations.py,sha256=jSJuELof3B-YeZ4jlsIV-ABpOn9Hv2Qd67o0LuBTqVY,1912
+fh_matui/web_pages.py,sha256=6l0axbrCYmqSmSGrq0qt3nPUNblArCCAy_LlN-iCsNc,35183
+fh_matui-0.9.18.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
+fh_matui-0.9.18.dist-info/METADATA,sha256=az5hNsGo71wVmtYJeXsRAb2d5uTgd-3EczRasGmsKWY,10601
+fh_matui-0.9.18.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+fh_matui-0.9.18.dist-info/entry_points.txt,sha256=zn4CR4gNTiAAxbFsCxHAf2tQhtW29_YOffjbUTgeoWI,38
+fh_matui-0.9.18.dist-info/top_level.txt,sha256=l80d5eoA2ZjqtPYwAorLMS5PiHxUxz3zKzxMJ41Xoso,9
+fh_matui-0.9.18.dist-info/RECORD,,

fh_matui-0.9.16.dist-info/RECORD

@@ -1,14 +0,0 @@
-fh_matui/__init__.py,sha256=1Trt9wiX-dulRPRdt82fqX0JH-xfZMdFAJe6dA4gaQM,24
-fh_matui/_modidx.py,sha256=x9AV-LcrfUpON34QN4WnbO-E_GKQ2PhdlY5Zh0NEAT0,24162
-fh_matui/app_pages.py,sha256=DtaStRuYJ_oiEB2nBzMApCv0NfBkE2wUZMUfKBMhMFs,10378
-fh_matui/components.py,sha256=nbqVBqehyjUYnNlkBwbenKzmlsZ7Ah6i19G4eHoksf0,59053
-fh_matui/core.py,sha256=3j-4ot0MgmyBpsIg7qRh3-KTlRYmgVeetQhQNQPQ19E,11108
-fh_matui/datatable.py,sha256=DRgA6nmm4h_QCMmd6CJK8QluRJ0S7c8j9H-yHjpUjBo,42590
-fh_matui/foundations.py,sha256=jSJuELof3B-YeZ4jlsIV-ABpOn9Hv2Qd67o0LuBTqVY,1912
-fh_matui/web_pages.py,sha256=6l0axbrCYmqSmSGrq0qt3nPUNblArCCAy_LlN-iCsNc,35183
-fh_matui-0.9.16.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
-fh_matui-0.9.16.dist-info/METADATA,sha256=RR9vOYzH4hsAqBvlzh2s4kTBvvDXQcfMt1W0DIkWT64,9523
-fh_matui-0.9.16.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-fh_matui-0.9.16.dist-info/entry_points.txt,sha256=zn4CR4gNTiAAxbFsCxHAf2tQhtW29_YOffjbUTgeoWI,38
-fh_matui-0.9.16.dist-info/top_level.txt,sha256=l80d5eoA2ZjqtPYwAorLMS5PiHxUxz3zKzxMJ41Xoso,9
-fh_matui-0.9.16.dist-info/RECORD,,