vocexcel 0.8.5__tar.gz

vocexcel-0.8.5/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2002-2023, RDFLib VocExcel Team
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

vocexcel-0.8.5/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.1
+Name: vocexcel
+Version: 0.8.5
+Summary: Another Excel to RDF converter for SKOS vocabs, but one that include profile-based validation of results.
+Author-Email: Nicholas Car <nick@kurrawong.ai>
+Requires-Python: <4.0.0,>=3.12
+Requires-Dist: openpyxl<4.0.0,>=3.0.9
+Requires-Dist: rdflib<8.0.0,>=7.0.0
+Requires-Dist: pydantic<2.0.0,>=1.9.0
+Requires-Dist: pyshacl<1.0.0,>=0.18.1
+Requires-Dist: dateutils<1.0.0,>=0.6.12
+Requires-Dist: colorama<1.0.0,>=0.4.4
+Requires-Dist: pytest<8.0.0,>=7.2.0
+Requires-Dist: setuptools<71.0.0,>=70.0.0
+Requires-Dist: pipdeptree<3.0.0,>=2.3.3
+Requires-Dist: jinja2<4.0.0,>=3.1.2
+Requires-Dist: mangum<1.0.0,>=0.17.0
+Requires-Dist: black<26.0.0,>=25.1.0
+Requires-Dist: fastapi>=0.115.12
+Requires-Dist: python-multipart>=0.0.20
+

vocexcel-0.8.5/pyproject.toml

@@ -0,0 +1,89 @@
+[project]
+name = "vocexcel"
+version = "0.8.5"
+description = "Another Excel to RDF converter for SKOS vocabs, but one that include profile-based validation of results."
+authors = [
+    { name = "Nicholas Car", email = "nick@kurrawong.ai" },
+]
+requires-python = "<4.0.0,>=3.12"
+dependencies = [
+    "openpyxl<4.0.0,>=3.0.9",
+    "rdflib<8.0.0,>=7.0.0",
+    "pydantic<2.0.0,>=1.9.0",
+    "pyshacl<1.0.0,>=0.18.1",
+    "dateutils<1.0.0,>=0.6.12",
+    "colorama<1.0.0,>=0.4.4",
+    "pytest<8.0.0,>=7.2.0",
+    "setuptools<71.0.0,>=70.0.0",
+    "pipdeptree<3.0.0,>=2.3.3",
+    "jinja2<4.0.0,>=3.1.2",
+    "mangum<1.0.0,>=0.17.0",
+    "black<26.0.0,>=25.1.0",
+    "fastapi>=0.115.12",
+    "python-multipart>=0.0.20",
+]
+
+[project.scripts]
+vocexcel = "vocexcel.convert:main"
+
+[tool.poetry.dependencies]
+python = ">=3.12,<4.0.0"
+openpyxl = "^3.0.9"
+rdflib = "^7.0.0"
+pydantic = "^1.9.0"
+pyshacl = "^0.18.1"
+dateutils = "^0.6.12"
+colorama = "^0.4.4"
+pytest = "^7.2.0"
+setuptools = "^70.0.0"
+google-api-python-client = "^2.51.0"
+pipdeptree = "^2.3.3"
+jinja2 = "^3.1.2"
+mangum = "^0.17.0"
+black = "^25.1.0"
+
+[tool.poetry.group.web.dependencies]
+uvicorn = "^0.22.0"
+python-multipart = "^0.0.6"
+fastapi = "^0.104.1"
+
+[tool.poetry.group.dev.dependencies]
+python-dotenv = "^1.0.0"
+httpx = "^0.24.1"
+ruff = "^0.0.277"
+
+[tool.poetry.scripts]
+vocexcel = "vocexcel.convert:main"
+
+[tool.ruff.lint]
+select = [
+    "I001",
+    "I002",
+]
+
+[tool.pytest.ini_options]
+pythonpath = [
+    ".",
+]
+
+[poetry.group.dev.dependencies]
+pytest = "^7.2.0"
+black = "^22.1.0"
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[dependency-groups]
+web = [
+    "uvicorn<1.0.0,>=0.22.0",
+    "python-multipart<1.0.0,>=0.0.6",
+    "fastapi<1.0.0,>=0.104.1",
+]
+dev = [
+    "python-dotenv<2.0.0,>=1.0.0",
+    "httpx<1.0.0,>=0.24.1",
+    "ruff<1.0.0,>=0.0.277",
+]

vocexcel-0.8.5/tests/README.md

@@ -0,0 +1,33 @@
+# Tests and Example Excel and RDF files
+
+## What to Expect
+This folder contains quite a few examples of simple and complex vocabularies and different versions of template.
+
+The most recent vocpub template model is 0.4.2 so for current use, it's recommended to look at the simple valid and complex valid 042 examples. These contain excel sheets with complete vocabularies for reference.
+
+For multiple languages, refer to the 030 languages valid examples which shows how to have multiple inputs with other languages.
+
+The valid Excel and RDF files here should convert without errors. The invalid ones should give the following errors:
+
+### Excel to RDF:
+* **eg-invalid.xlsx**
+    * _Error: ConceptScheme processing error: 1 validation error for ConceptScheme title none is not an allowed value (type=type_error.none.not_allowed)_
+    * the vocabulary is missing a title!
+* **eg-invalid2.xlsx**
+    * _Error: Concept processing error, row 17, error: 1 validation error for Concept uri URL invalid, extra characters found after valid URL: ' xxx' (type=value_error.url.extra; extra= xxx)_
+    * the Concept on line 17 has an invalid URI!
+* **040_complexexample_invalid.xlsx**
+    * In this case, this file has cells containing invalid data. There are numbers instead of URI's in the children and close match cells
+    * children
+      Item 1 failed with messages HTTP IRIs must start with 'http' or 'https' (type=assertion_error)
+      close_match
+      Item 1 failed with messages HTTP IRIs must start with 'http' or 'https' and Item 2 failed with messages HTTP IRIs must start with 'http' or 'https' and Item 3 failed with messages HTTP IRIs must start with '
+      http' or 'https' and Item 4 failed with messages HTTP IRIs must start with 'http' or 'https' (type=assertion_error)
+
+The RDF to Excel conversion function is being re-implemented so these don't work just for the moment.
+
+### RDF to Excel
+* **eg-invalid.ttl**
+    * _Error: The file you supplied is not valid according to the vocpub profile_ and then a bunch of messages about why it's invalid
+* **eg-invalid2.ttl**
+    * _Error: Error while uploading_ or similar. The file is valid RDF but the file extension indicates the Turtle format but it's actually in the XML format

vocexcel-0.8.5/tests/data/040_exhaustive_comparison.ttl

@@ -0,0 +1,57 @@
+@prefix cs: <http://example.org/exhaustive_concept_scheme_vocabulary_iri> .
+@prefix dcat: <http://www.w3.org/ns/dcat#> .
+@prefix dcterms: <http://purl.org/dc/terms/> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<http://example.org/example_collection_uri> a skos:Collection ;
+    dcterms:identifier "example_collection_uri"^^xsd:token ;
+    dcterms:isPartOf cs: ;
+    dcterms:provenance "Example Collection Provenance"@en ;
+    skos:definition "Example Collection Definition"@en ;
+    skos:member <http://example.org/example_collection_member_1>,
+        <http://example.org/example_collection_member_2>,
+        <http://example.org/example_collection_member_3> ;
+    skos:prefLabel "Example Collection Preferred Label"@en .
+
+<http://example.org/exhaustive_children_example_1> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+<http://example.org/exhaustive_children_example_2> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+<http://example.org/exhaustive_children_example_3> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+cs: a skos:ConceptScheme ;
+    dcterms:identifier "exhaustive_concept_scheme_vocabulary_iri"^^xsd:token ;
+    dcterms:created "2022-03-07"^^xsd:date ;
+    dcterms:creator <https://linked.data.gov.au/org/cgi> ;
+    dcterms:hasPart <http://example.org/example_collection_uri> ;
+    dcterms:modified "2022-03-07"^^xsd:date ;
+    dcterms:provenance "Example Provenance"@en ;
+    dcterms:publisher <https://linked.data.gov.au/org/cgi> ;
+    rdfs:seeAlso "1.2.3.4" ;
+    owl:versionInfo "0.1" ;
+    skos:definition "Exhaustive Vocabulary Description"@en ;
+    skos:hasTopConcept <http://example.org/exhaustive_concept_iri> ;
+    skos:prefLabel "Exhaustive Vocabulary Title"@en ;
+    dcat:contactPoint "Example Custodian" .
+
+<http://example.org/exhaustive_concept_iri> a skos:Concept ;
+    dcterms:identifier "exhaustive_concept_iri"^^xsd:token ;
+    dcterms:provenance "Example Exhaustive Provenance"@en ;
+    rdfs:isDefinedBy <http://example.org/exhaustive_concept_source_vocabulary_iri> ;
+    skos:altLabel "example exhaustive concept alternate label"@en ;
+    skos:broadMatch <http://example.org/example_broad_match> ;
+    skos:closeMatch <http://example.org/example_close_match> ;
+    skos:definition "example exhaustive concept definition"@en ;
+    skos:exactMatch <http://example.org/example_exact_match> ;
+    skos:inScheme cs: ;
+    skos:narrowMatch <http://example.org/example_narrow_match> ;
+    skos:narrower <http://example.org/exhaustive_children_example_1>,
+        <http://example.org/exhaustive_children_example_2>,
+        <http://example.org/exhaustive_children_example_3> ;
+    skos:prefLabel "example exhaustive preferred label"@en ;
+    skos:relatedMatch <http://example.org/example_related_match> ;
+    skos:topConceptOf cs: .
+

vocexcel-0.8.5/tests/data/040_minimal_comparison.ttl

@@ -0,0 +1,23 @@
+@prefix cs: <http://example.org/vocabulary_iri> .
+@prefix dcterms: <http://purl.org/dc/terms/> .
+@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<http://example/org/example1> a skos:Concept ;
+    dcterms:identifier "example1"^^xsd:token ;
+    skos:definition "example concept definition"@en ;
+    skos:inScheme cs: ;
+    skos:prefLabel "example preferred concept label"@en ;
+    skos:topConceptOf cs: .
+
+cs: a skos:ConceptScheme ;
+    dcterms:identifier "vocabulary_iri"^^xsd:token ;
+    dcterms:created "2022-03-07"^^xsd:date ;
+    dcterms:creator <https://linked.data.gov.au/org/cgi> ;
+    dcterms:modified "2022-03-07"^^xsd:date ;
+    dcterms:provenance "Example Provenance"@en ;
+    dcterms:publisher <https://linked.data.gov.au/org/cgi> ;
+    skos:definition "Example Description"@en ;
+    skos:hasTopConcept <http://example/org/example1> ;
+    skos:prefLabel "Example Title"@en .
+

vocexcel-0.8.5/tests/data/041_exhaustive_comparison.ttl

@@ -0,0 +1,56 @@
+@prefix cs: <http://example.org/exhaustive_concept_scheme_vocabulary_iri> .
+@prefix dcat: <http://www.w3.org/ns/dcat#> .
+@prefix dcterms: <http://purl.org/dc/terms/> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<http://example.org/example_collection_uri> a skos:Collection ;
+    dcterms:identifier "example_collection_uri"^^xsd:token ;
+    dcterms:isPartOf cs: ;
+    dcterms:provenance "Example Collection Provenance"@en ;
+    skos:definition "Example Collection Definition"@en ;
+    skos:member <http://example.org/example_collection_member_1>,
+        <http://example.org/example_collection_member_2>,
+        <http://example.org/example_collection_member_3> ;
+    skos:prefLabel "Example Collection Preferred Label"@en .
+
+<http://example.org/exhaustive_children_example_1> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+<http://example.org/exhaustive_children_example_2> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+<http://example.org/exhaustive_children_example_3> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+cs: a skos:ConceptScheme ;
+    dcterms:created "2022-03-07"^^xsd:date ;
+    dcterms:creator <https://linked.data.gov.au/org/cgi> ;
+    dcterms:hasPart <http://example.org/example_collection_uri> ;
+    dcterms:identifier "exhaustive_concept_scheme_vocabulary_iri"^^xsd:token ;
+    dcterms:modified "2022-03-07"^^xsd:date ;
+    dcterms:provenance "Example Provenance"@en ;
+    dcterms:publisher <https://linked.data.gov.au/org/cgi> ;
+    rdfs:seeAlso "1.2.3.4" ;
+    owl:versionInfo "0.1" ;
+    skos:definition "Exhaustive Vocabulary Description"@en ;
+    skos:hasTopConcept <http://example.org/exhaustive_concept_iri> ;
+    skos:prefLabel "Exhaustive Vocabulary Title"@en ;
+    dcat:contactPoint "Example Custodian" .
+
+<http://example.org/exhaustive_concept_iri> a skos:Concept ;
+    dcterms:identifier "exhaustive_concept_iri"^^xsd:token ;
+    dcterms:provenance "Example Exhaustive Provenance"@en ;
+    rdfs:isDefinedBy <http://example.org/exhaustive_concept_source_vocabulary_iri> ;
+    skos:altLabel "example exhaustive concept alternate label"@en ;
+    skos:broadMatch <http://example.org/example_broad_match> ;
+    skos:closeMatch <http://example.org/example_close_match> ;
+    skos:definition "example exhaustive concept definition"@en ;
+    skos:exactMatch <http://example.org/example_exact_match> ;
+    skos:inScheme cs: ;
+    skos:narrowMatch <http://example.org/example_narrow_match> ;
+    skos:narrower <http://example.org/exhaustive_children_example_1>,
+        <http://example.org/exhaustive_children_example_2>,
+        <http://example.org/exhaustive_children_example_3> ;
+    skos:prefLabel "example exhaustive preferred label"@en ;
+    skos:relatedMatch <http://example.org/example_related_match> ;
+    skos:topConceptOf cs: .

vocexcel-0.8.5/tests/data/043_exhaustive.ttl

@@ -0,0 +1,57 @@
+@prefix cs: <http://example.org/exhaustive_concept_scheme_vocabulary_iri> .
+@prefix dcat: <http://www.w3.org/ns/dcat#> .
+@prefix dcterms: <http://purl.org/dc/terms/> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<http://example.org/example_collection_uri> a skos:Collection ;
+    dcterms:identifier "example_collection_uri"^^xsd:token ;
+    dcterms:isPartOf cs: ;
+    dcterms:provenance "Example Collection Provenance"@en ;
+    skos:definition "Example Collection Definition"@en ;
+    skos:member <http://example.org/example_collection_member_1>,
+        <http://example.org/example_collection_member_2>,
+        <http://example.org/example_collection_member_3> ;
+    skos:prefLabel "Example Collection Preferred Label"@en .
+
+<http://example.org/exhaustive_children_example_1> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+<http://example.org/exhaustive_children_example_2> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+<http://example.org/exhaustive_children_example_3> skos:broader <http://example.org/exhaustive_concept_iri> .
+
+cs: a skos:ConceptScheme ;
+    dcterms:identifier "exhaustive_concept_scheme_vocabulary_iri"^^xsd:token ;
+    dcterms:created "2022-03-07"^^xsd:date ;
+    dcterms:creator <https://linked.data.gov.au/org/cgi> ;
+    dcterms:hasPart <http://example.org/example_collection_uri> ;
+    dcterms:modified "2022-03-07"^^xsd:date ;
+    dcterms:provenance "Example Provenance"@en ;
+    dcterms:publisher <https://linked.data.gov.au/org/cgi> ;
+    rdfs:seeAlso "1.2.3.4" ;
+    owl:versionInfo "0.1" ;
+    skos:definition "Exhaustive Vocabulary Description"@en ;
+    skos:hasTopConcept <http://example.org/exhaustive_concept_iri> ;
+    skos:prefLabel "Exhaustive Vocabulary Title"@en ;
+    dcat:contactPoint "Example Custodian" .
+
+<http://example.org/exhaustive_concept_iri> a skos:Concept ;
+    dcterms:identifier "exhaustive_concept_iri"^^xsd:token ;
+    dcterms:provenance "Example Exhaustive Provenance"@en ;
+    rdfs:isDefinedBy <http://example.org/exhaustive_concept_source_vocabulary_iri> ;
+    skos:altLabel "example exhaustive concept alternate label"@en ;
+    skos:broadMatch <http://example.org/example_broad_match> ;
+    skos:closeMatch <http://example.org/example_close_match> ;
+    skos:definition "example exhaustive concept definition"@en ;
+    skos:exactMatch <http://example.org/example_exact_match> ;
+    skos:inScheme cs: ;
+    skos:narrowMatch <http://example.org/example_narrow_match> ;
+    skos:narrower <http://example.org/exhaustive_children_example_1>,
+        <http://example.org/exhaustive_children_example_2>,
+        <http://example.org/exhaustive_children_example_3> ;
+    skos:prefLabel "example exhaustive preferred label"@en ;
+    skos:relatedMatch <http://example.org/example_related_match> ;
+    skos:topConceptOf cs: .
+