wordlift-sdk 2.10.3__tar.gz → 2.11.0__tar.gz

{wordlift_sdk-2.10.3 → wordlift_sdk-2.11.0}/PKG-INFO

@@ -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 → wordlift_sdk-2.11.0}/README.md

@@ -90,6 +90,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
@@ -100,4 +104,3 @@ poetry run pytest
 ## Documentation
 
 - [Google Sheets Lookup](docs/google_sheets_lookup.md): Utility for O(1) lookups from Google Sheets.
-

{wordlift_sdk-2.10.3 → wordlift_sdk-2.11.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "wordlift-sdk"
-version = "2.10.3"
+version = "2.11.0"
 description = ""
 authors = ["David Riccitelli <david@wordlift.io>"]
 readme = "README.md"

{wordlift_sdk-2.10.3 → wordlift_sdk-2.11.0}/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-2.11.0/wordlift_sdk/validation/shacls/google-carousel.ttl

@@ -0,0 +1,40 @@
+@prefix : <https://wordlift.io/shacl/google/google-carousel/> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix schema: <http://schema.org/> .
+
+# Source: https://developers.google.com/search/docs/appearance/structured-data/carousel
+# Generated: 2026-02-04T18:12:24+00:00Z
+# Notes: required properties => errors; recommended properties => warnings.
+
+:google_ItemListShape
+  a sh:NodeShape ;
+  sh:targetClass schema:ItemList ;
+  sh:property [
+    sh:path schema:itemListElement ;
+    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/wordlift_sdk/validation/shacls/google-carousel.ttl

@@ -1,37 +0,0 @@
-@prefix : <https://wordlift.io/shacl/google/google-carousel/> .
-@prefix sh: <http://www.w3.org/ns/shacl#> .
-@prefix schema: <http://schema.org/> .
-
-# Source: https://developers.google.com/search/docs/appearance/structured-data/carousel
-# Generated: 2026-01-13T11:23:16Z
-# Notes: required properties => errors; recommended properties => warnings.
-
-:google_ItemListShape
-  a sh:NodeShape ;
-  sh:targetClass schema:ItemList ;
-  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 ;
-  ] ;
-.