Add --summary option to gherkinize

This will produce a CSV-format summary of sections, scenarios, and tags. This provides an overview of tags applied, showing the tests which are (currently).

This includes extensive testing to get Gherkinize test coverage to 100%

This doesn't use red "X" and green Check because those would be limited to the `@wip` tag only.

Author: slott56

features/README.rst

@@ -22,7 +22,9 @@ This can be done using **make** at the top level of the project.
 
     make test
 
-To test work-in-progress (WIP)::
+To test work-in-progress (WIP)
+
+::
 
     make test-wip
 
@@ -61,25 +63,31 @@ Here's the bigger picture workflow:
 
     (Or, create it anywhere and set ``CEL_SPEC_PATH`` to refer to this directory.)
 
-2.  Run the ``tools/refresh_spec.``py to find the most recent tag and pull the current files.
+2.  Run the ``tools/refresh_spec.py`` to find the most recent tag and pull the current files.
 
-5.  Run ``make`` to copy the ``.textproto`` files to this directory and create ``.feature`` files from them.
+3.  Run ``make`` to copy the ``.textproto`` files to this directory and create ``.feature`` files from them.
     This will **also** create a ``git.log`` file with the last 5 log entries to help pinpoint
     the commit on which the acceptance test suite is based.
 
-    Remove the ``.textproto`` and ``.feature`` files and rebuild them:
+In rare cases, it can help to remove the ``.textproto`` and ``.feature`` files and rebuild them:
 
     ::
 
         make clean all
 
 Changing the ``@wip`` tags in the feature files.
 
-The ``@wip`` tags are added by ``gherkinize.py`` based on a ``wip.toml`` configuration file.
+The @wip tags
+=============
+
+The ``@wip`` tags are added by ``gherkinize.py`` based on the ``wip.toml`` configuration file.
 As features are added, update the ``wip.toml`` file and rebuild the ``.feature`` files, without touching the ``.textproto`` files.
 
 ::
 
     make clean-features all
 
-This will reset the tags in the ``.feature`` files.
+This will reset the tags in the ``.feature`` files to reflect the current mix
+of supported features.
+
+The goal is to eliminate all test cases from the ``wip.toml`` configuration file.

pyproject.toml

@@ -116,7 +116,7 @@ commands = [
 
 [tool.tox.env.tools]
 description = "conformance suite conversion tools"
-commands = [["pytest", "-v", "tools"]]
+commands = [["pytest", "-vv", "tools", "--cov=tools", "--cov-report=term-missing"]]
 
 [tool.tox.env.wip]
 description = "work-in-progress test suite"

tests/test_evaluation.py

@@ -191,6 +191,7 @@ def test_operator_in():
     assert operator_in(eval_error, container_1) == eval_error
     assert operator_in(celtypes.IntType(42), eval_error) == eval_error
 
+
 @pytest.mark.skipif(
     "re2" not in celpy.evaluation.function_matches.__globals__, reason="Not using RE2"
 )