fh-pydantic-form 0.3.6__py3-none-any.whl → 0.3.8__py3-none-any.whl

{fh_pydantic_form-0.3.6.dist-info → fh_pydantic_form-0.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fh-pydantic-form
-Version: 0.3.6
+Version: 0.3.8
 Summary: a library to turn any pydantic BaseModel object into a fasthtml/monsterui input form
 Project-URL: Homepage, https://github.com/Marcura/fh-pydantic-form
 Project-URL: Repository, https://github.com/Marcura/fh-pydantic-form
@@ -18,9 +18,9 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
-Requires-Dist: monsterui>=1.0.19
+Requires-Dist: monsterui>=1.0.29
 Requires-Dist: pydantic>=2.0
-Requires-Dist: python-fasthtml>=0.12.12
+Requires-Dist: python-fasthtml>=0.12.29
 Description-Content-Type: text/markdown
 
 # fh-pydantic-form
@@ -480,6 +480,83 @@ form_renderer = PydanticForm(
 
 This automatic default injection means you can safely exclude fields that shouldn't be user-editable while maintaining data integrity.
 
+### SkipJsonSchema Fields
+
+`fh-pydantic-form` provides advanced handling for `SkipJsonSchema` fields with selective visibility control. By default, fields marked with `SkipJsonSchema` are hidden from forms, but you can selectively show specific ones using the `keep_skip_json_fields` parameter.
+
+```python
+from pydantic.json_schema import SkipJsonSchema
+
+class DocumentModel(BaseModel):
+    title: str
+    content: str
+    
+    # Hidden by default - system fields
+    document_id: SkipJsonSchema[str] = Field(
+        default_factory=lambda: f"doc_{uuid4().hex[:12]}",
+        description="Internal document ID"
+    )
+    created_at: SkipJsonSchema[datetime.datetime] = Field(
+        default_factory=datetime.datetime.now,
+        description="Creation timestamp"
+    )
+    version: SkipJsonSchema[int] = Field(
+        default=1, 
+        description="Document version"
+    )
+
+# Normal form - all SkipJsonSchema fields hidden
+form_normal = PydanticForm("doc_form", DocumentModel)
+
+# Admin form - selectively show some SkipJsonSchema fields
+form_admin = PydanticForm(
+    "admin_form", 
+    DocumentModel,
+    keep_skip_json_fields=[
+        "document_id",  # Show document ID
+        "version",      # Show version number
+        # created_at remains hidden
+    ]
+)
+```
+
+#### Nested SkipJsonSchema Fields
+
+The feature supports dot notation for nested objects and list items:
+
+```python
+class Address(BaseModel):
+    street: str
+    city: str
+    # Hidden system field
+    internal_id: SkipJsonSchema[str] = Field(default_factory=lambda: f"addr_{uuid4().hex[:8]}")
+
+class UserModel(BaseModel):
+    name: str
+    main_address: Address
+    other_addresses: List[Address]
+
+# Show specific nested SkipJsonSchema fields
+form = PydanticForm(
+    "user_form",
+    UserModel,
+    keep_skip_json_fields=[
+        "main_address.internal_id",        # Show main address ID
+        "other_addresses.internal_id",     # Show all address IDs in the list
+    ]
+)
+```
+
+**Key Features:**
+- **Hidden by default:** SkipJsonSchema fields are automatically excluded from forms
+- **Selective visibility:** Use `keep_skip_json_fields` to show specific fields
+- **Nested support:** Access nested fields with dot notation (`"main_address.internal_id"`)
+- **List support:** Show fields in all list items (`"addresses.internal_id"`)
+- **Smart defaults:** Non-kept fields use model defaults, kept fields retain initial values
+- **Admin interfaces:** Perfect for admin panels or debugging where you need to see system fields
+
+See `examples/complex_example.py` for a comprehensive demonstration of SkipJsonSchema field handling.
+
 ## Refreshing & Resetting
 
 Forms support dynamic refresh and reset functionality:
@@ -824,6 +901,38 @@ comparison_form.register_routes(app)
 - **Metrics Integration**: Right side typically shows LLM output quality scores
 - **Flexible Layout**: Responsive design works on desktop and mobile
 - **Form Validation**: Standard validation works with either form
+- **Intelligent List Copying**: Copy lists between forms with automatic length adjustment
+
+### Copying Between Forms
+
+The ComparisonForm provides granular copy functionality at multiple levels. When you enable copy buttons (via `copy_left=True` or `copy_right=True`), each field, nested model, and list item gets its own copy button for maximum flexibility:
+
+```python
+# Enable copy buttons (copy FROM right TO left)
+comparison_form = ComparisonForm(
+    name="extraction_evaluation",
+    left_form=left_form,
+    right_form=right_form,
+    left_label="Ground Truth",
+    right_label="LLM Output",
+    copy_left=True,  # Show copy buttons on right form to copy TO left
+)
+```
+
+**Copy Granularity Levels:**
+
+The copy feature works at five different levels of granularity:
+
+1. **Individual Fields** - Copy a single field value (e.g., `name`, `price`, `status`)
+
+2. **Nested BaseModel (Entire Object)** - Copy all fields within a nested model at once
+
+3. **Individual Fields in Nested Models** - Copy a specific field within a nested object
+
+4. **Full List Fields** - Copy entire lists with automatic length adjustment
+
+5. **Individual List Items** - Add a single item from one list to another
+
 
 ### Common Patterns
 
@@ -1007,6 +1116,7 @@ form_renderer = PydanticForm(
 | `disabled_fields` | `Optional[List[str]]` | `None` | List of specific field names to disable |
 | `label_colors` | `Optional[Dict[str, str]]` | `None` | Mapping of field names to CSS colors or Tailwind classes |
 | `exclude_fields` | `Optional[List[str]]` | `None` | List of field names to exclude from rendering (auto-injected on submission) |
+| `keep_skip_json_fields` | `Optional[List[str]]` | `None` | List of SkipJsonSchema field paths to selectively show (supports dot notation for nested fields) |
 | `spacing` | `SpacingValue` | `"normal"` | Spacing theme: `"normal"`, `"compact"`, or `SpacingTheme` enum |
 | `metrics_dict` | `Optional[Dict[str, Dict]]` | `None` | Field metrics for highlighting and tooltips |
 
@@ -1025,7 +1135,7 @@ form_renderer = PydanticForm(
 | Method | Purpose |
 |--------|---------|
 | `render_inputs()` | Generate the HTML form inputs (without `<form>` wrapper) |
-| `with_initial_values(initial_values)` | Create a new form instance with same configuration but different initial values |
+| `with_initial_values(initial_values, metrics_dict=None)` | Create a new form instance with same configuration but different initial values |
 | `refresh_button(text=None, **kwargs)` | Create a refresh button component |
 | `reset_button(text=None, **kwargs)` | Create a reset button component |
 | `register_routes(app)` | Register HTMX endpoints for list manipulation |

{fh_pydantic_form-0.3.6.dist-info → fh_pydantic_form-0.3.8.dist-info}/RECORD

@@ -1,17 +1,17 @@
 fh_pydantic_form/__init__.py,sha256=uPN0pwErHoe69tDoCDdIYD_iCslMKRgfYw6pvL4McHE,4608
 fh_pydantic_form/color_utils.py,sha256=M0HSXX0i-lSHkcsgesxw7d3PEAnLsZ46i_STymZAM_k,18271
-fh_pydantic_form/comparison_form.py,sha256=Y-OKAjTxMiixBC05SK1ofZ_A3zkvjUFp8tTE-_wUn60,21660
+fh_pydantic_form/comparison_form.py,sha256=UuA9QOM9V1hsg3oxZrO99Jp4xIi1if7uEuPN9U-SLqg,63793
 fh_pydantic_form/constants.py,sha256=-N9wzkibFNn-V6cO8iWTQ7_xBvwSr2hBdq-m3apmW4M,169
 fh_pydantic_form/defaults.py,sha256=9vV0f4PapTOgqNsIxoW6rEbpYO66O4uiKvpd6hzR1-M,6189
-fh_pydantic_form/field_renderers.py,sha256=twAqHvWkDL6M-HRcdi_JrR2BgzkPmMyF_vojId5ABa0,83574
-fh_pydantic_form/form_parser.py,sha256=DsOMiCXRRHswL37Vqv7bvMv3Q7nQdXp0oP3_ZoIJfVc,26172
-fh_pydantic_form/form_renderer.py,sha256=G_pO3rQrv3lCpiqfZfPkT96duDLp466CWU1PTOy9U4E,36619
+fh_pydantic_form/field_renderers.py,sha256=SYBXbFTrnZ9qQnEongrMUMaTu0OWKVluiZiA4lK8A3U,92747
+fh_pydantic_form/form_parser.py,sha256=LKeGiCeyYJ0eIZE6oETcxl1DpKjk1MpoCSh_VAvUgGk,29701
+fh_pydantic_form/form_renderer.py,sha256=looOW7nabPeQH3R7t5ZO_QMpBfoQtTO48p0QqZIhpfA,39175
 fh_pydantic_form/list_path.py,sha256=AA8bmDmaYy4rlGIvQOOZ0fP2tgcimNUB2Re5aVGnYc8,5182
 fh_pydantic_form/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fh_pydantic_form/registry.py,sha256=b5zIjOpfmCUCs2njgp4PdDu70ioDIAfl49oU-Nf2pg4,4810
-fh_pydantic_form/type_helpers.py,sha256=JUzHT8YrWj2_g7f_Wr2GL9i3BgP1zZftFrrO8xDPeis,7409
+fh_pydantic_form/type_helpers.py,sha256=C6Oem1frgj_T_CqiE-9yyVKI7YpFFEAKAGVXe04OkJU,8245
 fh_pydantic_form/ui_style.py,sha256=UPK5OBwUVVTLnfvQ-yKukz2vbKZaT_GauaNB7OGc-Uw,3848
-fh_pydantic_form-0.3.6.dist-info/METADATA,sha256=cdQwkkDEOFsqTvZVbGTIZjhgRk_vx4PK0MKtds79oYU,38420
-fh_pydantic_form-0.3.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fh_pydantic_form-0.3.6.dist-info/licenses/LICENSE,sha256=AOi2eNK3D2aDycRHfPRiuACZ7WPBsKHTV2tTYNl7cls,577
-fh_pydantic_form-0.3.6.dist-info/RECORD,,
+fh_pydantic_form-0.3.8.dist-info/METADATA,sha256=MdCq-9oxeFcKs3FZ6FY7MAQJWF55p-NiyMvJL9Nuu9w,42391
+fh_pydantic_form-0.3.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fh_pydantic_form-0.3.8.dist-info/licenses/LICENSE,sha256=AOi2eNK3D2aDycRHfPRiuACZ7WPBsKHTV2tTYNl7cls,577
+fh_pydantic_form-0.3.8.dist-info/RECORD,,