aurweb/test
2021-06-23 03:21:06 +02:00
..
Makefile test/Makefile: Run tests with prove when available 2020-02-29 14:56:47 +01:00
README.md Write test/README.md to help working with tests 2020-02-29 14:57:46 +01:00
setup.sh Use the real ml email address instead of alias 2021-06-23 03:21:06 +02:00
sharness.sh Upgrade Sharness to 1.1.0 2019-11-23 12:25:23 -05:00
t1100-git-auth.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t1200-git-serve.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t1300-git-update.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t2100-mkpkglists.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t2200-tuvotereminder.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t2300-pkgmaint.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t2400-aurblup.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t2500-notify.t Deliver emails to Cc in smtplib code path 2020-08-27 07:19:57 -04:00
t2600-rendercomment.t Support running tests from any directory 2020-02-29 14:56:47 +01:00
t2700-usermaint.t Support running tests from any directory 2020-02-29 14:56:47 +01:00

Running tests

To run all the tests, you may run make check under test/.

For more control, you may use the prove command, which receives a directory or a list of files to run, and produces a report.

Each test script is standalone, so you may run them individually. Some tests may receive command-line options to help debugging. See for example sharness's documentation for shell test scripts: https://github.com/chriscool/sharness/blob/master/README.git

Dependencies

For all the test to run, the following Arch packages should be installed:

  • pyalpm
  • python-alembic
  • python-bleach
  • python-markdown
  • python-pygit2
  • python-sqlalchemy
  • python-srcinfo

Writing tests

Test scripts must follow the Test Anything Protocol specification: http://testanything.org/tap-specification.html

Tests must support being run from any directory. They may use $0 to determine their location. Python scripts should expect aurweb to be installed and importable without toying with os.path or PYTHONPATH.

Tests written in shell should use sharness. In general, new tests should be consistent with existing tests unless they have a good reason not to.