Test Perma-Id w3id.org forwarding

This is a test facility to test-drive your forwarding rules before publishing them to w3id.org

Edit your forwards

The w3id.org source repository is integrated as a git submodule under pid-w3id.org

Be sure to run the following command after cloning this repo:

git submodule update --init

We further recommend creating a fork of the w3id.org source repository. Enter the pid-w3id.org and add it to the remotes

cd pid-w3id.org
git remote add https://github.com/yourfork.git
cd ..

You can now create new branches and edit your namespace before test-driving it.

Start a local w3id.org instance

We use docker for that purpose

docker compose up

Afterwards, a w3id.org clone is available under http://localhost:8080 which replaces the original https://w3id.org.

To check or compare the result of https://w3id.org/catenax/ you would now call 'http://localhost:8080/catenax/' instead.

We have added a shell script which performs that comparison for you by giving it a csv file.

./test_local.sh

Each line in the csv file contains two columns, one collumn with the test URL and one with the reference URL:

http://localhost:8080/catenax/;https://big-data-spaces.github.io/ontology/

After a successful local test, you may prepare a pull request (PR) agains w3id.org from the changed source repo.

Test the final deployment

When the PR has been accepted and merged, you may test your changes again, now against the real deal:

./test.sh

Each line in the live csv file contains two columns, one collumn with the test URL and one with the reference URL:

https://w3id.org/catenax/;https://big-data-spaces.github.io/ontology/