webtap-tool 0.6.0__tar.gz → 0.7.0__tar.gz

{webtap_tool-0.6.0 → webtap_tool-0.7.0}/CHANGELOG.md

@@ -15,6 +15,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [0.7.0] - 2025-10-10
+
+### Added
+
+### Changed
+- **BREAKING**: `to_model()` now requires `model_name` parameter for explicit class naming
+  - Old: `to_model(123, "models/product.py", json_path="Data[0]")`
+  - New: `to_model(123, "models/product.py", "Product", json_path="Data[0]")`
+  - Enforces best practice: always specify what you're generating
+
+### Fixed
+
+### Removed
+
 ## [0.6.0] - 2025-10-10
 
 ### Added

{webtap_tool-0.6.0 → webtap_tool-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webtap-tool
-Version: 0.6.0
+Version: 0.7.0
 Summary: Terminal-based web page inspector for AI debugging sessions
 Author-email: Fredrik Angelsen <fredrikangelsen@gmail.com>
 Classifier: Development Status :: 3 - Alpha

{webtap_tool-0.6.0 → webtap_tool-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "webtap-tool"
-version = "0.6.0"
+version = "0.7.0"
 description = "Terminal-based web page inspector for AI debugging sessions"
 readme = "README.md"
 authors = [

{webtap_tool-0.6.0 → webtap_tool-0.7.0}/src/webtap/commands/TIPS.md

@@ -26,7 +26,7 @@ body(123, "msgpack.unpackb(body)")         # Binary formats
 ```
 
 #### Tips
-- **Generate models:** `to_model({id}, "models/model.py")` - create Pydantic models from JSON
+- **Generate models:** `to_model({id}, "models/model.py", "Model")` - create Pydantic models from JSON
 - **Chain requests:** `body({id}, "httpx.get(json.loads(body)['next_url']).text[:100]")`
 - **Parse XML:** `body({id}, "ElementTree.fromstring(body).find('.//title').text")`
 - **Extract forms:** `body({id}, "[f['action'] for f in bs4(body, 'html.parser').find_all('form')]")`
@@ -38,13 +38,14 @@ Generate Pydantic v2 models from JSON response bodies for reverse engineering AP
 
 #### Examples
 ```python
-to_model(123, "models/product.py")                        # Generate from full response
-to_model(123, "models/customer.py", json_path="Data[0]")  # Extract nested object
-to_model(123, "/tmp/model.py", json_path="items")         # Extract array items
+to_model(123, "models/product.py", "Product")                              # Generate from full response
+to_model(123, "models/customers/group.py", "CustomerGroup", "Data[0]")     # Extract nested + domain structure
+to_model(123, "/tmp/item.py", "Item", "items[0]")                          # Extract array items
 ```
 
 #### Tips
 - **Check structure first:** `body({id})` - preview JSON before generating
+- **Domain organization:** Use paths like `"models/customers/group.py"` for structure
 - **Extract nested data:** Use `json_path="Data[0]"` to extract specific objects
 - **Array items:** Extract first item with `json_path="items[0]"` for model generation
 - **Auto-cleanup:** Generated models use snake_case fields and modern type hints (list, dict, | None)
@@ -80,7 +81,7 @@ Show network requests with full data.
 
 #### Tips
 - **Analyze responses:** `body({id})` - fetch response body
-- **Generate models:** `to_model({id}, "models/model.py")` - create Pydantic models from JSON
+- **Generate models:** `to_model({id}, "models/model.py", "Model")` - create Pydantic models from JSON
 - **Parse HTML:** `body({id}, "bs4(body, 'html.parser').find('title').text")`
 - **Extract JSON:** `body({id}, "json.loads(body)['data']")`
 - **Find patterns:** `body({id}, "re.findall(r'/api/\\w+', body)")`

{webtap_tool-0.6.0 → webtap_tool-0.7.0}/src/webtap/commands/to_model.py

@@ -12,12 +12,13 @@ mcp_desc = get_mcp_description("to_model")
 
 
 @app.command(display="markdown", fastmcp={"type": "tool", "description": mcp_desc} if mcp_desc else {"type": "tool"})
-def to_model(state, response: int, output: str, json_path: str = None) -> dict:  # pyright: ignore[reportArgumentType]
+def to_model(state, response: int, output: str, model_name: str, json_path: str = None) -> dict:  # pyright: ignore[reportArgumentType]
     """Generate Pydantic model from response body using datamodel-codegen.
 
     Args:
         response: Response row ID from network() table
-        output: Output file path for generated model (e.g., "models/product.py")
+        output: Output file path for generated model (e.g., "models/customers/group.py")
+        model_name: Class name for generated model (e.g., "CustomerGroup")
         json_path: Optional JSON path to extract nested data (e.g., "Data[0]")
 
     Returns:
@@ -102,6 +103,7 @@ def to_model(state, response: int, output: str, json_path: str = None) -> dict:
             input_filename="response.json",
             output=output_path,
             output_model_type=DataModelType.PydanticV2BaseModel,
+            class_name=model_name,  # Set generated class name
             snake_case_field=True,  # Convert to snake_case
             use_standard_collections=True,  # Use list instead of List
             use_union_operator=True,  # Use | instead of Union
@@ -125,5 +127,10 @@ def to_model(state, response: int, output: str, json_path: str = None) -> dict:
 
     return success_response(
         "Model generated successfully",
-        details={"Output": str(output_path), "Fields": field_count, "Size": f"{output_path.stat().st_size} bytes"},
+        details={
+            "Class": model_name,
+            "Output": str(output_path),
+            "Fields": field_count,
+            "Size": f"{output_path.stat().st_size} bytes",
+        },
     )