Changing reporter subscribe contract

Breaks compatiblity for reporters not in trunk.

Changing subscribe_to_describe(self, describe) to
subscribe_to_spec(self, spec)

I'm working to get rid of all references to describe slowly.
This is apart of the reporter cleanup story #30

docs/release_notes/index.rst

@@ -15,6 +15,9 @@ Features and bug fixes
     the --show-all-expects cli argument - gh-#46
  #. Fixing the summary report colors to reflect the actual test results. - gh-#44
  #. Added the ability for reporters to add their own cli arguments
+ #. Breaking reporter contract by switching from subscribe_to_describe(self, describe)
+    to subscribe_to_spec(self, spec). This is due to the slow removal of the
+    "describe" terminology in Specter.
 
 
 Release: 0.1.15

specter/reporting/__init__.py

@@ -23,7 +23,7 @@ def get_name(self):
         pass  # pragma: no cover
 
     @abstractmethod
-    def subscribe_to_describe(self, describe):
+    def subscribe_to_spec(self, spec):
         pass  # pragma: no cover
 
 
@@ -74,13 +74,13 @@ def can_use_reporter(self, reporter, parallel):
                 can_use = True
         return can_use
 
-    def subscribe_all_to_describe(self, describe):
+    def subscribe_all_to_spec(self, spec):
         """ Will automatically not subscribe reporters that are not parallel
         or serial depending on the current mode.
         """
         for reporter in self.reporters:
             if self.can_use_reporter(reporter, self.parallel):
-                reporter.subscribe_to_describe(describe)
+                reporter.subscribe_to_spec(spec)
 
     def finish_all(self):
         [reporter.finished() for reporter in self.reporters]

specter/reporting/console.py

@@ -89,9 +89,9 @@ def output_test_case_result(self, test_case, level):
         #if status == TestStatus.FAIL:
         print_expects(test_case, level, self.use_color)
 
-    def subscribe_to_describe(self, describe):
-        describe.add_listener(TestEvent.COMPLETE, self.test_complete)
-        describe.add_listener(DescribeEvent.START, self.start_spec)
+    def subscribe_to_spec(self, spec):
+        spec.add_listener(TestEvent.COMPLETE, self.test_complete)
+        spec.add_listener(DescribeEvent.START, self.start_spec)
 
     def test_complete(self, evt):
         test_case = evt.payload

specter/reporting/dots.py

@@ -19,8 +19,8 @@ def __init__(self):
     def get_name(self):
         return _('Dots Reporter')
 
-    def subscribe_to_describe(self, describe):
-        describe.add_listener(TestEvent.COMPLETE, self.test_event)
+    def subscribe_to_spec(self, spec):
+        spec.add_listener(TestEvent.COMPLETE, self.test_event)
 
     def process_arguments(self, args):
         if args.no_color:

specter/reporting/xunit.py

@@ -20,8 +20,8 @@ def process_arguments(self, args):
     def get_name(self):
         return 'xUnit report generator'
 
-    def subscribe_to_describe(self, describe):
-        describe.add_listener(DescribeEvent.COMPLETE, self.describe_complete)
+    def subscribe_to_spec(self, spec):
+        spec.add_listener(DescribeEvent.COMPLETE, self.describe_complete)
 
     def describe_complete(self, evt):
         describe = evt.payload

specter/runner.py

@@ -133,7 +133,7 @@ def run(self, args):
 
             suite = suite_type()
             self.suites.append(suite)
-            self.reporter_manager.subscribe_all_to_describe(suite)
+            self.reporter_manager.subscribe_all_to_spec(suite)
             suite.execute(select_metadata=select_meta,
                           parallel_manager=self.parallel_manager)