Merge branch 'main' into 673-add-sphinx-autobuild

.github/workflows/tests.yml

@@ -48,7 +48,7 @@ jobs:
     - name: Test
       run: tox -e ${{ matrix.config[1] }}
     - name: Upload coverage data to coveralls.io
-      run: coveralls --service=github-actions
+      run: coveralls --service=github || which coveralls
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         COVERALLS_REPO_TOKEN: ${{ secrets.CODECOV_TOKEN }}
@@ -60,13 +60,16 @@ jobs:
     # see https://coveralls-python.readthedocs.io/en/latest/usage/configuration.html#github-actions-support
     name: Submit test coverage
     needs: run-tests
+    # always finalize coverage aftest tests ran
+    # see https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#example-not-requiring-successful-dependent-jobs
+    if: ${{ always() }}
     runs-on: ubuntu-latest
     container: python:3-slim
     steps:
     - name: Install dependencies
       run: pip3 install --upgrade coveralls
     - name: Upload coverage
-      run: coveralls --service=github-actions --finish
+      run: coveralls --service=github --finish || which coveralls
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         COVERALLS_REPO_TOKEN: ${{ secrets.CODECOV_TOKEN }}

CHANGES.rst

@@ -8,8 +8,10 @@ Minor changes:
 
 - Test that all code works with both ``pytz`` and ``zoneinfo``.
 - Make coverage report submission optional for pull requests
+- Parallelize coverage
 - Rename ``master`` branch to ``main``, see `Issue
   <https://github.com/collective/icalendar/issues/627>`_
+- Update ``docs/usage.rst`` to use zoneinfo instead of pytz.  
 - Added missing public classes and functions to API documentation.
 - Improved namespace management in the ``icalendar`` directory.
 - Add Python version badge and badge for test coverage

docs/usage.rst

@@ -231,10 +231,10 @@ Property parameters are automatically added, depending on the input value. For
 example, for date/time related properties, the value type and timezone
 identifier (if applicable) are automatically added here::
 
-    >>> import pytz
+    >>> import zoneinfo
     >>> event = Event()
     >>> event.add('dtstart', datetime(2010, 10, 10, 10, 0, 0,
-    ...                               tzinfo=pytz.timezone("Europe/Vienna")))
+    ...                               tzinfo=zoneinfo.ZoneInfo("Europe/Vienna")))
 
     >>> lines = event.to_ical().splitlines()
     >>> assert (
@@ -262,7 +262,7 @@ Init the calendar::
 
   >>> cal = Calendar()
   >>> from datetime import datetime
-  >>> import pytz
+  >>> import zoneinfo
 
 Some properties are required to be compliant::
 
@@ -273,9 +273,9 @@ We need at least one subcomponent for a calendar to be compliant::
 
   >>> event = Event()
   >>> event.add('summary', 'Python meeting about calendaring')
-  >>> event.add('dtstart', datetime(2005,4,4,8,0,0,tzinfo=pytz.utc))
-  >>> event.add('dtend', datetime(2005,4,4,10,0,0,tzinfo=pytz.utc))
-  >>> event.add('dtstamp', datetime(2005,4,4,0,10,0,tzinfo=pytz.utc))
+  >>> event.add('dtstart', datetime(2005,4,4,8,0,0,tzinfo=zoneinfo.ZoneInfo("UTC")))
+  >>> event.add('dtend', datetime(2005,4,4,10,0,0,tzinfo=zoneinfo.ZoneInfo("UTC")))
+  >>> event.add('dtstamp', datetime(2005,4,4,0,10,0,tzinfo=zoneinfo.ZoneInfo("UTC")))
 
 A property with parameters. Notice that they are an attribute on the value::