__init__.py 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. # -*- test-case-name: twisted.trial._dist.test -*-
  2. # Copyright (c) Twisted Matrix Laboratories.
  3. # See LICENSE for details.
  4. """
  5. This package implements the distributed Trial test runner:
  6. - The L{twisted.trial._dist.disttrial} module implements a test runner which
  7. runs in a manager process and can launch additional worker processes in
  8. which to run tests and gather up results from all of them.
  9. - The L{twisted.trial._dist.options} module defines command line options used
  10. to configure the distributed test runner.
  11. - The L{twisted.trial._dist.managercommands} module defines AMP commands
  12. which are sent from worker processes back to the manager process to report
  13. the results of tests.
  14. - The L{twisted.trial._dist.workercommands} module defines AMP commands which
  15. are sent from the manager process to the worker processes to control the
  16. execution of tests there.
  17. - The L{twisted.trial._dist.distreporter} module defines a proxy for
  18. L{twisted.trial.itrial.IReporter} which enforces the typical requirement
  19. that results be passed to a reporter for only one test at a time, allowing
  20. any reporter to be used with despite disttrial's simultaneously running
  21. tests.
  22. - The L{twisted.trial._dist.workerreporter} module implements a
  23. L{twisted.trial.itrial.IReporter} which is used by worker processes and
  24. reports results back to the manager process using AMP commands.
  25. - The L{twisted.trial._dist.workertrial} module is a runnable script which is
  26. the main point for worker processes.
  27. - The L{twisted.trial._dist.worker} process defines the manager's AMP
  28. protocol for accepting results from worker processes and a process protocol
  29. for use running workers as local child processes (as opposed to
  30. distributing them to another host).
  31. @since: 12.3
  32. """
  33. # File descriptors numbers used to set up pipes with the worker.
  34. _WORKER_AMP_STDIN = 3
  35. _WORKER_AMP_STDOUT = 4