Set up and run RDFox scripts in a temporary directory.
Requires RDFox version 6.0 or greater for the RDFoxEndpoint.add_triples method.
rdfox_runner is tested against the latest versions of RDFox (currently 6.2 and 6.3.1).
This Python package provides functions for running RDFox in a functional way: mapping from input facts/rules to output facts/answers. It hides the process of setting up RDFox scripts and input files in a temporary directory, running RDFox, and extracting the results. It can also be used to interact with an externally-running RDFox REST endpoint.
See the documentation for more details.
Install rdfox_runner using pip:
pip install rdfox_runnerContributions are welcome: share examples of work done using it, make suggestions for improving the documentation, and examples of things that are more difficult than they should be or don't work -- as well as of course making actual fixes to code and documentation.
See DEVELOPING.rst for more information.
rdfox_runner is licensed with the MIT license.
RDFox is created by Oxford Semantic Technologies, who are not responsible for this project.
Add compatibility with RDFox v7.0.
The RDFox server info (including RDFox version) can now be retrieved from the RDFoxEndpoint.server_info method.
Fix bug with RDFox v6+ when setting multiple prefixes in namespaces.
Compatible with (& depend on) RDFlib version 6.
Add compatibility with RDFox version 6.2.
rdfox_runner is now tested against multiple RDFox versions (currently 5.6 and 6.2).
Now pass an absolute path to RDFox on command line.
This makes the $(dir.root) variable be set to an absolute path, not "./", meaning that files can be more reliably loaded from different locations in scripts by using paths relative to the script root directory.
Add new endpoint method query_raw which returns the response from RDFox directly, rather than parsing into an rdflib Graph. If the Python Graph representation is not needed, and the response is large, this is much faster.
Raise an error when RDFox execution stops due to error policy on-error = "stop".
Quit RDFox when an error happens with error policy on-error = "stop" also while waiting for endpoint to start (fixing an infinite wait).
Quit RDFox when an error happens with error policy on-error = "stop".
RDFoxRunner is no longer a subclass of RDFoxEndpoint, but it still returns an RDFoxEndpoint when used as a context manager. Thus most use should not need changing. The exception is the RDFoxRunner.files method, which now needs to be accessed on the original RDFoxRunner instance:
runner = RDFoxRunner(input_files, script)
with runner: # not `with runner as rdfox:`
output = runner.files(path)
Tested against RDFox version 5.6.