mustrd 0.2.4__py3-none-any.whl → 0.2.6__py3-none-any.whl

mustrd-0.2.6.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.1
+Name: mustrd
+Version: 0.2.6
+Summary: A Spec By Example framework for RDF and SPARQL, Inspired by Cucumber.
+Home-page: https://github.com/Semantic-partners/mustrd
+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: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Requires-Dist: Jinja2 (==3.1.3)
+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 (>=1.5.2,<2.0.0)
+Requires-Dist: pyanzo (>=3.3.10,<4.0.0)
+Requires-Dist: pyshacl (>=0.23.0,<0.24.0)
+Requires-Dist: pytest (>=7.2.0,<8.0.0)
+Requires-Dist: rdflib (>=6.3.2,<7.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" 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
+
+

{mustrd-0.2.4.dist-info → mustrd-0.2.6.dist-info}/RECORD

@@ -24,8 +24,8 @@ mustrd/templates/md_ResultList_template.jinja,sha256=_8joJ7vtw_qoqxv3HhUtBgRfhOe
 mustrd/templates/md_stats_template.jinja,sha256=96W62cMWu9UGLNv65ZQ8RYLjkxKHhJy-FlUtXgud6XY,155
 mustrd/test/test_mustrd.py,sha256=ku4-UQ2railFo6z9apaIkPFOk980XSwCPBEHjhwWZUE,126
 mustrd/utils.py,sha256=OGdLvw7GvjrFgTJo0J97Xwdh-_ZgSmapmOistrEchO0,1387
-mustrd-0.2.4.dist-info/LICENSE,sha256=r8nmh5fUct9h2w8_RDl13EIscvmwCLoarPr1kg35MnA,1078
-mustrd-0.2.4.dist-info/METADATA,sha256=DzgBXFO7VFY1GOIvyievl6sa9zie0az-oVjEFY2T_t0,2976
-mustrd-0.2.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-mustrd-0.2.4.dist-info/entry_points.txt,sha256=v7V7sN0_L1aB4Ug_9io5axlQSeJ1C0tNrQWwdXdV58s,50
-mustrd-0.2.4.dist-info/RECORD,,
+mustrd-0.2.6.dist-info/LICENSE,sha256=r8nmh5fUct9h2w8_RDl13EIscvmwCLoarPr1kg35MnA,1078
+mustrd-0.2.6.dist-info/METADATA,sha256=qZqzOBwDMAiwhUiypQz4gcQRH3bQCOg4W8CHGgX3efs,4236
+mustrd-0.2.6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+mustrd-0.2.6.dist-info/entry_points.txt,sha256=v7V7sN0_L1aB4Ug_9io5axlQSeJ1C0tNrQWwdXdV58s,50
+mustrd-0.2.6.dist-info/RECORD,,

mustrd-0.2.4.dist-info/METADATA

@@ -1,71 +0,0 @@
-Metadata-Version: 2.1
-Name: mustrd
-Version: 0.2.4
-Summary: A Spec By Example framework for RDF and SPARQL, Inspired by Cucumber.
-Home-page: https://github.com/Semantic-partners/mustrd
-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: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Software Development :: Testing
-Classifier: Topic :: Utilities
-Requires-Dist: Jinja2 (==3.1.3)
-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 (>=1.5.2,<2.0.0)
-Requires-Dist: pyanzo (>=3.3.10,<4.0.0)
-Requires-Dist: pyshacl (>=0.23.0,<0.24.0)
-Requires-Dist: pytest (>=7.2.0,<8.0.0)
-Requires-Dist: rdflib (>=6.3.2,<7.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
-
-# Developer helper
-
-## Try it out
-
-Ensure you have python3 installed, before you begin.
-To install the necessary dependencies, run the following command from the project root.
-
-`pip3 install  -r requirements.txt`
-
-Run the following command to execute the accompanying tests specifications.
-
-`python3 src/run.py -v -p "test/test-specs" -g "test/data" -w "test/data" -t "test/data"`
-
-You will see some warnings. Do not worry, some tests specifications are invalid and intentionally skipped.
-
-For a brief explanation of the meaning of these options use the help option.
-
-`python3 src/run.py --help`
-
-## Run the tests
-
-Run `pytest` from the project root.
-
-## Additional Notes for Developers
-Mustrd remains very much under development. It is anticipated that additional functionality and triplestore support will be added over time. The project uses [Poetry](https://python-poetry.org/docs/) to manage dependencies so it will be necessary to have this installed to contribute towards the project. The link contains instructions on how to install and use this.
-As the project is actually built from the requirements.txt file at the project root, it is necessary to export dependencies from poetry to this file before committing and pushing changes to the repository, using the following command.
-
-`poetry export -f requirements.txt --without-hashes > requirements.txt`
-
-