ssc_codegen 0.23.0__tar.gz → 0.24.0__tar.gz

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssc_codegen
-Version: 0.23.0
+Version: 0.24.0
 Summary: Python-dsl code converter to html parser for web scraping 
 Project-URL: Documentation, https://github.com/vypivshiy/selector_schema_codegen#readme
 Project-URL: Issues, https://github.com/vypivshiy/selector_schema_codegen/issues

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ssc_codegen"
-version = "0.23.0"
+version = "0.24.0"
 description = "Python-dsl code converter to html parser for web scraping "
 readme = "README.md"
 requires-python = ">=3.10"

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/ssc_codegen/ast/struct.py

@@ -291,10 +291,12 @@ class RequestConfig(Node):
 class ErrorResponse(Node):
     """
     Error response mapping for type=rest struct.
-    DSL: @error <status> <SchemaName> [field=value ...]
+    DSL: @error <status> <SchemaName> [keys...] [field=value ...]
 
     status: HTTP status code [100..599].
     schema_name: json schema reference for deserialised error body.
+    required_keys: key names that must exist in the JSON body (positional args).
+        Error triggers on matching status + all keys present.
     conditions: field=value pairs checked against the parsed JSON body.
         Keys are dot-paths (e.g. "response.success", "data.0.type").
         When non-empty, the error triggers on matching status + all conditions.
@@ -302,6 +304,7 @@ class ErrorResponse(Node):
 
     status: int = 0
     schema_name: str = ""
+    required_keys: list[str] = field(default_factory=list)
     conditions: dict[str, Any] = field(default_factory=dict)
 
 

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/ssc_codegen/converters/js_pure.py

@@ -348,6 +348,8 @@ def pre_typedef_field(node: a.TypeDefField, ctx: ConverterContext):
 
 def _js_err_subclass_name(struct_name: str, err) -> str:
     base = f"{to_pascal_case(struct_name)}Err{err.status}"
+    for key in err.required_keys:
+        base += to_pascal_case(key.replace(".", "_").replace("-", "_"))
     if err.conditions:
         for key in err.conditions:
             base += to_pascal_case(key.replace(".", "_").replace("-", "_"))
@@ -369,6 +371,8 @@ def _js_resolve_path_expr(body_var: str, path: str) -> str:
 def _js_condition_check_expr(err) -> str:
     """Build a compound JS condition expression for @error field conditions."""
     parts = []
+    for key in err.required_keys:
+        parts.append(f"{key!r} in _body")
     for path, value in err.conditions.items():
         lhs = _js_resolve_path_expr("_body", path)
         if isinstance(value, bool):
@@ -440,8 +444,10 @@ def _emit_dispatch_err_js(node: a.Struct, ctx: ConverterContext) -> list[str]:
     i3 = i2 + ctx.indent_char  # nested (if ...)
 
     errors = node.errors
-    status_errors = [e for e in errors if not e.conditions]
-    field_errors = [e for e in errors if e.conditions]
+    status_errors = [
+        e for e in errors if not e.conditions and not e.required_keys
+    ]
+    field_errors = [e for e in errors if e.conditions or e.required_keys]
 
     lines: list[str] = [
         f"{i1}static _dispatchErr(_status, _headers, _body) {{",

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/ssc_codegen/converters/py_helpers.py

@@ -257,6 +257,8 @@ def rest_utilities(node: a.Node) -> list[str]:
 def err_subclass_name(struct_name: str, err: a.ErrorResponse) -> str:
     """Naming: ``<Struct>Err<Status>[<ConditionKeys>]``."""
     base = f"{to_pascal_case(struct_name)}Err{err.status}"
+    for key in err.required_keys:
+        base += to_pascal_case(key.replace(".", "_").replace("-", "_"))
     if err.conditions:
         for key in err.conditions:
             base += to_pascal_case(key.replace(".", "_").replace("-", "_"))
@@ -304,6 +306,8 @@ def _resolve_path_expr(body_var: str, path: str) -> str:
 def _condition_check_expr(err: a.ErrorResponse) -> str:
     """Build a compound condition expression for an @error's field conditions."""
     parts: list[str] = []
+    for key in err.required_keys:
+        parts.append(f"{key!r} in _body")
     for path, value in err.conditions.items():
         lhs = _resolve_path_expr("_body", path)
         if isinstance(value, bool):
@@ -325,8 +329,10 @@ def emit_dispatch_err_py(node: a.Struct, ctx: ConverterContext) -> list[str]:
     i4 = i3 + ctx.indent_char
 
     errors = node.errors
-    status_errors = [e for e in errors if not e.conditions]
-    field_errors = [e for e in errors if e.conditions]
+    status_errors = [
+        e for e in errors if not e.conditions and not e.required_keys
+    ]
+    field_errors = [e for e in errors if e.conditions or e.required_keys]
     union_type = _rest_err_union_type(node)
 
     lines: list[str] = [

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/ssc_codegen/core/linting.py

@@ -776,6 +776,26 @@ def lint_reserved_field(
                 message=f"@check {check_name or ''}must contain 'to-bool' to guarantee BOOL return type",
                 code="E100",
             )
+    elif field_name == "@error":
+        err_args = lint.get_args(node)
+        if len(err_args) < 2:
+            lint.error(
+                node,
+                message="@error requires both status and schema name",
+                code="E001",
+                hint="example: @error 404 ApiError",
+            )
+            return
+        positional_keys = set(err_args[2:])
+        property_keys = set(node.properties.keys())
+        duplicates = positional_keys & property_keys
+        if duplicates:
+            lint.error(
+                node,
+                message=f"@error has duplicate keys: {', '.join(sorted(duplicates))}",
+                code="E400",
+                hint="each key must be either a positional arg (presence check) or a property (value check)",
+            )
 
 
 def lint_regular_field(

{ssc_codegen-0.23.0 → ssc_codegen-0.24.0}/ssc_codegen/core/struct_parser.py

@@ -146,6 +146,14 @@ def parse_struct(
             schema_name = str(
                 ctx.property_defines.get(node.args[1].value, node.args[1].value)
             )
+            required_keys: list[str] = []
+            for i in range(2, len(node.args)):
+                key = str(
+                    ctx.property_defines.get(
+                        node.args[i].value, node.args[i].value
+                    )
+                )
+                required_keys.append(key)
             conditions: dict[str, Any] = {}
             for k, v in node.properties.items():
                 key = str(ctx.property_defines.get(k, k))
@@ -155,6 +163,7 @@ def parse_struct(
                 parent=parent,
                 status=status_int,
                 schema_name=schema_name,
+                required_keys=required_keys,
                 conditions=conditions,
             )
             parent.body.append(err)