wordlift-sdk 2.10.3__py3-none-any.whl → 2.11.0__py3-none-any.whl

wordlift_sdk/validation/generator.py

@@ -6,7 +6,7 @@ import argparse
 import html as html_lib
 import re
 from dataclasses import dataclass
-from datetime import datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Iterable
 
@@ -173,6 +173,10 @@ def _write_feature(feature: FeatureData, output_path: Path, overwrite: bool) ->
     if output_path.exists() and not overwrite:
         return False
 
+    scoped_list_item = None
+    if "ItemList" in feature.types and "ListItem" in feature.types:
+        scoped_list_item = feature.types["ListItem"]
+
     lines: list[str] = []
     slug = output_path.stem
     prefix_base = f"https://wordlift.io/shacl/google/{slug}/"
@@ -181,13 +185,17 @@ def _write_feature(feature: FeatureData, output_path: Path, overwrite: bool) ->
     lines.append("@prefix schema: <http://schema.org/> .")
     lines.append("")
     lines.append(f"# Source: {feature.url}")
-    lines.append(f"# Generated: {datetime.utcnow().isoformat(timespec='seconds')}Z")
+    lines.append(
+        f"# Generated: {datetime.now(timezone.utc).isoformat(timespec='seconds')}Z"
+    )
     lines.append(
         "# Notes: required properties => errors; recommended properties => warnings."
     )
     lines.append("")
 
     for type_name in sorted(feature.types.keys()):
+        if scoped_list_item and type_name == "ListItem":
+            continue
         bucket = feature.types[type_name]
         shape_name = f":google_{type_name}Shape"
         lines.append(shape_name)
@@ -195,6 +203,36 @@ def _write_feature(feature: FeatureData, output_path: Path, overwrite: bool) ->
         lines.append(f"  sh:targetClass schema:{type_name} ;")
 
         for prop in sorted(bucket["required"]):
+            if (
+                scoped_list_item
+                and type_name == "ItemList"
+                and prop == "itemListElement"
+            ):
+                lines.append("  sh:property [")
+                lines.append("    sh:path schema:itemListElement ;")
+                lines.append("    sh:minCount 1 ;")
+                lines.append("    sh:node [")
+                lines.append("      a sh:NodeShape ;")
+                lines.append("      sh:class schema:ListItem ;")
+                for item_prop in sorted(scoped_list_item["required"]):
+                    item_path = _prop_path(item_prop)
+                    lines.append("      sh:property [")
+                    lines.append(f"        sh:path {item_path} ;")
+                    lines.append("        sh:minCount 1 ;")
+                    lines.append("      ] ;")
+                for item_prop in sorted(scoped_list_item["recommended"]):
+                    item_path = _prop_path(item_prop)
+                    lines.append("      sh:property [")
+                    lines.append(f"        sh:path {item_path} ;")
+                    lines.append("        sh:minCount 1 ;")
+                    lines.append("        sh:severity sh:Warning ;")
+                    lines.append(
+                        f'        sh:message "Recommended by Google: {item_prop}." ;'
+                    )
+                    lines.append("      ] ;")
+                lines.append("    ] ;")
+                lines.append("  ] ;")
+                continue
             path = _prop_path(prop)
             lines.append("  sh:property [")
             lines.append(f"    sh:path {path} ;")
@@ -202,6 +240,12 @@ def _write_feature(feature: FeatureData, output_path: Path, overwrite: bool) ->
             lines.append("  ] ;")
 
         for prop in sorted(bucket["recommended"]):
+            if (
+                scoped_list_item
+                and type_name == "ItemList"
+                and prop == "itemListElement"
+            ):
+                continue
             path = _prop_path(prop)
             lines.append("  sh:property [")
             lines.append(f"    sh:path {path} ;")
@@ -381,7 +425,9 @@ def generate_schema_shacls(output_file: Path, overwrite: bool) -> int:
     lines.append(f"@prefix schema: <{SCHEMA_DATA}> .")
     lines.append("")
     lines.append(f"# Source: {SCHEMA_JSONLD_URL}")
-    lines.append(f"# Generated: {datetime.utcnow().isoformat(timespec='seconds')}Z")
+    lines.append(
+        f"# Generated: {datetime.now(timezone.utc).isoformat(timespec='seconds')}Z"
+    )
     lines.append(
         "# Notes: schema.org grammar checks only; all constraints are warnings."
     )

wordlift_sdk/validation/shacls/google-carousel.ttl

@@ -3,7 +3,7 @@
 @prefix schema: <http://schema.org/> .
 
 # Source: https://developers.google.com/search/docs/appearance/structured-data/carousel
-# Generated: 2026-01-13T11:23:16Z
+# Generated: 2026-02-04T18:12:24+00:00Z
 # Notes: required properties => errors; recommended properties => warnings.
 
 :google_ItemListShape
@@ -12,26 +12,29 @@
   sh:property [
     sh:path schema:itemListElement ;
     sh:minCount 1 ;
-  ] ;
-.
-
-:google_ListItemShape
-  a sh:NodeShape ;
-  sh:targetClass schema:ListItem ;
-  sh:property [
-    sh:path schema:item ;
-    sh:minCount 1 ;
-  ] ;
-  sh:property [
-    sh:path schema:name ;
-    sh:minCount 1 ;
-  ] ;
-  sh:property [
-    sh:path schema:position ;
-    sh:minCount 1 ;
-  ] ;
-  sh:property [
-    sh:path schema:url ;
-    sh:minCount 1 ;
+    sh:node [
+      a sh:NodeShape ;
+      sh:class schema:ListItem ;
+      sh:property [
+        sh:path schema:item ;
+        sh:minCount 1 ;
+      ] ;
+      sh:property [
+        sh:path ( schema:item schema:name ) ;
+        sh:minCount 1 ;
+      ] ;
+      sh:property [
+        sh:path ( schema:item schema:url ) ;
+        sh:minCount 1 ;
+      ] ;
+      sh:property [
+        sh:path schema:position ;
+        sh:minCount 1 ;
+      ] ;
+      sh:property [
+        sh:path schema:url ;
+        sh:minCount 1 ;
+      ] ;
+    ] ;
   ] ;
 .

{wordlift_sdk-2.10.3.dist-info → wordlift_sdk-2.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wordlift-sdk
-Version: 2.10.3
+Version: 2.11.0
 Summary: 
 Author: David Riccitelli
 Author-email: david@wordlift.io
@@ -118,6 +118,10 @@ Override the web page import callback by placing `web_page_import_protocol.py` w
 
 Add `.ttl.liquid` files under `data/templates`. Templates render with `account` fields available (e.g., `{{ account.dataset_uri }}`) and are uploaded before URL handling begins.
 
+## Validation
+
+SHACL validation utilities and generated Google Search Gallery shapes are included. Carousel `ListItem` requirements are scoped under `ItemList` when both types are present to avoid enforcing carousel constraints on non-carousel lists (for example, `BreadcrumbList`).
+
 ## Testing
 
 ```bash
@@ -129,4 +133,3 @@ poetry run pytest
 
 - [Google Sheets Lookup](docs/google_sheets_lookup.md): Utility for O(1) lookups from Google Sheets.
 
-

{wordlift_sdk-2.10.3.dist-info → wordlift_sdk-2.11.0.dist-info}/RECORD

@@ -103,13 +103,13 @@ wordlift_sdk/utils/get_me.py,sha256=-mr0DscVWEDFvgBYtmgND3_gIuh2q7kfD-OiqrYwLJU,
 wordlift_sdk/utils/html_converter.py,sha256=MGdXQg2EAhI2K7CWtbIzZip08clVPUgL84Xt_xxa-h4,1945
 wordlift_sdk/utils/import_url.py,sha256=KiUFkU4mRfd7YWFlLoz5bB13AgPURV8Km8H05LxevCI,1299
 wordlift_sdk/validation/__init__.py,sha256=cR_8BggTFb6SYCFYGMESY12gYo0i8D6E8gMZcGwaPkw,203
-wordlift_sdk/validation/generator.py,sha256=vdL1tT-TMK0Rdx88DuLVALrz1TU9wLnYXNxx4tdS518,14659
+wordlift_sdk/validation/generator.py,sha256=0pylpxk8vOoN7dq2gVlGBJwz5uqYxPi78AxGVr0GJEE,16638
 wordlift_sdk/validation/shacl.py,sha256=tWBde7KUMhW2ectmAP1cEBcsIBGQ3Z1sQrANESDU__M,6299
 wordlift_sdk/validation/shacls/__init__.py,sha256=5YWoHfTB4SKFDKz3KXqFnDrxqDy-YACu0zIn_GkT6Mk,29
 wordlift_sdk/validation/shacls/google-article.ttl,sha256=FpAu-0CZsmDb8hswN45YU6l0QPng6hqU-JX7VSDiUyU,3774
 wordlift_sdk/validation/shacls/google-book.ttl,sha256=Tdfr9TNWTv_ttH2wFYHt20K4KaIaCJpcj_RXAWy2BYI,13517
 wordlift_sdk/validation/shacls/google-breadcrumb.ttl,sha256=rCeUoTQ3OwtIMjW94oEno33xhHOsKv5tGc8Sr1zG5Og,807
-wordlift_sdk/validation/shacls/google-carousel.ttl,sha256=5_8yUGidwsGqg7gjbLRCArfmZf6f78RRiGRJhuDEeN0,858
+wordlift_sdk/validation/shacls/google-carousel.ttl,sha256=_rIgw4W0DU6O8nf_wi916APFKQrKoo_itPyHdF7XUMU,1042
 wordlift_sdk/validation/shacls/google-carousels-beta.ttl,sha256=TKevYHEaK1s0bZ1hr03TbcDpfD1nJcQpWFOQtEa5tro,7189
 wordlift_sdk/validation/shacls/google-course.ttl,sha256=J3SEn5nVaeNIqTf3cp8WZYRSMR5Q6Scjds4a7mZsgqw,1010
 wordlift_sdk/validation/shacls/google-dataset.ttl,sha256=-hdkj1umQNJduaRvSKhl9LZ5A6j7i0sJqhH7ZEbUX3U,3758
@@ -162,6 +162,6 @@ wordlift_sdk/workflow/url_handler/default_url_handler.py,sha256=irMoJftx9Gyq-8HQ
 wordlift_sdk/workflow/url_handler/search_console_url_handler.py,sha256=uOwD4t009-cA9JI7ZtbYhCGRwjhLzDpBNTWHERPnNqI,2698
 wordlift_sdk/workflow/url_handler/url_handler.py,sha256=meyOpWVhLk2NcbtUOO_V0z6_T9q-D3pD7kWQCRioYh0,129
 wordlift_sdk/workflow/url_handler/web_page_import_url_handler.py,sha256=xQiy-fgFj_dWKFFBNWeodAGhIMJQereSPdgnjK-Crmo,3529
-wordlift_sdk-2.10.3.dist-info/METADATA,sha256=_MeJKaaZKTzlseM2TswdotwXq1VIMr0ZXypAYIGRHzI,5184
-wordlift_sdk-2.10.3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-wordlift_sdk-2.10.3.dist-info/RECORD,,
+wordlift_sdk-2.11.0.dist-info/METADATA,sha256=1wxWzz4h7tW1xyuCO720ihilDgEll-Kmv-RZN-Fdt9o,5467
+wordlift_sdk-2.11.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+wordlift_sdk-2.11.0.dist-info/RECORD,,