Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/weso/hercules-sync
Tools to synchronise data between the ontology files and Wikibase instance for the Hercules project at University of Murcia.
https://github.com/weso/hercules-sync
asio ontology rdf semantic-web wikibase
Last synced: 2 months ago
JSON representation
Tools to synchronise data between the ontology files and Wikibase instance for the Hercules project at University of Murcia.
- Host: GitHub
- URL: https://github.com/weso/hercules-sync
- Owner: weso
- License: gpl-3.0
- Created: 2020-02-03T12:17:11.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-03-29T22:01:14.000Z (almost 3 years ago)
- Last Synced: 2024-04-14T12:14:18.199Z (9 months ago)
- Topics: asio, ontology, rdf, semantic-web, wikibase
- Language: Python
- Homepage:
- Size: 97.2 MB
- Stars: 4
- Watchers: 6
- Forks: 1
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- License: LICENSE
Awesome Lists containing this project
README
# hercules-sync
License
Build Status
Coverage
Tools to synchronise data between the ontology files and Wikibase instance for the Hercules project at University of Murcia.
## Directory structure
* docs: Development documentation of this module.
* hercules_sync: Source code of the application.
* tests: Test suite used to validate the project.
## Defining a webhook in the source repo
In order to perform the synchronization automatically, a webhook must be created in the original repository where the ontology is stored. This webhook will be launched whenever a new push event occurs in the repo, and the synchronization service will be called to sync the changes with the wikibase instance. When creating a new webhook, the payload url must point to the URL where this server will be available. It is also important to define a secret key that will be used to accept only requests from the source repo and not from other ones. An example configuration will look like this one:
## Launching the app with Docker
In order to execute the app you need to set the following configuration in the docker-compose.yml file:
* GITHUB_OAUTH: Github token with access to read the repository where the ontology is stored. This token will be used to download the modified files through the GitHub API. For more information, see [the official GitHub page about creating a personal access token](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line).
* WBAPI: Endpoint of the target Wikibase instance API where the ontology will be sincronized. E.g. https://hercules-demo.wiki.opencura.com/w/api.php
* WBSPARQL: SPARQL endpoint of the target wikibase. E.g. https://hercules-demo.wiki.opencura.com/query/sparql
* WBUSER: Username of the user that will perform the synchronization operation in the target wikibase.
* WBPASS: Password of the user defined by the username stated above.
* WEBHOOK_SECRET: Secret key of the webhook created in the previous step.
## Launching the app directly with Python
This application is compatible with Python 3.6 forwards, but the recommended Python version is at least Python 3.7 due to performance. After you have installed Python, you can run the following command to install every dependency:
```
pip install -r requirements.txt
```
After the requirements have been installed, you need to set directly the environment variables described in the previous section. After that, the following command can be executed to launch the app:
```
python wsgi.py
```
Alternatively, there is a sh script available that installs the dependencies and runs the server automatically. In order to execute this script, you have to set the environment variables and then run:
```
sh start_server.sh
```