There is a collection of unit tests in the *tests/unit* in the

• Genenetwork 3 repository

There is (as of 2022-Feb-10) an

• integration tests directory

in the Genenetwork 3 repository.

The tests there, however, are technically unit tests. Each test seems to test a single logical unit of the system e.g. correlations, gemma, etc.

There is no test that seems to check for interactions among the logical units/modules of the system e.g.

• authorisation <==> file-upload <==> correlations
• partial-correlations <==> trait-editting <==> gemma analysis

etc.

There is need for tests to ensure that all expected endpoints are up and running.

Maybe even check that the data is correct.

There is a need to ensure that the system does not take forever to compute stuff.

There is a single performance tests module in

• the performance tests directory

for Genenetwork 3 but it is run manually, and mostly tests a very specific query that might or might not have been used in the code.

The performance tests in GN3 should probably be focussed on checking the following (among others):

• Each API endpoint responds within a specified amount of time
• Select computation-heavy functions respond within a specified amount of time for given data
• Database-querying functions used in the system respond within specified amount of time

etc.

This is relevant since GN3 is behind Nginx which defines a timeout.

Checks that previously working features are not broken. These can be added as we go along

Present under the

• unit tests directory

in the GN2 repository.

Genenetwork 2 has a "Mechanical Rob" testing system that is under construction whose purpose (as far as I - fredm - can tell) is to "walk" some common paths that have multiple logical units working together, thus performing some form of integration testing.

The only issue I (fredm) find in that as it is currently, it will not be able to test javascript interactions that are crucial to some operations in certain flows.

Since GN2 is not meant to handle computations itself, the bigger concern here is responsiveness.

There might need to be checks for responsiveness built in.

Checks that previously working features are not broken. These can be added as we go along

Selenium (and other browser-automation tools) were said to be too complicated, and are to be avoided as much as possible. It is better to use headless Firefox/Chromium and fetch pages with Mechanical Rob.

Selenium had been previously introduced in GN2 and then swiftly removed.

• sample script to create screen shots

• tests currently run to monitor GN2 and end points

We should cover the GN2/GN3 ones.

For GN2 we should write scripts that test:

• [ ] main menu selector
• [ ] search
• [ ] global search
• [ ] search with wild cards
• [ ] select items and add to shopping basket/collections
• [ ] mapping page
• [ ] run R/qtl mapping
• [ ] run GEMMA mapping
• [ ] run correlations
• [ ] Run the functions on the shopping basket/collections, such as CTL, network graph

Please don't emulate hitting browser buttons (selenium style). Simply find URL paths that do the job. You may have to set cookies. Mechanical Rob can do that. If using the browser interface is too hard, then create 'back-end' tests that cover the real functionality. I am not too concerned about the browser display - i.e., real Rob catches that quickly enough. I am *really* worried about regressions where search etc. starts giving different results. See what I mean? Pj.