Adding new testing functionality

Author: apetenchea

.gitignore

@@ -121,3 +121,6 @@ node_modules/
 
 # setuptools_scm
 arango/version.py
+
+# test results
+*_results.txt

CONTRIBUTING.md

@@ -13,6 +13,12 @@ Run unit tests with coverage:
 py.test --cov=arango --cov-report=html  # Open htmlcov/index.html in your browser
 ```
 
+For a more comprehensive test suite, run:
+
+```shell
+./tester.sh  # Requires docker
+```
+
 Build and test documentation:
 
 ```shell

tester.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+
+# Tests python-arango driver against a local ArangoDB single server or cluster setup.
+# 1. Starts a local ArangoDB server or cluster (community).
+# 2. Runs the python-arango tests for the community edition.
+# 3. Starts a local ArangoDB server or cluster (enterprise).
+# 4. Runs all python-arango tests, including enterprise tests.
+
+# Usage:
+#   ./start.sh [all|single|cluster] [all|community|enterprise] [version] ["notest"]
+
+setup="${1:-all}"
+if [[ "$setup" != "all" && "$setup" != "single" && "$setup" != "cluster" ]]; then
+    echo "Invalid argument. Please provide either 'all', 'single' or 'cluster'."
+    exit 1
+fi
+
+tests="${2:-all}"
+if [[ "$tests" != "all" && "$tests" != "community" && "$tests" != "enterprise" ]]; then
+    echo "Invalid argument. Please provide either 'all', 'community', or 'enterprise'."
+    exit 1
+fi
+
+version="${3:-3.10.6}"
+
+if [[ -n "$4" && "$4" != "notest" ]]; then
+    echo "Invalid argument. Use 'notest' to only start the docker container, without running the tests."
+    exit 1
+fi
+mode="${4:-test}"
+
+if [ "$setup" == "all" ] || [ "$setup" == "single" ]; then
+  if [ "$tests" == "all" ] || [ "$tests" == "community" ]; then
+    echo "Starting single server community setup..."
+    docker run -d --rm \
+      --name arango \
+      -p 8529:8529 \
+      -v "$(pwd)/tests/static/":/tests/static \
+      -v /tmp:/tmp \
+      arangodb/arangodb:"$version" \
+      /bin/sh -c "arangodb --configuration=/tests/static/single.conf"
+
+    if [[ "$mode" == "notest" ]]; then
+      exit 0
+    fi
+
+    echo "Running python-arango tests for single server community setup..."
+    sleep 3
+    py.test --complete --cov=arango --cov-report=html | tee single_community_results.txt
+    echo "Stopping single server community setup..."
+    docker stop arango
+    docker wait arango
+    sleep 3
+  fi
+
+  if [ "$tests" == "all" ] || [ "$tests" == "enterprise" ]; then
+    echo "Starting single server enterprise setup..."
+    docker run -d --rm \
+      --name arango \
+      -p 8529:8529 \
+      -v "$(pwd)/tests/static/":/tests/static \
+      -v /tmp:/tmp \
+      arangodb/enterprise:"$version" \
+      /bin/sh -c "arangodb --configuration=/tests/static/single.conf"
+
+    if [[ "$mode" == "notest" ]]; then
+      exit 0
+    fi
+
+    echo "Running python-arango tests for single server enterprise setup..."
+    sleep 3
+    py.test --complete --enterprise --cov=arango --cov-report=html --cov-append | tee single_enterprise_results.txt
+    echo "Stopping single server enterprise setup..."
+    docker stop arango
+    docker wait arango
+    sleep 3
+  fi
+fi
+
+if [ "$setup" == "all" ] || [ "$setup" == "cluster" ]; then
+  if [ "$tests" == "all" ] || [ "$tests" == "community" ]; then
+    echo "Starting community cluster setup..."
+    docker run -d --rm \
+      --name arango \
+      -p 8529:8529 \
+      -v "$(pwd)/tests/static/":/tests/static \
+      -v /tmp:/tmp \
+      arangodb/arangodb:"$version" \
+      /bin/sh -c "arangodb --configuration=/tests/static/cluster.conf"
+
+    if [[ "$mode" == "notest" ]]; then
+      exit 0
+    fi
+
+    echo "Running python-arango tests for community cluster setup..."
+    sleep 15
+    py.test --cluster --complete --cov=arango --cov-report=html | tee cluster_community_results.txt
+    echo "Stopping community cluster setup..."
+    docker stop arango
+    docker wait arango
+    sleep 3
+  fi
+
+  if [ "$tests" == "all" ] || [ "$tests" == "enterprise" ]; then
+    echo "Starting enterprise cluster setup..."
+    docker run -d --rm \
+      --name arango \
+      -p 8529:8529 \
+      -v "$(pwd)/tests/static/":/tests/static \
+      -v /tmp:/tmp \
+      arangodb/enterprise:"$version" \
+      /bin/sh -c "arangodb --configuration=/tests/static/cluster.conf"
+
+    if [[ "$mode" == "notest" ]]; then
+      exit 0
+    fi
+
+    echo "Running python-arango tests for enterprise cluster setup..."
+    sleep 15
+    py.test --cluster --enterprise --complete --cov=arango --cov-report=html | tee cluster_enterprise_results.txt
+    echo "Stopping enterprise cluster setup..."
+    docker stop arango
+    docker wait arango
+  fi
+fi

tests/static/cluster.conf

@@ -0,0 +1,11 @@
+[starter]
+mode = cluster
+local = true
+address = 0.0.0.0
+
+[auth]
+jwt-secret = /tests/static/keyfile
+
+[args]
+all.database.password = passwd
+all.log.api-enabled = true

tests/static/single.conf

@@ -0,0 +1,10 @@
+[starter]
+mode = single
+address = 0.0.0.0
+port = 8528
+
+[auth]
+jwt-secret = /tests/static/keyfile
+
+[args]
+all.database.password = passwd

tests/test_foxx.py

@@ -29,7 +29,7 @@
 from arango.foxx import Foxx
 from tests.helpers import assert_raises, extract, generate_service_mount
 
-service_file = "/tmp/service.zip"
+service_file = "/tests/static/service.zip"
 service_name = "test"