summaryrefslogtreecommitdiffstats
path: root/TESTING
diff options
context:
space:
mode:
authorFrédéric Mangano-Tarumi <fmang@mg0.fr>2020-04-19 20:11:02 +0200
committerLukas Fleischer <lfleischer@archlinux.org>2021-02-20 17:24:30 +0100
commit8a13500535942a1c99b97ae4de46e5a1c0297cd5 (patch)
tree1a6b785264c9ea60a63a9d46228c038b5e008267 /TESTING
parent23f6dd16a7c8b6f81c229e2307838edd213d6149 (diff)
downloadaur-8a13500535942a1c99b97ae4de46e5a1c0297cd5.tar.gz
aur-8a13500535942a1c99b97ae4de46e5a1c0297cd5.tar.xz
Create aurweb.spawn for spawing the test server
This program makes it easier for developers to spawn the PHP server since it fetches automatically what it needs from the configuration file, rather than having the user explicitly pass arguments to the php executable. When the setup gets more complicated as we introduce Python, aurweb.spawn will keep providing the same interface, while under the hood it is planned to support running multiple sub-processes. Its Python interface provides an way for the test suite to spawn the test server when it needs to perform HTTP requests to the test server. The current implementation is somewhat weak as it doesn’t detect when a child process dies, but this is not supposed to happen often, and it is only meant for aurweb developers. In the long term, aurweb.spawn will eventually become obsolete, and replaced by Docker or Flask’s tools. Signed-off-by: Lukas Fleischer <lfleischer@archlinux.org>
Diffstat (limited to 'TESTING')
-rw-r--r--TESTING7
1 files changed, 4 insertions, 3 deletions
diff --git a/TESTING b/TESTING
index 4a1e6f4c..a5e08cb8 100644
--- a/TESTING
+++ b/TESTING
@@ -17,7 +17,8 @@ INSTALL.
Ensure to enable the pdo_sqlite extension in php.ini.
3) Copy conf/config.defaults to conf/config and adjust the configuration
- (pay attention to disable_http_login, enable_maintenance and aur_location).
+ Pay attention to disable_http_login, enable_maintenance, aur_location and
+ htmldir.
Be sure to change backend to sqlite and name to the file location of your
created test database.
@@ -31,6 +32,6 @@ INSTALL.
$ ./gendummydata.py out.sql
$ sqlite3 path/to/aurweb.sqlite3 < out.sql
-5) Run the PHP built-in web server:
+5) Run the test server:
- $ AUR_CONFIG='/path/to/aurweb/conf/config' php -S localhost:8080 -t /path/to/aurweb/web/html
+ $ AUR_CONFIG='/path/to/aurweb/conf/config' python -m aurweb.spawn