mustrd 0.2.7a0__py3-none-any.whl → 0.3.1a0__py3-none-any.whl

mustrd-0.3.1a0.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.3
+Name: mustrd
+Version: 0.3.1a0
+Summary: A Spec By Example framework for RDF and SPARQL, Inspired by Cucumber.
+License: MIT
+Author: John Placek
+Author-email: john.placek@semanticpartners.com
+Requires-Python: >=3.11,<4.0
+Classifier: Framework :: Pytest
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Requires-Dist: Jinja2 (==3.1.5)
+Requires-Dist: beautifulsoup4 (>=4.11.1,<5.0.0)
+Requires-Dist: colorama (==0.4.6)
+Requires-Dist: colorlog (>=6.7.0,<7.0.0)
+Requires-Dist: coverage (==7.4.3)
+Requires-Dist: edn-format (>=0.7.5,<0.8.0)
+Requires-Dist: flake8 (==7.0.0)
+Requires-Dist: multimethods-py (>=0.5.3,<0.6.0)
+Requires-Dist: numpy (>=1.26.0,<1.27.0)
+Requires-Dist: openpyxl (>=3.1.2,<4.0.0)
+Requires-Dist: pandas (>=2.0,<3.0)
+Requires-Dist: pyshacl (>=0.30.0,<0.31.0)
+Requires-Dist: pytest (>=7.2.0,<8.0.0)
+Requires-Dist: rdflib (>=7.1.3,<8.0.0)
+Requires-Dist: requests (>=2.28.2,<3.0.0)
+Requires-Dist: tabulate (>=0.9.0,<0.10.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: tomli (>=2.0.1,<3.0.0)
+Requires-Dist: urllib3 (==1.26.19)
+Project-URL: Repository, https://github.com/Semantic-partners/mustrd
+Description-Content-Type: text/markdown
+
+# mustrd
+
+**"MustRD: Validate your SPARQL queries and transformations with precision and confidence, using BDD and Given-When-Then principles."**
+
+[<img src="https://github.com/Semantic-partners/mustrd/raw/python-coverage-comment-action-data/badge.svg?sanitize=true" alt="coverage badge">](https://github.com/Semantic-partners/mustrd/tree/python-coverage-comment-action-data)
+
+### Why?
+
+SPARQL is a powerful query language for RDF data, but how can you ensure your queries and transformations are doing what you intend? Whether you're working on a pipeline or a standalone query, certainty is key.
+
+While RDF and SPARQL offer great flexibility, we noticed a gap in tooling to validate their behavior. We missed the robust testing frameworks available in imperative programming languages that help ensure your code works as expected.
+
+With MustRD, you can:
+
+* Define data scenarios and verify that queries produce the expected results.
+* Test edge cases to ensure your queries remain reliable.
+* Isolate small SPARQL enrichment or transformation steps and confirm you're only inserting what you intend.
+
+### What?
+
+MustRD is a Spec-By-Example ontology with a reference Python implementation, inspired by tools like Cucumber. It uses the Given-When-Then approach to define and validate SPARQL queries and transformations.
+
+MustRD is designed to be triplestore/SPARQL engine agnostic, leveraging open standards to ensure compatibility across different platforms.
+
+### What it is NOT
+
+MustRD is not an alternative to SHACL. While SHACL validates data structures, MustRD focuses on validating data transformations and query results.
+
+### How?
+
+You define your specs in Turtle (`.ttl`) or TriG (`.trig`) files using the Given-When-Then approach:
+
+* **Given**: Define the starting dataset.
+* **When**: Specify the action (e.g., a SPARQL query).
+* **Then**: Outline the expected results.
+
+Depending on the type of SPARQL query (CONSTRUCT, SELECT, INSERT/DELETE), MustRD runs the query and compares the results against the expectations defined in the spec.
+
+Expectations can also be defined as:
+
+* INSERT queries.
+* SELECT queries.
+* Higher-order expectation languages, similar to those used in various platforms.
+
+### When?
+
+MustRD is a work in progress, built to meet the needs of our projects across multiple clients and vendor stacks. While we find it useful, it may not meet your needs out of the box.
+
+We invite you to try it, raise issues, or contribute via pull requests. If you need custom features, contact us for consultancy rates, and we may prioritize your request.
+
+## Support
+
+Semantic Partners is a specialist consultancy in Semantic Technology. If you need more support, contact us at info@semanticpartners.com or mustrd@semanticpartners.com.
+
+

{mustrd-0.2.7a0.dist-info → mustrd-0.3.1a0.dist-info}/RECORD

@@ -1,32 +1,32 @@
 mustrd/README.adoc,sha256=E5KuShPEl2U6NmRzEAwZtAhBoyJsOvjGS1CM2UsbSQ4,1394
-mustrd/README.md,sha256=CR08uZ4eNELHBdDRXAVKkRZ4hgQB9OXA7tFRy4ER-LI,1364
+mustrd/README.md,sha256=uyg4Pn1JkYic_H5WcWn7llL_m4gBsIl02rIEikKa_2A,1609
 mustrd/TestResult.py,sha256=K4yth-rYrK6Pl7SFiTAZkUStBIzHlgq0oxSSpq5F34M,4849
 mustrd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mustrd/anzo_utils.py,sha256=4DXtdZo504Llzmc2fyhe13rLfJXk1mDUnUNDHA8N5YI,4483
-mustrd/logger_setup.py,sha256=6Z3E5_h8vZFn4PZUyJVFdkgwFjDWthWEQVJsI9wQVVU,1720
+mustrd/anzo_utils.py,sha256=CKNSF_oTFKc4v64EDXJzeirP1GxOIOCUKNfaJKk0oEc,4677
+mustrd/logger_setup.py,sha256=kuzrFaW8Ar-q5Bvjg1OqKn9l4U5MVDyfOQF13SYk8nQ,1780
 mustrd/model/catalog-v001.xml,sha256=IEtaw3FK4KGQWKancEe1HqzUQTrKdk89vNxnoLKGF4o,381
-mustrd/model/mustrdShapes.ttl,sha256=6-W8onQBWOwAvsIYLRGOk2FePSp4SPFfWd7dSuNC5ho,9456
+mustrd/model/mustrdShapes.ttl,sha256=Qw99dIakGEra-vcENs3Oc9pJ33yYBZ0GEZJa2dLI3xo,10107
 mustrd/model/mustrdTestOntology.ttl,sha256=W7IRbPKrhpYFweZvc9QH8gdjBiuZMHKETIuHBepLnYw,2034
 mustrd/model/mustrdTestShapes.ttl,sha256=5PUpU9AzPSeLpF_UzNBVnACLOhs3hfoQpiz-ybsrbj8,818
-mustrd/model/ontology.ttl,sha256=AK27qyT8GW_SwJDwTFvtfxndBPEfYT6Y1jiW26Hyjg0,16809
+mustrd/model/ontology.ttl,sha256=orb8VgPiVrmzp3dKHc53hgkq_9ic9SbqIAyLZ_cHv38,17079
 mustrd/model/test-resources/resources.ttl,sha256=1Dsp1nuNxauj9bxeX-HShQsiO-CVy5Irwm2y2x0cdjI,1498
 mustrd/model/triplestoreOntology.ttl,sha256=9K5gj0hDOolRYjHc58UT4igex8cUnq9h7SUe4ToYbdw,5834
 mustrd/model/triplestoreshapes.ttl,sha256=G1kdgASdPa8s5JVGXL4KM2ewp-F5Vmbdist0f77VTBc,1706
-mustrd/mustrd.py,sha256=8xPjdHyGA692zyThCILm8VYuxkSF1ATEf35zXSmLVRU,37750
-mustrd/mustrdAnzo.py,sha256=Fg1mCkuGiVywSt5HJ0KCVJUFuTxNMrsPtt45y_fqSII,8292
+mustrd/mustrd.py,sha256=Ac42FUVY_6u1rt8uQmmIRo6-lV1vmOTy5fNu1CqPEIQ,41021
+mustrd/mustrdAnzo.py,sha256=0XhLkfagW_HManfZ3iGAf_K2_d-pLVTAOT-0pX8hhM4,8352
 mustrd/mustrdGraphDb.py,sha256=Ro_fxDPFl64r-FAM18awhZydydEY1-IXO0zdKpvZD3U,5405
-mustrd/mustrdRdfLib.py,sha256=CvrzEl1-lEPugYVe3y_Ip8JMzUxv6IeWauLOa_WA-XI,2073
-mustrd/mustrdTestPlugin.py,sha256=Xy7I7yJNwAatzrU13FkBs0ateWQ96w3MDte8gt8Ykto,15548
-mustrd/namespace.py,sha256=xGfH-nRP3t_I4rmoGJPqlSGbI0G5HUMlUeAl7l_yW-s,3622
+mustrd/mustrdRdfLib.py,sha256=1dYoyohjDhonKItYMNkFybySFt9lgez3zYN2kU9mW-I,2369
+mustrd/mustrdTestPlugin.py,sha256=hbYo8i1j4uFuRekXGd4Mnjt9wkSgQrS5o809xtbcLgs,19664
+mustrd/namespace.py,sha256=1l8RJDFI7rYkWvmRokaTvSvqrDJEdRNIkq3lmPb0xpI,3854
 mustrd/run.py,sha256=5xZUgKPMBQ-03cWROAnwtbOs2Nb0Vat6n8Fi6EyfS-k,4257
-mustrd/spec_component.py,sha256=7BmMjJMy0ACbVBAEZpe5ZprnDZYs6h5f7-fI38l3jAk,31483
-mustrd/steprunner.py,sha256=YKrMSYhethWCAQEI63hK6jXh3ljyoM87w7eHyoRd8rc,7389
+mustrd/spec_component.py,sha256=FQPLX5W0wGOLUOJgPxf-9YpyNhMYnV3xU2nJch99NOI,38452
+mustrd/steprunner.py,sha256=BHY4UhN7oqHVoXYPk4ROnv0nCqy4-NXfbzFzOyb3G4k,10032
 mustrd/templates/md_ResultList_leaf_template.jinja,sha256=IzwZjliCx7-viipATDQK6MQg_5q1kLMKdeNSZg1sXXY,508
 mustrd/templates/md_ResultList_template.jinja,sha256=_8joJ7vtw_qoqxv3HhUtBgRfhOeqmgfaRFwEo4MROvQ,203
 mustrd/templates/md_stats_template.jinja,sha256=96W62cMWu9UGLNv65ZQ8RYLjkxKHhJy-FlUtXgud6XY,155
 mustrd/utils.py,sha256=OGdLvw7GvjrFgTJo0J97Xwdh-_ZgSmapmOistrEchO0,1387
-mustrd-0.2.7a0.dist-info/LICENSE,sha256=r8nmh5fUct9h2w8_RDl13EIscvmwCLoarPr1kg35MnA,1078
-mustrd-0.2.7a0.dist-info/METADATA,sha256=G7prJE0-fM5tfkmtvCXWdJz6LEo6FxvrZQ5t4EnY9zk,4204
-mustrd-0.2.7a0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-mustrd-0.2.7a0.dist-info/entry_points.txt,sha256=v7V7sN0_L1aB4Ug_9io5axlQSeJ1C0tNrQWwdXdV58s,50
-mustrd-0.2.7a0.dist-info/RECORD,,
+mustrd-0.3.1a0.dist-info/LICENSE,sha256=r8nmh5fUct9h2w8_RDl13EIscvmwCLoarPr1kg35MnA,1078
+mustrd-0.3.1a0.dist-info/METADATA,sha256=Kf--ygg87njQLL6YTu-Prt63nMrj0aMwpSAoya_FtDk,4361
+mustrd-0.3.1a0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+mustrd-0.3.1a0.dist-info/entry_points.txt,sha256=v7V7sN0_L1aB4Ug_9io5axlQSeJ1C0tNrQWwdXdV58s,50
+mustrd-0.3.1a0.dist-info/RECORD,,

mustrd-0.2.7a0.dist-info/METADATA

@@ -1,96 +0,0 @@
-Metadata-Version: 2.3
-Name: mustrd
-Version: 0.2.7a0
-Summary: A Spec By Example framework for RDF and SPARQL, Inspired by Cucumber.
-License: MIT
-Author: John Placek
-Author-email: john.placek@semanticpartners.com
-Requires-Python: >=3.11,<4.0
-Classifier: Framework :: Pytest
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Software Development :: Testing
-Classifier: Topic :: Utilities
-Requires-Dist: Jinja2 (==3.1.5)
-Requires-Dist: beautifulsoup4 (>=4.11.1,<5.0.0)
-Requires-Dist: colorama (==0.4.6)
-Requires-Dist: colorlog (>=6.7.0,<7.0.0)
-Requires-Dist: coverage (==7.4.3)
-Requires-Dist: flake8 (==7.0.0)
-Requires-Dist: multimethods-py (>=0.5.3,<0.6.0)
-Requires-Dist: numpy (>=1.26.0,<1.27.0)
-Requires-Dist: openpyxl (>=3.1.2,<4.0.0)
-Requires-Dist: pandas (>=2.0,<3.0)
-Requires-Dist: pyshacl (>=0.30.0,<0.31.0)
-Requires-Dist: pytest (>=7.2.0,<8.0.0)
-Requires-Dist: rdflib (>=7.1.3,<8.0.0)
-Requires-Dist: requests (>=2.28.2,<3.0.0)
-Requires-Dist: tabulate (>=0.9.0,<0.10.0)
-Requires-Dist: toml (>=0.10.2,<0.11.0)
-Requires-Dist: tomli (>=2.0.1,<3.0.0)
-Requires-Dist: urllib3 (==1.26.19)
-Project-URL: Repository, https://github.com/Semantic-partners/mustrd
-Description-Content-Type: text/markdown
-
-# mustrd
-
-
-[<img src="https://github.com/Semantic-partners/mustrd/raw/python-coverage-comment-action-data/badge.svg?sanitize=true" alt="coverage badge">](https://github.com/Semantic-partners/mustrd/tree/python-coverage-comment-action-data)
-
-### Why?
-
-How do you know your SPARQL, whether it's in a pipeline, or a query, is doing what you intend? 
-
-As much as we love RDF and SPARQL and Semantic Tech in general, we found a small gap in tooling to give us that certainty. 
-
-We missed the powerful testing frameworks that have evolved in imperative languages that help ensure you've written code that does what you think it should. 
-
-We wanted to be able to
-
-* setup data scenarios and ensure queries worked as expected
-* setup edge cases for queries and ensure they still work
-* isolate small sparql enrichment / transformation steps and know we're only INSERTing what we intend
-
-Enter MustRD. 
-
-### What?
-
-MustRD is a Spec-By-Example ontology, with a reference python implementation, inspired by the likes of Cucumber. 
-
-It's designed to be triplestore/SPARQL engine agnostic (aren't open standards *wonderful*!). 
-
-### What it is NOT
-MustRD is nothing to do with SHACL, or an alternative to it. In fact, we use SHACL for some of our features. 
-
-SHACL provides validation around data. 
-
-MustRD provides validation around data transformations. 
-
-### How?
-You define your specs in ttl, or trig files. 
-We use the SBE approach of *Given*, *When*, *Then* to define starting dataset, an action, and a set of expectations. We build up a set of data. 
-Then, depending on whether your SPARQL is a CONSTRUCT, SELECT or a INSERT/DELETE, we run it, and compare results against a set of expectations (*Then*) that are defined in the same way as a *Given* .
-Alternatively, you could define your *Then*
-
-* as an explicit ASK, or
-* select; or 
-* in a higher-order expectation language like you will be used to in various platforms, a set of expectations.
-
-
-### When?
-
-Soon. It's a work in progress, and we're building the things *we* need for the projects we work on at multiple clients, with multiple vendor stacks. 
-We already think it's useful, but it might not meet *your* needs, out of the box. 
-
-We invite you to try it, see where it doesn't fit, and raise an issue, or even better, a PR! If you need something custom, please check out our consultancy rates, and we might be able to prioritise a new feature for you.
-
-## Support
-We're a specialist consultancy in Semantic Tech, we're putting this out in case it's useful, but if you need more support, kindly contact our business team on info@semanticpartners.com, or mustrd@semanticpartners.com
-
-