add atexit use case (#30)

iritkatriel · web-flow · commit 9febf48f26c4 · 2021-02-18T23:18:31.000Z
diff --git a/except_star.md b/except_star.md
@@ -43,11 +43,16 @@ unwinds. Several real world use cases are listed below.
   issue how to aggregate these errors, particularly when they are different
   [[Python issue 29980](https://bugs.python.org/issue29980)].
 
-* **Multiple user callbacks fail.** The pytest library allows users to register
-  finalizers which are executed at teardown. If more than one of these
-  finalizers raises an exception, only the first is reported to the user. This
-  can be improved with `ExceptionGroup`s, as explained in this issue by pytest
-  developer Ran Benita [[Pytest issue 8217](https://github.com/pytest-dev/pytest/issues/8217)]
+* **Multiple user callbacks fail.** Python's `atexit.register()` allows users
+  to register functions that are called on system exit. If any of them raise
+  exceptions, only the last one is reraised, but it would be better to reraised
+  all of them together
+  [[`atexit` documentation](https://docs.python.org/3/library/atexit.html#atexit.register)].
+  Similarly, the pytest library allows users to register finalizers which
+  are executed at teardown. If more than one of these finalizers raises an
+  exception, only the first is reported to the user. This can be improved with
+  `ExceptionGroup`s, as explained in this issue by pytest developer Ran Benita
+  [[Pytest issue 8217](https://github.com/pytest-dev/pytest/issues/8217)]
 
 * **Multiple errors in a complex calculation.** The Hypothesis library performs
   automatic bug reduction (simplifying code that demonstrates a bug). In the
@@ -1051,6 +1056,10 @@ specified in the same place where we state `T`.
 
   https://bugs.python.org/issue40857
 
+* `atexit` documentation:
+
+  https://docs.python.org/3/library/atexit.html#atexit.register
+
 * PyTest issue 8217: Improve reporting when multiple teardowns raise an exception
 
   https://github.com/pytest-dev/pytest/issues/8217
