Add pytask_collect_task_teardown. (#27)

Author: tobiasraabe

docs/changes.rst

@@ -10,6 +10,8 @@ all releases are available on `Anaconda.org <https://anaconda.org/pytask/pytask>
 ------------------
 
 - :gh:`25` allows to customize the names of the task files.
+- :gh:`27` implements the ``pytask_collect_task_teardown`` hook specification to perform
+  checks after a task is collected.
 
 
 0.0.6 - 2020-09-12

docs/reference_guides/hookspecs.rst

@@ -75,6 +75,9 @@ Collection
 .. autofunction:: pytask_collect_task
    :noindex:
 
+.. autofunction:: pytask_collect_task_teardown
+   :noindex:
+
 .. autofunction:: pytask_collect_node
    :noindex:
 
@@ -96,7 +99,6 @@ duplicates are collected with :func:`pytask_collect_task`.
    :noindex:
 
 
-
 Execution
 ---------
 

src/_pytask/collect.py

@@ -128,6 +128,7 @@ def pytask_collect_task_protocol(session, reports, path, name, obj):
         task = session.hook.pytask_collect_task(
             session=session, path=path, name=name, obj=obj
         )
+        session.hook.pytask_collect_task_teardown(session=session, task=task)
         if task is not None:
             return CollectionReportTask.from_task(task)
 

src/_pytask/hookspecs.py

@@ -151,6 +151,15 @@ def pytask_collect_task(session, path, name, obj):
     """Collect a single task."""
 
 
+@hookspec
+def pytask_collect_task_teardown(task):
+    """Perform tear-down operations when a task was collected.
+
+    Use this hook specification to, for example, perform checks on the collected task.
+
+    """
+
+
 @hookspec(firstresult=True)
 def pytask_collect_node(path, node):
     """Collect a node which is a dependency or a product of a task."""