Please note that these Trac pages are no longer being updated. Wiki contents/documentation have moved to GitHub.

Running Software Updater Unit Tests

The softwareupdater tests start a local webserver and serve update files from there.

Running the tests

  • Linux/Mac/BSD:
    • cd to the same directory is in (that is, trunk)
    • run ./softwareupdater/test/ name_of_directory_to_put_tests_in
      • For example, create a temp directory and pass that as the only argument to the script.
  • Windows:
    • Run to a folder of your choosing.
    • Copy over the files from trunk/softwareupdater/test/ to that same folder.
    • Go to that directory and run python -m softwareupdaters
    • When running these tests on Windows, ps cannot be used to check process status. You will have to do this yourself in the task manager.


  • There cannot be another instance of running, or the restart tests will fail.


Output if the test passed is one line indicating whether the test passed or failed (this test will take a while).

If the test fails, output will be produced, telling you what went wrong in which part of the test.

If everything is successful, there will be an instance of and running when the script completes. It is non-trivial to clean these up automatically, because we do not directly start these processes.

Note: Actually, it's not that hard to clean them up (it can be done with process groups). The current scripts don't do it, though, so you'll end up with extra nmmain and software updater process running at the end.