wordlift-sdk 2.9.1__py3-none-any.whl → 2.10.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. wordlift_sdk/__init__.py +1 -1
  2. wordlift_sdk/render/__init__.py +30 -0
  3. wordlift_sdk/render/browser.py +132 -0
  4. wordlift_sdk/render/cleanup_options.py +24 -0
  5. wordlift_sdk/render/html_renderer.py +86 -0
  6. wordlift_sdk/render/render_options.py +21 -0
  7. wordlift_sdk/render/rendered_page.py +13 -0
  8. wordlift_sdk/render/xhtml_cleaner.py +126 -0
  9. wordlift_sdk/structured_data/__init__.py +27 -0
  10. wordlift_sdk/structured_data/agent.py +49 -0
  11. wordlift_sdk/structured_data/agent_generator.py +12 -0
  12. wordlift_sdk/structured_data/batch.py +220 -0
  13. wordlift_sdk/structured_data/constants.py +1 -0
  14. wordlift_sdk/structured_data/dataset_resolver.py +32 -0
  15. wordlift_sdk/structured_data/debug.py +23 -0
  16. wordlift_sdk/structured_data/engine.py +2875 -0
  17. wordlift_sdk/structured_data/inputs.py +58 -0
  18. wordlift_sdk/structured_data/io.py +44 -0
  19. wordlift_sdk/structured_data/materialization.py +70 -0
  20. wordlift_sdk/structured_data/models.py +48 -0
  21. wordlift_sdk/structured_data/orchestrator.py +194 -0
  22. wordlift_sdk/structured_data/rendering.py +43 -0
  23. wordlift_sdk/structured_data/schema_guide.py +17 -0
  24. wordlift_sdk/structured_data/structured_data_engine.py +58 -0
  25. wordlift_sdk/structured_data/validation.py +31 -0
  26. wordlift_sdk/structured_data/yarrrml_pipeline.py +34 -0
  27. wordlift_sdk/url_source/__init__.py +7 -2
  28. wordlift_sdk/validation/__init__.py +7 -0
  29. wordlift_sdk/validation/generator.py +446 -0
  30. wordlift_sdk/validation/shacl.py +205 -0
  31. wordlift_sdk/validation/shacls/__init__.py +1 -0
  32. wordlift_sdk/validation/shacls/google-article.ttl +148 -0
  33. wordlift_sdk/validation/shacls/google-book.ttl +660 -0
  34. wordlift_sdk/validation/shacls/google-breadcrumb.ttl +33 -0
  35. wordlift_sdk/validation/shacls/google-carousel.ttl +37 -0
  36. wordlift_sdk/validation/shacls/google-carousels-beta.ttl +291 -0
  37. wordlift_sdk/validation/shacls/google-course.ttl +43 -0
  38. wordlift_sdk/validation/shacls/google-dataset.ttl +146 -0
  39. wordlift_sdk/validation/shacls/google-discussion-forum.ttl +247 -0
  40. wordlift_sdk/validation/shacls/google-education-qa.ttl +75 -0
  41. wordlift_sdk/validation/shacls/google-employer-rating.ttl +40 -0
  42. wordlift_sdk/validation/shacls/google-event.ttl +46 -0
  43. wordlift_sdk/validation/shacls/google-factcheck.ttl +86 -0
  44. wordlift_sdk/validation/shacls/google-faqpage.ttl +38 -0
  45. wordlift_sdk/validation/shacls/google-image-license-metadata.ttl +93 -0
  46. wordlift_sdk/validation/shacls/google-job-posting.ttl +74 -0
  47. wordlift_sdk/validation/shacls/google-local-business.ttl +483 -0
  48. wordlift_sdk/validation/shacls/google-loyalty-program.ttl +61 -0
  49. wordlift_sdk/validation/shacls/google-math-solvers.ttl +63 -0
  50. wordlift_sdk/validation/shacls/google-merchant-listing.ttl +435 -0
  51. wordlift_sdk/validation/shacls/google-movie.ttl +44 -0
  52. wordlift_sdk/validation/shacls/google-organization.ttl +180 -0
  53. wordlift_sdk/validation/shacls/google-paywalled-content.ttl +34 -0
  54. wordlift_sdk/validation/shacls/google-product-snippet.ttl +121 -0
  55. wordlift_sdk/validation/shacls/google-product-variants.ttl +64 -0
  56. wordlift_sdk/validation/shacls/google-profile-page.ttl +130 -0
  57. wordlift_sdk/validation/shacls/google-qapage.ttl +195 -0
  58. wordlift_sdk/validation/shacls/google-recipe.ttl +201 -0
  59. wordlift_sdk/validation/shacls/google-return-policy.ttl +122 -0
  60. wordlift_sdk/validation/shacls/google-review-snippet.ttl +87 -0
  61. wordlift_sdk/validation/shacls/google-shipping-policy.ttl +606 -0
  62. wordlift_sdk/validation/shacls/google-software-app.ttl +40 -0
  63. wordlift_sdk/validation/shacls/google-speakable.ttl +20 -0
  64. wordlift_sdk/validation/shacls/google-vacation-rental.ttl +278 -0
  65. wordlift_sdk/validation/shacls/google-video.ttl +149 -0
  66. wordlift_sdk/validation/shacls/schemaorg-grammar.ttl +20540 -0
  67. {wordlift_sdk-2.9.1.dist-info → wordlift_sdk-2.10.2.dist-info}/METADATA +3 -1
  68. {wordlift_sdk-2.9.1.dist-info → wordlift_sdk-2.10.2.dist-info}/RECORD +69 -5
  69. {wordlift_sdk-2.9.1.dist-info → wordlift_sdk-2.10.2.dist-info}/WHEEL +0 -0
wordlift_sdk/validation/shacls/google-education-qa.ttl ADDED
@@ -0,0 +1,75 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-education-qa/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/education-qa
6
+ # Generated: 2026-01-13T11:23:22Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_QuestionShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:Question ;
12
+ sh:property [
13
+ sh:path schema:acceptedAnswer ;
14
+ sh:minCount 1 ;
15
+ ] ;
16
+ sh:property [
17
+ sh:path schema:eduQuestionType ;
18
+ sh:minCount 1 ;
19
+ ] ;
20
+ sh:property [
21
+ sh:path schema:text ;
22
+ sh:minCount 1 ;
23
+ ] ;
24
+ .
25
+
26
+ :google_QuizShape
27
+ a sh:NodeShape ;
28
+ sh:targetClass schema:Quiz ;
29
+ sh:property [
30
+ sh:path schema:acceptedAnswer ;
31
+ sh:minCount 1 ;
32
+ ] ;
33
+ sh:property [
34
+ sh:path schema:eduQuestionType ;
35
+ sh:minCount 1 ;
36
+ ] ;
37
+ sh:property [
38
+ sh:path schema:hasPart ;
39
+ sh:minCount 1 ;
40
+ ] ;
41
+ sh:property [
42
+ sh:path schema:text ;
43
+ sh:minCount 1 ;
44
+ ] ;
45
+ sh:property [
46
+ sh:path schema:about ;
47
+ sh:minCount 1 ;
48
+ sh:severity sh:Warning ;
49
+ sh:message "Recommended by Google: about." ;
50
+ ] ;
51
+ sh:property [
52
+ sh:path schema:alignmentType ;
53
+ sh:minCount 1 ;
54
+ sh:severity sh:Warning ;
55
+ sh:message "Recommended by Google: alignmentType." ;
56
+ ] ;
57
+ sh:property [
58
+ sh:path schema:educationalAlignment ;
59
+ sh:minCount 1 ;
60
+ sh:severity sh:Warning ;
61
+ sh:message "Recommended by Google: educationalAlignment." ;
62
+ ] ;
63
+ sh:property [
64
+ sh:path schema:name ;
65
+ sh:minCount 1 ;
66
+ sh:severity sh:Warning ;
67
+ sh:message "Recommended by Google: name." ;
68
+ ] ;
69
+ sh:property [
70
+ sh:path schema:targetName ;
71
+ sh:minCount 1 ;
72
+ sh:severity sh:Warning ;
73
+ sh:message "Recommended by Google: targetName." ;
74
+ ] ;
75
+ .
wordlift_sdk/validation/shacls/google-employer-rating.ttl ADDED
@@ -0,0 +1,40 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-employer-rating/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/employer-rating
6
+ # Generated: 2026-01-13T11:23:23Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_EmployerAggregateRatingShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:EmployerAggregateRating ;
12
+ sh:property [
13
+ sh:path schema:itemReviewed ;
14
+ sh:minCount 1 ;
15
+ ] ;
16
+ sh:property [
17
+ sh:path schema:ratingCount ;
18
+ sh:minCount 1 ;
19
+ ] ;
20
+ sh:property [
21
+ sh:path schema:ratingValue ;
22
+ sh:minCount 1 ;
23
+ ] ;
24
+ sh:property [
25
+ sh:path schema:reviewCount ;
26
+ sh:minCount 1 ;
27
+ ] ;
28
+ sh:property [
29
+ sh:path schema:bestRating ;
30
+ sh:minCount 1 ;
31
+ sh:severity sh:Warning ;
32
+ sh:message "Recommended by Google: bestRating." ;
33
+ ] ;
34
+ sh:property [
35
+ sh:path schema:worstRating ;
36
+ sh:minCount 1 ;
37
+ sh:severity sh:Warning ;
38
+ sh:message "Recommended by Google: worstRating." ;
39
+ ] ;
40
+ .
wordlift_sdk/validation/shacls/google-event.ttl ADDED
@@ -0,0 +1,46 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-event/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/event
6
+ # Generated: 2026-01-13T11:23:27Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_EventShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:Event ;
12
+ sh:property [
13
+ sh:path schema:address ;
14
+ sh:minCount 1 ;
15
+ ] ;
16
+ sh:property [
17
+ sh:path schema:location ;
18
+ sh:minCount 1 ;
19
+ ] ;
20
+ sh:property [
21
+ sh:path schema:name ;
22
+ sh:minCount 1 ;
23
+ ] ;
24
+ sh:property [
25
+ sh:path schema:startDate ;
26
+ sh:minCount 1 ;
27
+ ] ;
28
+ sh:property [
29
+ sh:path schema:description ;
30
+ sh:minCount 1 ;
31
+ sh:severity sh:Warning ;
32
+ sh:message "Recommended by Google: description." ;
33
+ ] ;
34
+ sh:property [
35
+ sh:path schema:endDate ;
36
+ sh:minCount 1 ;
37
+ sh:severity sh:Warning ;
38
+ sh:message "Recommended by Google: endDate." ;
39
+ ] ;
40
+ sh:property [
41
+ sh:path schema:eventStatus ;
42
+ sh:minCount 1 ;
43
+ sh:severity sh:Warning ;
44
+ sh:message "Recommended by Google: eventStatus." ;
45
+ ] ;
46
+ .
wordlift_sdk/validation/shacls/google-factcheck.ttl ADDED
@@ -0,0 +1,86 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-factcheck/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/factcheck
6
+ # Generated: 2026-01-13T11:23:25Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_ClaimShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:Claim ;
12
+ sh:property [
13
+ sh:path schema:appearance ;
14
+ sh:minCount 1 ;
15
+ sh:severity sh:Warning ;
16
+ sh:message "Recommended by Google: appearance." ;
17
+ ] ;
18
+ sh:property [
19
+ sh:path schema:author ;
20
+ sh:minCount 1 ;
21
+ sh:severity sh:Warning ;
22
+ sh:message "Recommended by Google: author." ;
23
+ ] ;
24
+ sh:property [
25
+ sh:path schema:sameAs ;
26
+ sh:minCount 1 ;
27
+ sh:severity sh:Warning ;
28
+ sh:message "Recommended by Google: sameAs." ;
29
+ ] ;
30
+ .
31
+
32
+ :google_ClaimReviewShape
33
+ a sh:NodeShape ;
34
+ sh:targetClass schema:ClaimReview ;
35
+ sh:property [
36
+ sh:path schema:claimReviewed ;
37
+ sh:minCount 1 ;
38
+ ] ;
39
+ sh:property [
40
+ sh:path schema:reviewRating ;
41
+ sh:minCount 1 ;
42
+ ] ;
43
+ sh:property [
44
+ sh:path schema:url ;
45
+ sh:minCount 1 ;
46
+ ] ;
47
+ sh:property [
48
+ sh:path schema:author ;
49
+ sh:minCount 1 ;
50
+ sh:severity sh:Warning ;
51
+ sh:message "Recommended by Google: author." ;
52
+ ] ;
53
+ .
54
+
55
+ :google_RatingShape
56
+ a sh:NodeShape ;
57
+ sh:targetClass schema:Rating ;
58
+ sh:property [
59
+ sh:path schema:alternateName ;
60
+ sh:minCount 1 ;
61
+ ] ;
62
+ sh:property [
63
+ sh:path schema:bestRating ;
64
+ sh:minCount 1 ;
65
+ sh:severity sh:Warning ;
66
+ sh:message "Recommended by Google: bestRating." ;
67
+ ] ;
68
+ sh:property [
69
+ sh:path schema:name ;
70
+ sh:minCount 1 ;
71
+ sh:severity sh:Warning ;
72
+ sh:message "Recommended by Google: name." ;
73
+ ] ;
74
+ sh:property [
75
+ sh:path schema:ratingValue ;
76
+ sh:minCount 1 ;
77
+ sh:severity sh:Warning ;
78
+ sh:message "Recommended by Google: ratingValue." ;
79
+ ] ;
80
+ sh:property [
81
+ sh:path schema:worstRating ;
82
+ sh:minCount 1 ;
83
+ sh:severity sh:Warning ;
84
+ sh:message "Recommended by Google: worstRating." ;
85
+ ] ;
86
+ .
wordlift_sdk/validation/shacls/google-faqpage.ttl ADDED
@@ -0,0 +1,38 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-faqpage/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/faqpage
6
+ # Generated: 2026-01-13T11:23:28Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_AnswerShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:Answer ;
12
+ sh:property [
13
+ sh:path schema:text ;
14
+ sh:minCount 1 ;
15
+ ] ;
16
+ .
17
+
18
+ :google_FAQPageShape
19
+ a sh:NodeShape ;
20
+ sh:targetClass schema:FAQPage ;
21
+ sh:property [
22
+ sh:path schema:mainEntity ;
23
+ sh:minCount 1 ;
24
+ ] ;
25
+ .
26
+
27
+ :google_QuestionShape
28
+ a sh:NodeShape ;
29
+ sh:targetClass schema:Question ;
30
+ sh:property [
31
+ sh:path schema:acceptedAnswer ;
32
+ sh:minCount 1 ;
33
+ ] ;
34
+ sh:property [
35
+ sh:path schema:name ;
36
+ sh:minCount 1 ;
37
+ ] ;
38
+ .
wordlift_sdk/validation/shacls/google-image-license-metadata.ttl ADDED
@@ -0,0 +1,93 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-image-license-metadata/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/image-license-metadata
6
+ # Generated: 2026-01-13T11:23:29Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_ImageObjectShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:ImageObject ;
12
+ sh:property [
13
+ sh:path schema:contentUrl ;
14
+ sh:minCount 1 ;
15
+ ] ;
16
+ sh:property [
17
+ sh:path schema:creator ;
18
+ sh:minCount 1 ;
19
+ ] ;
20
+ sh:property [
21
+ sh:path schema:acquireLicensePage ;
22
+ sh:minCount 1 ;
23
+ sh:severity sh:Warning ;
24
+ sh:message "Recommended by Google: acquireLicensePage." ;
25
+ ] ;
26
+ sh:property [
27
+ sh:path schema:copyrightNotice ;
28
+ sh:minCount 1 ;
29
+ sh:severity sh:Warning ;
30
+ sh:message "Recommended by Google: copyrightNotice." ;
31
+ ] ;
32
+ sh:property [
33
+ sh:path schema:creditText ;
34
+ sh:minCount 1 ;
35
+ sh:severity sh:Warning ;
36
+ sh:message "Recommended by Google: creditText." ;
37
+ ] ;
38
+ sh:property [
39
+ sh:path schema:license ;
40
+ sh:minCount 1 ;
41
+ sh:severity sh:Warning ;
42
+ sh:message "Recommended by Google: license." ;
43
+ ] ;
44
+ sh:property [
45
+ sh:path schema:name ;
46
+ sh:minCount 1 ;
47
+ sh:severity sh:Warning ;
48
+ sh:message "Recommended by Google: name." ;
49
+ ] ;
50
+ .
51
+
52
+ :google_PersonShape
53
+ a sh:NodeShape ;
54
+ sh:targetClass schema:Person ;
55
+ sh:property [
56
+ sh:path schema:contentUrl ;
57
+ sh:minCount 1 ;
58
+ ] ;
59
+ sh:property [
60
+ sh:path schema:creator ;
61
+ sh:minCount 1 ;
62
+ ] ;
63
+ sh:property [
64
+ sh:path schema:acquireLicensePage ;
65
+ sh:minCount 1 ;
66
+ sh:severity sh:Warning ;
67
+ sh:message "Recommended by Google: acquireLicensePage." ;
68
+ ] ;
69
+ sh:property [
70
+ sh:path schema:copyrightNotice ;
71
+ sh:minCount 1 ;
72
+ sh:severity sh:Warning ;
73
+ sh:message "Recommended by Google: copyrightNotice." ;
74
+ ] ;
75
+ sh:property [
76
+ sh:path schema:creditText ;
77
+ sh:minCount 1 ;
78
+ sh:severity sh:Warning ;
79
+ sh:message "Recommended by Google: creditText." ;
80
+ ] ;
81
+ sh:property [
82
+ sh:path schema:license ;
83
+ sh:minCount 1 ;
84
+ sh:severity sh:Warning ;
85
+ sh:message "Recommended by Google: license." ;
86
+ ] ;
87
+ sh:property [
88
+ sh:path schema:name ;
89
+ sh:minCount 1 ;
90
+ sh:severity sh:Warning ;
91
+ sh:message "Recommended by Google: name." ;
92
+ ] ;
93
+ .
wordlift_sdk/validation/shacls/google-job-posting.ttl ADDED
@@ -0,0 +1,74 @@
1
+ @prefix : <https://wordlift.io/shacl/google/google-job-posting/> .
2
+ @prefix sh: <http://www.w3.org/ns/shacl#> .
3
+ @prefix schema: <http://schema.org/> .
4
+
5
+ # Source: https://developers.google.com/search/docs/appearance/structured-data/job-posting
6
+ # Generated: 2026-01-13T11:23:31Z
7
+ # Notes: required properties => errors; recommended properties => warnings.
8
+
9
+ :google_JobPostingShape
10
+ a sh:NodeShape ;
11
+ sh:targetClass schema:JobPosting ;
12
+ sh:property [
13
+ sh:path schema:datePosted ;
14
+ sh:minCount 1 ;
15
+ ] ;
16
+ sh:property [
17
+ sh:path schema:description ;
18
+ sh:minCount 1 ;
19
+ ] ;
20
+ sh:property [
21
+ sh:path schema:hiringOrganization ;
22
+ sh:minCount 1 ;
23
+ ] ;
24
+ sh:property [
25
+ sh:path schema:jobLocation ;
26
+ sh:minCount 1 ;
27
+ ] ;
28
+ sh:property [
29
+ sh:path schema:title ;
30
+ sh:minCount 1 ;
31
+ ] ;
32
+ sh:property [
33
+ sh:path schema:applicantLocationRequirements ;
34
+ sh:minCount 1 ;
35
+ sh:severity sh:Warning ;
36
+ sh:message "Recommended by Google: applicantLocationRequirements." ;
37
+ ] ;
38
+ sh:property [
39
+ sh:path schema:baseSalary ;
40
+ sh:minCount 1 ;
41
+ sh:severity sh:Warning ;
42
+ sh:message "Recommended by Google: baseSalary." ;
43
+ ] ;
44
+ sh:property [
45
+ sh:path schema:directApply ;
46
+ sh:minCount 1 ;
47
+ sh:severity sh:Warning ;
48
+ sh:message "Recommended by Google: directApply." ;
49
+ ] ;
50
+ sh:property [
51
+ sh:path schema:employmentType ;
52
+ sh:minCount 1 ;
53
+ sh:severity sh:Warning ;
54
+ sh:message "Recommended by Google: employmentType." ;
55
+ ] ;
56
+ sh:property [
57
+ sh:path schema:identifier ;
58
+ sh:minCount 1 ;
59
+ sh:severity sh:Warning ;
60
+ sh:message "Recommended by Google: identifier." ;
61
+ ] ;
62
+ sh:property [
63
+ sh:path schema:jobLocationType ;
64
+ sh:minCount 1 ;
65
+ sh:severity sh:Warning ;
66
+ sh:message "Recommended by Google: jobLocationType." ;
67
+ ] ;
68
+ sh:property [
69
+ sh:path schema:validThrough ;
70
+ sh:minCount 1 ;
71
+ sh:severity sh:Warning ;
72
+ sh:message "Recommended by Google: validThrough." ;
73
+ ] ;
74
+ .