Bump apscheduler from 3.8.0 to 3.9.1 (#1675)

* Bump apscheduler from 3.8.0 to 3.9.1

Bumps [apscheduler](https://github.com/agronholm/apscheduler) from 3.8.0 to 3.9.1.
- [Release notes](https://github.com/agronholm/apscheduler/releases)
- [Changelog](https://github.com/agronholm/apscheduler/blob/3.9.1/docs/versionhistory.rst)
- [Commits](https://github.com/agronholm/apscheduler/compare/3.8.0...3.9.1)

---
updated-dependencies:
- dependency-name: apscheduler
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

* Update apscheduler==3.9.1

* Update pytz==2022.1

* Add pytz-deprecation-shim==0.1.0.post0

* Update tzdata==2022.1

* Update tzlocal==4.2

* Update requirements.txt

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

[skip ci]

lib/tzlocal/utils.py

@@ -1,7 +1,24 @@
 # -*- coding: utf-8 -*-
+import os
 import time
 import datetime
 import calendar
+import pytz_deprecation_shim as pds
+
+try:
+    import zoneinfo  # pragma: no cover
+except ImportError:
+    from backports import zoneinfo  # pragma: no cover
+
+from tzlocal import windows_tz
+
+
+class ZoneInfoNotFoundError(pds.UnknownTimeZoneError, zoneinfo.ZoneInfoNotFoundError):
+    """An exception derived from both pytz and zoneinfo
+
+    This exception will be trappable both by pytz expecting clients and
+    zoneinfo expecting clients.
+    """
 
 
 def get_system_offset():
@@ -21,9 +38,9 @@ def get_system_offset():
     # so we check that the difference is less than one minute, because nobody
     # has that small DST differences.
     if abs(offset - time.altzone) < 60:
-        return -time.altzone
+        return -time.altzone  # pragma: no cover
     else:
-        return -time.timezone
+        return -time.timezone  # pragma: no cover
 
 
 def get_tz_offset(tz):
@@ -39,8 +56,73 @@ def assert_tz_offset(tz):
     tz_offset = get_tz_offset(tz)
     system_offset = get_system_offset()
     if tz_offset != system_offset:
-        msg = ('Timezone offset does not match system offset: {0} != {1}. '
-               'Please, check your config files.').format(
-                   tz_offset, system_offset
-               )
+        msg = (
+            "Timezone offset does not match system offset: {} != {}. "
+            "Please, check your config files."
+        ).format(tz_offset, system_offset)
         raise ValueError(msg)
+
+
+def _tz_name_from_env(tzenv=None):
+    if tzenv is None:
+        tzenv = os.environ.get("TZ")
+
+    if not tzenv:
+        return None
+
+    if tzenv[0] == ":":
+        tzenv = tzenv[1:]
+
+    if tzenv in windows_tz.tz_win:
+        # Yup, it's a timezone
+        return tzenv
+
+    if os.path.isabs(tzenv) and os.path.exists(tzenv):
+        # It's a file specification, expand it, if possible
+        parts = os.path.realpath(tzenv).split(os.sep)
+
+        # Is it a zone info zone?
+        possible_tz = "/".join(parts[-2:])
+        if possible_tz in windows_tz.tz_win:
+            # Yup, it is
+            return possible_tz
+
+        # Maybe it's a short one, like UTC?
+        if parts[-1] in windows_tz.tz_win:
+            # Indeed
+            return parts[-1]
+
+
+def _tz_from_env(tzenv=None):
+    if tzenv is None:
+        tzenv = os.environ.get("TZ")
+
+    if not tzenv:
+        return None
+
+    # Some weird format that exists:
+    if tzenv[0] == ":":
+        tzenv = tzenv[1:]
+
+    # TZ specifies a file
+    if os.path.isabs(tzenv) and os.path.exists(tzenv):
+        # Try to see if we can figure out the name
+        tzname = _tz_name_from_env(tzenv)
+        if not tzname:
+            # Nope, not a standard timezone name, just take the filename
+            tzname = tzenv.split(os.sep)[-1]
+        with open(tzenv, "rb") as tzfile:
+            zone = zoneinfo.ZoneInfo.from_file(tzfile, key=tzname)
+            return pds.wrap_zone(zone)
+
+    # TZ must specify a zoneinfo zone.
+    try:
+        tz = pds.timezone(tzenv)
+        # That worked, so we return this:
+        return tz
+    except pds.UnknownTimeZoneError:
+        # Nope, it's something like "PST4DST" etc, we can't handle that.
+        raise ZoneInfoNotFoundError(
+            "tzlocal() does not support non-zoneinfo timezones like %s. \n"
+            "Please use a timezone in the form of Continent/City"
+        ) from None