summaryrefslogtreecommitdiffstats
path: root/testing/mozbase/mozdebug/mozdebug/__init__.py
blob: 3450d755c7ab29ec331b1c2fbe0239759aeb1464 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# flake8: noqa
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this file,
# You can obtain one at http://mozilla.org/MPL/2.0/.

"""
This module contains a set of function to gather information about the
debugging capabilities of the platform. It allows to look for a specific
debugger or to query the system for a compatible/default debugger.

The following simple example looks for the default debugger on the
current platform and launches a debugger process with the correct
debugger-specific arguments:

::

  import mozdebug

  debugger = mozdebug.get_default_debugger_name()
  debuggerInfo = mozdebug.get_debugger_info(debugger)

  debuggeePath = "toDebug"

  processArgs = [self.debuggerInfo.path] + self.debuggerInfo.args
  processArgs.append(debuggeePath)

  run_process(args, ...)

"""

from mozdebug import *