Plugins can provide sysinfo

2 files changed, 15 insertions, 0 deletions

diff --git a/coverage/control.py b/coverage/control.py
index 8ae96fc..5724a93 100644
--- a/coverage/control.py
+++ b/coverage/control.py
@@ -301,6 +301,10 @@ class Coverage(object):
 
         if self.debug.should('sys'):
             self.debug.write_formatted_info("sys", self.sysinfo())
+            for plugin in self.plugins:
+                header = "sys: " + plugin.plugin_name
+                info = plugin.sysinfo()
+                self.debug.write_formatted_info(header, info)
             wrote_any = True
 
         if wrote_any:
diff --git a/coverage/plugin.py b/coverage/plugin.py
index 32750a1..c124627 100644
--- a/coverage/plugin.py
+++ b/coverage/plugin.py
@@ -57,6 +57,17 @@ class CoveragePlugin(object):
         """
         _needs_to_implement(self, "file_reporter")
 
+    def sysinfo(self):
+        """Return a list of information useful for debugging.
+
+        This method will be invoked for ``coverage run --debug=sys``.  Your
+        plugin can return any information to be displayed.
+
+        The return value is a list of pairs: (name, value).
+
+        """
+        return []
+
 
 class FileTracer(object):
     """Support needed for files during the tracing phase.