0.9.4

Author: offerrall

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.9.4] - 2025-12-08
+
+### Added
+- **Python Enum Support**: Full support for Python `Enum` types as dropdown menus.
+  - Use standard Python enums as type hints: `def func(theme: Theme)`
+  - Supports `str`, `int`, and `float` enum values
+  - Automatic conversion from form values back to Enum members
+  - Your function receives the actual Enum member (e.g., `Theme.LIGHT`), not just the string value
+  - Access both `.name` and `.value` properties in your function
+  - Optional enums with `Theme | None` syntax
+  - Compatible with all enum features (methods, properties, iteration)
+  - Add tests covering enum handling, conversion, and edge cases
+  
+### Benefits
+- **Type Safety**: Full IDE autocomplete and type checking
+- **Reusability**: Define enum once, use across multiple functions
+- **Rich Semantics**: Access both enum name and value, add custom methods
+- **Clean Code**: No repetition of `Literal['option1', 'option2']` in every function signature
+
 ## [0.9.3] - 2025-11-30
 
 ### Fixed

README.md

@@ -1,8 +1,8 @@
-# Func To Web 0.9.3
+# Func To Web 0.9.4
 
 [![PyPI version](https://img.shields.io/pypi/v/func-to-web.svg)](https://pypi.org/project/func-to-web/)
 [![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
-[![Tests](https://img.shields.io/badge/tests-454%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-514%20passing-brightgreen.svg)](tests/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 > **Type hints → Web UI.** Minimal-boilerplate web apps from Python functions.
@@ -53,7 +53,7 @@ Complete documentation with **examples and screenshots** for each feature:
 - **[File Uploads](https://offerrall.github.io/FuncToWeb/files/)**: `ImageFile`, `DataFile`, `TextFile`, `DocumentFile`
 - **[Dynamic Lists](https://offerrall.github.io/FuncToWeb/lists/)**: `list[Type]` with add/remove buttons
 - **[Optional Fields](https://offerrall.github.io/FuncToWeb/optional/)**: `Type | None` with toggle switches
-- **[Dropdowns](https://offerrall.github.io/FuncToWeb/dropdowns/)**: Static `Literal['a', 'b']` or Dynamic `Literal[func]`
+- **[Dropdowns](https://offerrall.github.io/FuncToWeb/dropdowns/)**: Static (`Literal`, `Enum`) or Dynamic (`Literal[func]`)
 - **[Validation](https://offerrall.github.io/FuncToWeb/constraints/)**: Pydantic constraints (min/max, regex, list validation)
 </td>
 <td width="50%">

docs/dropdowns.md

@@ -9,7 +9,6 @@ Use dropdown menus for fixed or dynamic selection options.
 <div markdown>
 
 Use `Literal` for fixed dropdown options:
-
 ```python
 from typing import Literal
 from func_to_web import run
@@ -35,14 +34,48 @@ All options must be literals (strings, numbers, booleans) and all options must b
 
 </div>
 
+## Enum Dropdowns
+
+<div class="grid" markdown>
+
+<div markdown>
+
+Use Python `Enum` for reusable dropdowns with named constants:
+```python
+from enum import Enum
+from func_to_web import run
+
+class Theme(Enum):
+    LIGHT = 'light'
+    DARK = 'dark'
+    AUTO = 'auto'
+
+def preferences(theme: Theme):
+    # Receives Theme.LIGHT, not just 'light'
+    return f"Selected: {theme.name} = {theme.value}"
+
+run(preferences)
+```
+
+Your function receives the Enum member with access to both `.name` and `.value`. Useful when the same options are used in multiple functions.
+
+</div>
+
+<div markdown>
+
+![Dropdowns](images/enum_drop.jpg)
+
+</div>
+
+</div>
+
 ## Dynamic Dropdowns
 
 <div class="grid" markdown>
 
 <div markdown>
 
 Use functions inside `Literal` to generate options dynamically at runtime:
-
 ```python
 from typing import Literal
 from random import sample

docs/images/enum_drop.jpg

@@ -0,0 +1,22 @@
+from enum import Enum
+from func_to_web import run
+
+class Theme(Enum):
+    LIGHT = 'light'
+    DARK = 'dark'
+    AUTO = 'auto'
+
+class Priority(Enum):
+    LOW = 1
+    MEDIUM = 2
+    HIGH = 3
+
+def create_task(
+    theme: Theme,
+    priority: Priority
+):
+    """Your function receives the Enum member"""
+    # Access both name and value
+    return f"Theme: {theme.name} ({theme.value}), Priority: {priority.value}"
+
+run(create_task)

examples/enum_dropdowns.py

@@ -1,6 +1,7 @@
 import inspect
 from dataclasses import dataclass
 from typing import Annotated, Literal, get_args, get_origin, Callable, Any
+from enum import Enum
 import types
 
 from pydantic import TypeAdapter
@@ -67,6 +68,10 @@ class ParamInfo:
             - Contains Field constraints for the list container
             - None if no list-level constraints
             Example: Field(min_items=2, max_items=5)
+        enum_type: The original Enum type if parameter was an Enum.
+            - None for non-Enum parameters
+            - Stored to convert string back to Enum in validation
+            - Example: For `color: Color`, stores the Color Enum class
     """
     type: type
     default: Any = None
@@ -76,6 +81,7 @@ class ParamInfo:
     optional_enabled: bool = False
     is_list: bool = False
     list_field_info: Any = None
+    enum_type: None = None
 
 def analyze(func: Callable[..., Any]) -> dict[str, ParamInfo]:
     """Analyze a function's signature and extract parameter metadata.
@@ -110,6 +116,7 @@ def analyze(func: Callable[..., Any]) -> dict[str, ParamInfo]:
         is_optional = False
         optional_default_enabled = None  # None = auto, True = enabled, False = disabled
         is_list = False
+        enum_type = None
 
         # 1. Extract base type from Annotated (OUTER level)
         # This could be constraints for the list itself
@@ -239,6 +246,27 @@ def analyze(func: Callable[..., Any]) -> dict[str, ParamInfo]:
             else:
                 t = type(None)
 
+        # 5b. Handle Enum types
+        elif isinstance(t, type) and issubclass(t, Enum):
+            opts = tuple(e.value for e in t)
+
+            if not opts:
+                raise ValueError(f"'{name}': Enum must have at least one value")
+
+            types_set = {type(v) for v in opts}
+            if len(types_set) > 1:
+                raise TypeError(f"'{name}': Enum values must be same type")
+
+            if default is not None:
+                if not isinstance(default, t):
+                    raise TypeError(f"'{name}': default must be {t.__name__} instance")
+                default = default.value
+            
+            enum_type = t
+            
+            f = Literal[opts]
+            t = types_set.pop()
+        
         # 6. Validate base type
         if t not in VALID:
             raise TypeError(f"'{name}': {t} not supported")
@@ -289,6 +317,6 @@ def analyze(func: Callable[..., Any]) -> dict[str, ParamInfo]:
             # No default, start disabled
             final_optional_enabled = False
 
-        result[name] = ParamInfo(t, default, f, dynamic_func, is_optional, final_optional_enabled, is_list, list_f)
+        result[name] = ParamInfo(t, default, f, dynamic_func, is_optional, final_optional_enabled, is_list, list_f, enum_type)
 
     return result

func_to_web/analyze_function.py

@@ -88,17 +88,25 @@ def validate_params(form_data: dict, params_info: dict[str, ParamInfo]) -> dict:
                 value = float(value)
 
             # Only validate against options if Literal is NOT dynamic
-            # Dynamic literals can change between form render and submit
             if info.dynamic_func is None:
-                # Static literal - validate against fixed options
                 opts = get_args(info.field_info)
                 if value not in opts:
                     raise ValueError(f"'{name}': value '{value}' not in {opts}")
-            # else: Dynamic literal - skip validation, trust the value from the form
+            
+            # Convert string → Enum if needed
+            if info.enum_type is not None:
+                # Find the Enum member with this value
+                for member in info.enum_type:
+                    if member.value == value:
+                        value = member
+                        break
+                else:
+                    # This shouldn't happen if validation passed
+                    raise ValueError(f"'{name}': invalid value for {info.enum_type.__name__}")
 
             validated[name] = value
             continue
-        
+                
         # Expand shorthand hex colors (#RGB -> #RRGGBB)
         if value and isinstance(value, str) and value.startswith('#') and len(value) == 4:
             value = '#' + ''.join(c*2 for c in value[1:])

func_to_web/validate_params.py

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "func-to-web"
-version = "0.9.3"
+version = "0.9.4"
 authors = [
     {name = "Beltrán Offerrall"}
 ]