Implement .shutdown() for both sync and async APIs (#720)

.github/workflows/ci.yml

@@ -34,6 +34,8 @@ jobs:
       uses: actions/checkout@v4
     - name: Setup Python
       uses: actions/setup-python@v5
+      with:
+        python-version: 3.13
     - name: Cache PyPI
       uses: actions/cache@v4
       with:
@@ -157,6 +159,8 @@ jobs:
       uses: actions/checkout@v4
     - name: Setup Python
       uses: actions/setup-python@v5
+      with:
+        python-version: 3.13
     - name: Install dependencies
       uses: py-actions/[email protected]
       with:

CHANGES.rst

@@ -13,6 +13,20 @@ Changes
 
 .. towncrier release notes start
 
+2.0.0 (2024-12-XX)
+------------------
+
+- Implement ``.shutdown(immediate=False)`` for both sync and async APIs #720
+
+  The change is not fully backward compatible:
+
+  1. If the queue is closed, ``janus.AsyncQueueShutDown`` and
+     ``janus.SyncQueueShutDown`` exceptions are raised instead of ``RuntimeError``.
+
+  2. Both sync and async ``.task_done()`` and ``.join()`` don't raise any exception
+     on queue shutdown/closing anymore; it is compatible with shutdown behavior
+     of stdlib sync and async queues.
+
 
 1.2.0 (2024-12-12)
 ------------------

Makefile

@@ -16,7 +16,7 @@ fmt:
 
 cov: flake develop
 	pytest --cov=janus --cov=tests --cov-report=term --cov-report=html
-	@echo "open file://`pwd`/htmlcov/index.html"
+	@echo "open file://`pwd`/coverage/index.html"
 
 checkrst:
 	python setup.py check --restructuredtext