summaryrefslogtreecommitdiffstats
path: root/verigraph/tester/README.md
diff options
context:
space:
mode:
authorJulien <zhang.jun3g@zte.com.cn>2017-07-19 21:40:40 +0800
committerJulien <zhang.jun3g@zte.com.cn>2017-07-19 21:40:40 +0800
commit00219e7e9b24ee2298a7d0d977afdf123a6de88b (patch)
tree26adc25806b642937b804bb5caa26332a1998f69 /verigraph/tester/README.md
parent6a24bbe353242f78c2a2eb08f522cccea60befc4 (diff)
rename all READM.rst to README.md
Change-Id: I95930de9fefd0897bd0b75d2aeb5a1d731332dad Signed-off-by: Julien <zhang.jun3g@zte.com.cn>
Diffstat (limited to 'verigraph/tester/README.md')
-rw-r--r--verigraph/tester/README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/verigraph/tester/README.md b/verigraph/tester/README.md
new file mode 100644
index 0000000..35396a3
--- /dev/null
+++ b/verigraph/tester/README.md
@@ -0,0 +1,38 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+In order to run the automatic testing script test.py, you need the
+following dependencies installed on your python distribution:
+
+- "requests" python package ->
+ http://docs.python-requests.org/en/master/
+- "jsonschema" python package ->
+ https://pypi.python.org/pypi/jsonschema
+
+IMPORTANT - If you have multiple versions of Python installed on your
+machine, check carefully that the version you are actually using when
+running the script, has the required packages installed. Requested
+version is Python 3+
+
+| HINT - to install a package you can raise the following command (Bash
+ on Linux or DOS shell on Windows):
+| python -m pip install jsonschema
+| python -m pip install requests
+
+Tested on PYTHON 3.4.3
+
+To add a new test, just put a new .json file inside the testcases
+folder. The corresponding JSON schema is in the testcase\_schema.json
+file and some examples are already available. Each json file should
+specify:
+
+- id, an integer for the testcase;
+- name, the name for the testcase;
+- description, an optional description;
+- policy\_url\_parameters, the parameters to be appended after the
+ verification URL (including the '?' character);
+- result, the expected verification result;
+- graph, the graph to be tested (the same object that you usually POST
+ to VeriGraph to create a new graph).
+ The test.py script will test each .json file contained into the
+ testcases folder and will provide a complete output.